Adspy 详情接口

接口信息

• 接口名称: 获取 Adspy 详情
• 请求方法: POST
• 接口地址: /open-api/v1/data
• 接口路径: /v3/api/open/adspy/detail
• 接口描述: 根据广告 ID 获取 Adspy 详细信息
• 价格说明: 详情接口计费规则： 基础费用：1 credit/次。 免费访问条件（满足其一即可）： 该ID在3天内已获取过详情；该ID在3天内出现在您的榜单列表查询结果中。

请求头:

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

请求参数

请求结构

参数列表 (params 对象)

请求示例

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"
    }
  }'

响应参数

响应体结构

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

响应字段说明

Adspy 详情字段

字段使用说明：

• 所有时间字段均为 Unix 秒级时间戳，例如 1752199828；调用方应按自身时区转换展示。
• 播放、点赞、评论、分享、收藏等指标是最近一次采集到的累计值，不保证与媒体平台页面实时一致。
• URL 字段可能因源广告下线、地区限制或媒体平台鉴权而失效，调用方应做好访问失败处理。
• 非当前广告类型或平台适用的字段可能返回 null、空字符串、空数组，或不出现在响应中；不应以字段是否存在判断请求是否成功。
• Number/String、Array/String 等联合类型是为了兼容历史数据，建议调用方反序列化时允许对应的多种类型。

字段枚举说明

data_type 允许同时包含多个分类。例如字符串 "[2,3,4]" 表示该广告同时具有 TikTok Shop、电商和品牌/Spark Ads 属性。

AI 分析字段 (ai_analysis 对象)

受众信息字段 (audience 对象)

Facebook 受众摘要字段 (audience.max_data 对象)

内容列表字段 (content_list 数组对象)

TikTok 商店字段 (tiktok_shop 数组对象)

规范化关联对象字段 (ad_advertiser、ad_store、ad_shop、ad_developer 对象)

Facebook 互动字段 (facebook_like_info 数组对象)

轮播素材字段 (carousel 数组对象)

应用开发者字段 (app_dev 对象)

应用信息字段 (app_info 对象)

应用评分字段 (app_info.rate 对象)

应用分类字段 (app_info.category 对象)

应用收入字段 (app_info.revenue 对象)

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "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": "你在偷拍什么呀?",
      "ai_analysis_script": "你在偷拍什么呀?泰国DTV签证,不用出境也能办理。快至七天获批,9000元起就够,五年内有效期,无限次往返泰国,一次可待180天。不过可以申请退费,点击下方链接立即申请。",
      "ai_analysis_tags": [
        "#DTV签证",
        "#泰国",
        "#不用出境",
        "#办理",
        "#七天获批",
        "#9000元起",
        "#五年有效期",
        "#无限次往返",
        "#180天",
        "#申请退费",
        "#下方链接",
        "#立即申请",
        "#签证"
      ]
    },
    "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,
    "found_time": 1752067470,
    "ad_id": "1837044055239874",
    "root_path": "ccddsite88.net",
    "digg_count": 3,
    "content_list": [
      {
        "cta": "เรียนรู้เพิ่มเติม",
        "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": "即日起，泰国DTV满足这2个条件即可，快至7天，不过可退！",
        "desc": "即日起，泰国DTV满足这2个条件即可，快至7天，不过可退！",
        "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/@泰国DTV",
    "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": "泰国DTV",
    "app_name": "泰国DTV",
    "active_status": 1,
    "hot_value": 4,
    "data_type": "[4]",
    "url_history": [],
    "video_id": "496b74d6a6135f80c17d",
    "app_image": "https://cdn-video.pipispy.com/avatar_5eabd0708ef037d43a4377d740ae2c53.jpg"
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 1,
  "success": true,
  "fail": false
}

错误码说明