Adspy Detail API

API Information

• API Name: Get Adspy Detail
• Request Method: POST
• API Endpoint: /open-api/v1/data
• Interface URI: /v3/api/open/adspy/detail
• Description: Retrieves detailed Adspy information by ad ID
• Pricing: The base cost is 1 credit per request. A request is free if either condition applies: the same ID was retrieved within the previous 3 days, or the ID appeared in your ranking-list query results within the previous 3 days.

Request Headers:

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

Request Parameters

Request Structure

Parameter List (params Object)

Request Example

curl -X POST "https://www.pipispy.com/open-api/v1/data" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "key": "your_api_key_here",
    "uri": "/v3/api/open/adspy/detail",
    "params": {
      "id": "1795208137186337"
    }
  }'

Response Parameters

Response Body Structure

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

Response Fields

Adspy Detail Fields

Field usage notes:

• All time fields are Unix timestamps in seconds, such as 1752199828. Convert them to the consumer's display time zone as needed.
• Play, like, comment, share, and favorite metrics are cumulative values from the latest collection and may not match the media platform in real time.
• URLs may become unavailable because the source ad was removed, regional restrictions apply, or the media platform requires authentication. Consumers should handle access failures.
• Fields that do not apply to the current platform or creative type may be null, an empty string, an empty array, or omitted. Do not use field presence to determine request success.
• Union types such as Number/String and Array/String support legacy data. Deserializers should accept all documented types.

Field Enumerations

data_type may contain multiple categories. For example, "[2,3,4]" means the ad has TikTok Shop, e-commerce, and brand/Spark Ads attributes.

AI Analysis Fields (ai_analysis Object)

Audience Fields (audience Object)

Facebook Audience Summary Fields (audience.max_data Object)

Content List Fields (content_list Array Items)

TikTok Shop Fields (tiktok_shop Array Items)

Associated Object Fields (ad_advertiser, ad_store, ad_shop, and ad_developer Objects)

Facebook Reaction Fields (facebook_like_info Array Items)

Carousel Creative Fields (carousel Array Items)

App Developer Fields (app_dev Object)

App Information Fields (app_info Object)

App Rating Fields (app_info.rate Object)

App Category Fields (app_info.category Object)

App Revenue Fields (app_info.revenue Object)

Response Example

{
  "comment_count": 1,
  "forward_count": 0,
  "pack_url": "",
  "source": [
    "Android"
  ],
  "type": 1,
  "resolution": "540x960",
  "ai_analysis": {
    "ai_analysis_language": "zh-cn",
    "ai_analysis_human_presenter": "yes",
    "ai_analysis_main_hook": "What are you secretly filming?",
    "ai_analysis_script": "What are you secretly filming? Thailand's DTV visa can be processed without leaving the country. Approval in as fast as 7 days, starting from just 9,000 yuan. Valid for 5 years, unlimited entries and exits to Thailand, stay up to 180 days per visit. Refunds available upon application. Click the link below to apply now.",
    "ai_analysis_tags": [
      "#DTVVisa",
      "#Thailand",
      "#NoNeedToLeave",
      "#Apply",
      "#ApprovalIn7Days",
      "#From9000Yuan",
      "#5YearValidity",
      "#UnlimitedEntries",
      "#180Days",
      "#RefundAvailable",
      "#LinkBelow",
      "#ApplyNow",
      "#Visa"
    ]
  },
  "cover": "https://cdn-video.pipispy.com/cover_6f730728bdc01d3cdce00223de09fc4f.jpg",
  "max_cpm": 2.4,
  "last_put_time": 1752199828,
  "root_path_id": "682e25abe87d0e8f5818189b",
  "put_days": 2,
  "image": "",
  "audience": {
    "gender": [],
    "covered": 909,
    "source": [
      "Android"
    ],
    "region": [
      "TH"
    ],
    "category": [],
    "age": [
      "35-45"
    ]
  },
  "play_count": 909,
  "ad_create_time": 1751942170,
  "ad_id": "1837044055239874",
  "root_path": "ccddsite88.net",
  "digg_count": 3,
  "content_list": [
    {
      "cta": "Learn More",
      "landing_page": "https://ccddsite88.net/landing-page/thailand/tk/1747707570548/?ttclid=E_C_P_CssBEU5QXACDVfMYNCqcBdOW23Ndidd7knaaqh33vgz0N3--FsUbYw0wC8RfDBrdG6Q0HLWvHnPjwINxzZrvXXozfcERzmjOAnAaD-B-tVEeQ1fnAfs3uWEPeRU9_45T4jl7QSzD1Zi-zQLz4IwgsHo2ssq9veFvzuXZnpw0b6lZcNRonZMSZBRxG-cjyUsRIvMKn-qkMV3Q1kCD2niYVect6n7ZTSrHK8f894b_6_5V7_sD2zGP2hudN80m55zW5hBOeM9tzNMJXreMoIoSBHYyLjA",
      "title": "Starting today, meet these 2 conditions for Thailand DTV, approval in as fast as 7 days, refundable!",
      "desc": "Starting today, meet these 2 conditions for Thailand DTV, approval in as fast as 7 days, refundable!",
      "url_history": []
    }
  ],
  "is_download": false,
  "publisher_platform": [
    "tiktok"
  ],
  "aspect_ratio": "540x960",
  "digg_play_rate": 0.0033,
  "modify_time": 1752199828,
  "min_cpa": 0.0,
  "is_collection": false,
  "platform": 1,
  "duration": 17,
  "update_time": 1752199828,
  "video_url": "https://cdn-video.pipispy.com/video_1cd71dc2169dd279821b1ba4736d4e19.mp4",
  "tiktok_author_url": "https://www.tiktok.com/@ThailandDTV",
  "ad_fee": 0,
  "min_cpm": 0.6,
  "app_url": "https://ccddsite88.net/landing-page/thailand/tk/1747707570548/?ttclid=E_C_P_CssBEU5QXACDVfMYNCqcBdOW23Ndidd7knaaqh33vgz0N3--FsUbYw0wC8RfDBrdG6Q0HLWvHnPjwINxzZrvXXozfcERzmjOAnAaD-B-tVEeQ1fnAfs3uWEPeRU9_45T4jl7QSzD1Zi-zQLz4IwgsHo2ssq9veFvzuXZnpw0b6lZcNRonZMSZBRxG-cjyUsRIvMKn-qkMV3Q1kCD2niYVect6n7ZTSrHK8f894b_6_5V7_sD2zGP2hudN80m55zW5hBOeM9tzNMJXreMoIoSBHYyLjA",
  "fetch_region": "",
  "max_cpa": 1.0,
  "url": "https://m.tiktok.com/v/7524534322666228999.html",
  "collect_count": 1,
  "download_count": 0,
  "share_count": 0,
  "tiktok_author": "ThailandDTV",
  "app_name": "ThailandDTV",
  "active_status": 1,
  "hot_value": 4,
  "data_type": "[4]",
  "url_history": [],
  "video_id": "496b74d6a6135f80c17d",
  "app_image": "https://cdn-video.pipispy.com/avatar_5eabd0708ef037d43a4377d740ae2c53.jpg"
}

Error Codes