以图搜广告接口

调用整体流程

1. 提交图片 （/v3/api/open/ai-search/image/submit或/v3/api/open/ai-search/image/submit/image-url）
   ↓
2. 等待10-20秒
   ↓
3. 查询处理状态（/v3/api/open/ai-search/image/status）
   ↓
4. 获取结果摘要（/v3/api/open/ai-search/image/resultSummary）
   ↓
5. 根据摘要数据，选择性调用详细列表接口：
    - 产品列表：/v3/api/open/ai-search/image/product/search
    - 广告列表：/v3/api/open/ai-search/image/search4/ad/search （本接口）
    - 店铺列表：/v3/api/open/ai-search/image/root-path/search
    - TikTok产品：/v3/api/open/ai-search/image/tiktok-product/search
    - TikTok店铺：/v3/api/open/ai-search/image/tiktok-shop/search

接口概述

以图搜广告接口用于根据图片搜索相似的广告内容。需要先通过图片提交接口获取 image_id，然后使用该接口查询与图片相似的广告列表。

该接口支持丰富的过滤条件，包括平台类型、数据类型、地区、关键词、互动数据范围、时间范围等多维度筛选，帮助用户精准定位目标广告。

接口信息

• 接口名称: 以图搜广告
• 请求方法: POST
• 接口地址: /open-api/v1/data
• 接口路径: /v3/api/open/ai-search/image/search4/ad/search
• 接口描述: 根据图片ID查询相似广告，支持多维度过滤和排序
• 价格说明: 获取一条数据结果消耗1 credit

请求头:

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

请求参数

请求结构

请求体参数 (params 对象)

必填参数

可选参数 - 平台与数据类型

可选参数 - 地区与语言

可选参数 - 关键词搜索

ExtendKeyWordsVo 结构：

ExcludeWordVo 结构：

可选参数 - 店铺与产品

可选参数 - APP相关

可选参数 - 互动数据范围

可选参数 - Facebook互动数据

可选参数 - 时间范围

可选参数 - 广告属性

可选参数 - 广告成本与转化

可选参数 - APP数据

可选参数 - AI分析与分类

可选参数 - 其他

请求示例

基础请求示例

使用 cURL

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/ai-search/image/search4/ad/search",
    "params": {
        "image_id": "img_1737532800123456",
        "current_page": 1,
        "page_size": 20
    }
  }'

高级过滤示例

使用关键词和地区过滤

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/ai-search/image/search4/ad/search",
    "params": {
        "image_id": "img_1737532800123456",
        "current_page": 1,
        "page_size": 20,
        "plat_type": 1,
        "region": ["US", "GB"],
        "extend_keywords": [
            {
                "keyword": "fashion",
                "type": 2
            }
        ],
        "play_count_min": 10000,
        "sort": 3,
        "sort_type": "desc"
    }
  }'

响应参数

响应体结构

{
  "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": "I don't believe it! Your hair is oilier than mine!! #amaxy #fyp",
        "fetch_region": ["MY"],
        "ad_create_time": 1745303145,
        "play_count": 47527,
        "share_count": 32,
        "app_name": "🇲🇾 Livestream hosts 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": "I don't believe it! Your hair is oilier than mine!! #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": "Is your hair this oily?",
        "ai_analysis_script": "Is your hair this oily? I’m doing this test for you guys—I made such a big sacrifice! Look at all this oil—wow! Ugh, I have to do this again?! Seriously, is your hair this oily? Let me tell you—I only washed it once! I wanted to see if this product really works to remove oil. If it doesn’t, don’t buy it—okay? Is that enough? Look at the lather—it’s actually quite rich and creamy, and it smells amazing! A fresh, clean fragrance! If you have oily hair, just get the blue one—it’s specially designed to control oil. Then, use a bit of their conditioner, applying it only to the ends of your hair. Feel how smooth it is? Oh my god! I put on so much oil, and I only washed it once—look! It’s completely clean, with zero greasiness or that nasty rancid-oil smell. My hair feels super dry, fresh, and incredibly voluminous—exactly as they claimed! So if you have oily hair, I highly recommend you get this blue Amaxy set. It comes as a gift box containing two shampoos (each 400ml) and one conditioner (also 400ml) to make your hair silky smooth. And guess what? For just over 100 bucks, I’ll throw in two extra travel-size shampoos (100ml each) plus twelve mini sachets (8ml each)—that’s nearly 300ml free! You’re getting almost a full bottle (400ml) as a bonus! Going once… going twice… If your hair gets super oily even after just one day without washing, click the link in the bottom-left corner of the video to order now! It really works—you’re gonna love it!",
        "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
}

错误码说明

相关接口

完整的以图搜广告流程涉及以下接口：

1. 图片提交：/v3/api/open/ai-search/image/submit 或 /v3/api/open/ai-search/image/submit/image-url
2. 处理状态查询：/v3/api/open/ai-search/image/status
3. 结果摘要：/v3/api/open/ai-search/image/resultSummary
4. 广告搜索（本接口）：/v3/api/open/ai-search/image/search4/ad/search
5. 产品搜索：/v3/api/open/ai-search/image/product/search
6. 店铺搜索：/v3/api/open/ai-search/image/root-path/search
7. TikTok产品搜索：/v3/api/open/ai-search/image/tiktok-product/search
8. TikTok店铺搜索：/v3/api/open/ai-search/image/tiktok-shop/search