Adspy 列表接口

接口信息

• 接口名称: 获取 Adspy 列表
• 请求方法: POST
• 接口地址: /open-api/v1/data
• 接口路径: /v3/api/open/adspy/list
• 接口描述: 根据过滤条件获取 Adspy 列表信息，支持分页
• 价格说明: 获取一条数据结果消耗1 credit

请求头:

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

请求参数

请求结构

参数列表 (params 对象)

必填参数

可选参数（按字母顺序）

关键词搜索格式说明

extend_keywords 和 exclude_keywords 参数使用 JSON 格式：

[
  {
    "type": 1,
    "keyword": "搜索关键词"
  }
]

搜索类型 (type) 说明:

• type:1 - 广告关键词搜索，用户输入的keyword 将会进行广告文案、广告主、落地页链接、产品、App、账号、素材匹配搜索
• type:2 - 广告文案，用户输入的keyword 只会进行广告文案匹配搜索
• type:3 - 广告主，用户输入的keyword将会对广告主进行搜索
• type:4 - 着陆页url，用户输入的keyword将会对落地页链接、重定向链接进行搜索
• type:5 - 电商产品，用户输入的keyword将会对电商产品名称进行搜索
• type:6 - TikTok Shop店铺，用户输入的keyword将会对TikTok Shop店铺名称进行搜索
• type:7 - APP名称，用户输入的keyword将会对App应用名称进行搜索
• type:8 - APP开发者，用户输入的keyword将会对APP开发者名称进行搜索
• type:9 - 社媒账号 (主页名称)，用户输入的keyword将会对社媒账号 (TT账号/Page ID)进行搜索
• type:10 - 素材 (脚本/钩子/标签)，用户输入的keyword素材信息 (脚本/钩子/标签)进行搜索
• type:11 - 电商店铺/URL，用户输入的keyword将会对电商店铺/URL进行搜索
• type:12 - TikTok Shop产品，用户输入的keyword将会对TikTok Shop产品进行搜索

请求示例

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/list",
        "params": {
          "is_participle": false,
          "shop_type": [
            "magento",
            "shopify"
          ],
          "extend_keywords": [
            {
                "type": 1,
                "keyword": "shorts"
            },
            {
                "type": 2,
                "keyword": "black"
            }
          ],
          "plat_type": 1,
          "search_type": 1,
          "sort": 2,
          "sort_type": "desc",
          "current_page": 1,
          "play_count_min": 1000,
          "play_count_max": 10000,
          "create_time_start": 1761580800,
          "create_time_end": 1764172799,
          "page_size": 20
        }
  }'

响应参数

响应体结构

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      // 广告数据列表
    ],
    "page": {
      // 分页信息
    }
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 20,
  "success": true,
  "fail": false
}

响应字段说明

主要响应字段

广告数据字段 (data) - 按字母顺序

轮播图字段 (carousel) - 按字母顺序

分页信息字段 (page)

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      {
        "search_by_image_tag": true,
        "comment_count": 2,
        "app_dev_id": "",
        "digg_play_rate": 0.0067,
        "modify_time": 1752204344,
        "pack_url": "",
        "type": 1,
        "is_collection": false,
        "platform": 1,
        "duration": 59,
        "cover": "https://cdn-video.pipispy.com/cover_7f33700d982493b5a19b158a7068af93.jpg",
        "share_play_rate": 0.0007,
        "last_put_time": 1752204344,
        "root_path_id": "61f57e4d9a301ef93d53b88a",
        "put_days": 12,
        "app_title": "我不信！你的头发有比我油!! #amaxy #fyp",
        "fetch_region": ["MY"],
        "ad_create_time": 1745303145,
        "play_count": 47527,
        "share_count": 32,
        "app_name": "🇲🇾带货主播Regina & Fiona",
        "found_time": 1749614161,
        "ad_id": "1833892866239586",
        "hot_value": 352,
        "digg_count": 318,
        "is_download": false,
        "data_type": [3],
        "button_text": "Beli sekarang",
        "desc": "我不信！你的头发有比我油!! #amaxy #fyp",
        "video_id": "d9055376ae19819f4756",
        "app_image": "https://cdn-video.pipispy.com/avatar_0aa449789bac7929f216b33fde973196.jpg",
        "video_url": "https://cdn-video.pipispy.com/video_39551dc815f2501724d82a30c4a389c3.mp4",
        "ai_analysis_main_hook": "你们的头发有这么油吗？",
        "ai_analysis_script": "你们的头发有这么油吗？为了帮你们做测试啊，我牺牲几大，这个是油啊，哇啦喂，我又要做这个东西啊，啊，你们的头发有这么油吗？我跟你讲啊，我只会洗一次罢了，我看它的这个效果真的是可以帮我们去油没有？如果没有的话，不要买。OK，够了吗？你看它的泡沫还是蛮绵密，而且很香一下这种清香的味道啦，油头的话呢，你们就是买这个蓝色就可以了，它就帮你们去油了，再用一点它的这个conditioner，把它涂在发尾。有没有很顺滑？oh my god，我放了这么多油，我只洗一次罢了啊，你看它是干干净净，完全没有任何的油，也没有那种臭油味，而且是非常干爽，非常的蓬松，哇跟它讲的一样喔。所以如果你是油头的话，我非常建议你去买这个蓝色的amaxy，它是一个礼盒套装的，然后有两支shampoo，一支shampoo的话是400ml，然后这一个是conditioner，让你头发比较的顺滑，也是400ml。你买这个啊，百多块是吗？我再送给你两只各100ml的shampoo，还有12条shampoo，一条8ml，送你的将近是300ml，一只是正装400ml，我送你差不多要一罐了啊，going是吧，如果你也是油头一天不洗头也是非常油的话呢，你就点击视频的左下角链接去购买哟，真的有效，你会喜欢的。",
        "ai_analysis_tags": [
          "#shampoo",
          "#conditioner",
          "#haircare",
          "#oilyhair",
          "#amaxy",
          "#hairproduct",
          "#hair",
          "#beauty"
        ],
        "ai_analysis_language": "zh-cn",
        "ai_analysis_human_presenter": "yes",
        "had_ai_analysis": true,
        "min_cpm": 33.74,
        "min_cpa": 1.0,
        "unique_id": "hows.sis"
      }
    ],
    "page": {
      "total_count": 10000,
      "page_count": 500,
      "current_page": 1,
      "page_size": 20,
      "is_next": true
    }
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 20,
  "success": true,
  "fail": false
}

错误码说明