Monitor Task Ad Details

API Information

• API Name: Monitor Task Ad Details
• Request Method: POST
• API URL: open-api/v1/monitor/data
• Endpoint Path: /v3/api/ad-monitor-task/ad-details
• Description:
  • Get monitor ad details
  • Usage Note: Free

Request Headers:

• Content-Type: application/json
• Accept: application/json

Request Parameters

Request Structure

Request Body Parameters (params object)

Request Example

curl -X POST "https://www.pipispy.com/open-api/v1/monitor/data" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "key": "your_api_key_here",
    "uri": "/v3/api/ad-monitor-task/ad-details",
    "params": {
      "ad_id": "1160096586185797"
    }
  }'

Response Parameters

Response Structure

{
  "code": 200,
  "message": "success",
  "data": {},
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "success": true,
  "fail": false
}

Main Response Fields

Ad History Fields (ads_history)

History Timeline Fields (timeline)

Ad Details Fields (advertisement)

AI Analysis Object Fields (ai_analysis)

Advertiser Information Object Fields (advertiser)

Product Information Object Fields (products)

Store Information Object Fields (store)

Store Category Object Fields (categories)

Video Information Object Fields (videos)

Image Information Object Fields (images)

Carousel Media Information Object Fields (cards)

Response Example

{
  "code": 200,
  "message": "success",
  "data": {
    "ads_history": {
      "ad_cost": {
        "timeline": [
          {
            "date": "2025-10-23",
            "count": 0.7
          }
        ]
      },
      "adset_count": {
        "timeline": [
          {
            "date": "2025-10-23",
            "count": 5
          }
        ]
      },
      "ad_active_day": {
        "timeline": [
          {
            "date": "2025-10-23",
            "count": 1
          }
        ]
      }
    },
    "advertisement": {
      "country": [
        "NL"
      ],
      "cards": null,
      "ad_caption": "www.coolblue.nl",
      "ad_audience": null,
      "button_type": "ORDER_NOW",
      "language": null,
      "videos": [
        {
          "duration": 15,
          "cover_url": "https://cdn.pipidata.com/images/b29269c786c7f9338b95649e19787a86.png",
          "width": 720,
          "url": "https://cdn.pipidata.com/videos/f3ba152d8c133802075a79fe0b64d8c4.mp4",
          "height": 900
        }
      ],
      "ad_content": "Op zoek naar een snelle printer? Gevonden.",
      "last_discovered_at": 1761203655,
      "ad_title": "Nu besteld in de app, morgen in huis.",
      "ad_cost_min": 0.6,
      "products": null,
      "ad_ended_at": 1761202800,
      "ad_link": "https://www.facebook.com/ads/library/?id=1160096586185797",
      "ad_forecast": 1,
      "id": "1160096586185797",
      "latest_actived_at": 1761202800,
      "ad_link_description": null,
      "landing_page_type": 3,
      "source_ad_id": null,
      "advertiser": {
        "like_count": 463298,
        "profile_picture_url": "https://cdn.pipidata.com/images/b467aa4e0f396674a14f1ffaa99a1d76.png",
        "ad_count": 18788,
        "source_advertiser_id": "422603325536",
        "name": "Coolblue",
        "source_advertiser_link": null,
        "id": "422603325536",
        "ad_country": [
          "NL",
          "BE",
          "HU",
          "DE",
          "ES",
          "AT",
          "IE",
          "LT",
          "RO",
          "SI",
          "GR"
        ],
        "ads_library_link": "https://www.facebook.com/ads/library/?active_status=active&ad_type=all&country=ALL&is_targeted_country=false&media_type=all&search_type=page&view_all_page_id=422603325536",
        "adset_count": null,
        "e_commerce_platform": null
      },
      "images": null,
      "ad_cost": 0.7,
      "first_discovered_at": 1761203655,
      "estimated_conversion_max": 1,
      "landing_pages": [
        "https://www.coolblue.nl/printers/hp/hp-laserjet"
      ],
      "ad_audience_reach": 38,
      "store": null,
      "adset_count": 5,
      "ad_status": 1,
      "media_format": 1,
      "ad_platform": [
        "FACEBOOK",
        "INSTAGRAM"
      ],
      "estimated_conversion_min": 1,
      "impression": 70,
      "button_text": "Order now",
      "ad_started_at": 1761202800,
      "active_days": 1,
      "ad_cost_max": 0.9
    }
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 0,
  "success": true,
  "fail": false
}

Error Codes

Notes

1. The ad ID must be a valid system internal ID
2. URLs in the response are converted to CDN addresses
3. All timestamps are Unix timestamps (seconds)
4. AI analysis fields are only returned for video ads
5. Some fields may be empty depending on ad type and data completeness