Monitor Task Ad Details
- 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
| Parameter |
Type |
Description |
Example |
Required |
Default |
| key |
string |
User's external API request key |
"your_api_key_here" |
Yes |
|
| uri |
string |
Endpoint path |
"/v3/api/ad-monitor-task/ad-details" |
Yes |
|
| params |
object |
Request parameters object |
See parameter list |
Yes |
|
Request Body Parameters (params object)
| Parameter |
Type |
Required |
Description |
| ad_id |
string |
true |
Ad ID |
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
| Field Name |
Type |
Description |
| ads_history |
object |
Ad history change data |
| advertisement |
object |
Ad detailed information |
| version |
string |
API version number |
| timestamp |
long |
Response timestamp |
| sign |
string |
Response signature |
| remaining_credits |
number |
Current remaining available credits after this request |
| consumed_credits |
number |
Credits consumed by this request |
| success |
boolean |
Request success status |
| fail |
boolean |
Request failure status |
Ad History Fields (ads_history)
| Field Name |
Type |
Description |
| ad_cost |
object |
Ad spend history data |
| adset_count |
object |
Ad set count history data |
History Timeline Fields (timeline)
| Field Name |
Type |
Description |
| count |
double |
Value |
| date |
string |
Date (YYYY-MM-DD format) |
Ad Details Fields (advertisement)
| Field Name |
Type |
Description |
| id |
string |
Ad ID, system internal unique identifier |
| active_days |
long |
Ad running days |
| ad_audience |
object |
Ad audience information |
| ad_audience_reach |
long |
Ad reach count |
| ad_caption |
string |
Ad caption |
| ad_content |
string |
Ad copy content |
| ad_cost |
double |
Ad spend amount |
| ad_forecast |
long |
Ad forecast status (1:Testing 2:Scaling 3:Winning) |
| ad_link |
string |
Ad link |
| ad_link_description |
string |
Ad link description |
| ad_platform |
array |
Ad delivery platform list |
| ad_started_at |
long |
Ad creation time |
| ad_status |
long |
Ad status (1:Active 2:Inactive 3:Removed) |
| ad_title |
string |
Ad title |
| adset_count |
long |
Number of ad sets |
| advertiser |
object |
Advertiser information |
| button_text |
string |
Button text |
| button_type |
string |
Button type |
| cards |
array |
Carousel media list |
| country |
array |
Delivery countries list |
| first_discovered_at |
long |
Ad first discovered time |
| images |
array |
Ad images list |
| landing_page_type |
long |
Landing page type |
| landing_pages |
array |
Landing page URLs list |
| language |
string |
Ad language |
| last_discovered_at |
long |
Ad last update time |
| latest_actived_at |
long |
Ad last active time |
| media_format |
long |
Media format type |
| products |
array |
Ad products list |
| source_ad_id |
string |
Source ad ID |
| store |
object |
Ad store information |
| user_collected |
long |
User collection status (1:Collected 2:Not collected) |
| videos |
array |
Ad videos list |
| size |
string |
Size information |
| clarity |
string |
Clarity information |
| aspect_ratio |
string |
Aspect ratio information |
| ai_analysis |
object |
AI analysis results |
AI Analysis Object Fields (ai_analysis)
| Field Name |
Type |
Description |
| ai_analysis_human_presenter |
string |
Whether human presenter |
| ai_analysis_language |
string |
Video language |
| ai_analysis_main_hook |
string |
Main hook content |
| ai_analysis_script |
string |
Video script |
| ai_analysis_tags |
array |
Video tags list |
| Field Name |
Type |
Description |
| id |
string |
Advertiser ID |
| name |
string |
Advertiser name |
| ad_count |
long |
Advertiser ad count |
| ad_country |
array |
Advertiser delivery countries |
| ads_library_link |
string |
Ads library link |
| adset_count |
long |
Ad set count |
| e_commerce_platform |
string |
E-commerce platform |
| like_count |
long |
Like count |
| profile_picture_url |
string |
Profile picture URL |
| source_advertiser_id |
string |
Source advertiser ID |
| source_advertiser_link |
string |
Source advertiser link |
| user_blocked |
long |
User blocked status (1:Yes 2:No) |
| Field Name |
Type |
Description |
| id |
string |
Product ID |
| name |
string |
Product name |
| ad_count |
long |
Product ad count |
| category_id |
string |
Category ID |
| category_name |
string |
Category name |
| creation_time |
long |
Creation time |
| currency |
string |
Currency type |
| image_url |
string |
Product image URL |
| price |
double |
Product price |
| price_usd |
double |
Product USD price |
| source_product_link |
string |
Source product link |
| Field Name |
Type |
Description |
| id |
string |
Store ID |
| name |
string |
Store name |
| ad_count |
long |
Store ad count |
| categories |
array |
Store categories list |
| e_commerce_platform |
string |
E-commerce platform |
| e_commerce_types |
array |
E-commerce types list |
| logo_url |
string |
Store logo URL |
| source_store_link |
string |
Source store link |
Store Category Object Fields (categories)
| Field Name |
Type |
Description |
| id |
string |
Category ID |
| name_en |
string |
Category English name |
| name_zh |
string |
Category Chinese name |
| Field Name |
Type |
Description |
| url |
string |
Video URL |
| cover_url |
string |
Cover URL |
| duration |
long |
Video duration (seconds) |
| width |
long |
Video width |
| height |
long |
Video height |
| Field Name |
Type |
Description |
| url |
string |
Image URL |
| width |
long |
Image width |
| height |
long |
Image height |
| Field Name |
Type |
Description |
| url |
string |
Media URL |
| cover_url |
string |
Cover URL |
| duration |
long |
Duration (for video) |
| width |
long |
Width |
| height |
long |
Height |
| media_type |
long |
Media type (1:Video 2:Image) |
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
| Error Code |
Description |
| 200 |
Success |
| 400 |
Invalid request parameters |
| 500 |
Internal server error |
Notes
- The ad ID must be a valid system internal ID
- URLs in the response are converted to CDN addresses
- All timestamps are Unix timestamps (seconds)
- AI analysis fields are only returned for video ads
- Some fields may be empty depending on ad type and data completeness