以图搜店铺接口

调用整体流程

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/root-path/search
• 接口描述: 根据图片ID查询相似店铺，支持多维度过滤和排序
• 价格说明: 获取一条数据结果消耗1 credit

请求头:

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

请求参数

请求结构

请求体参数 (params 对象)

请求示例

基础请求示例

使用 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/root-path/search",
    "params": {
        "image_id": "img_1737532800123456",
        "data_type": 0,
        "time": 0,
        "sort": 10,
        "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/root-path/search",
    "params": {
        "image_id": "img_1737532800123456",
        "data_type": 1,
        "time": 0,
        "sort": 0,
        "sort_type": "desc",
        "current_page": 1,
        "page_size": 20,
        "keyword": "fashion",
        "search_type": 5,
        "shop_type": ["shopify", "woocommerce"],
        "store_countries": ["US", "GB"],
        "play_count_min": 10000
    }
  }'

响应参数

响应体结构

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [ ... ],
    "page": { ... }
  },
  "version": "v1",
  "timestamp": null,
  "sign": null,
  "remaining_credits": 9980,
  "consumed_credits": 20,
  "success": true,
  "fail": false
}

响应字段说明

顶层字段

店铺数据字段 (data)

商品源信息字段 (good_source)

网站信息字段 (website_info)

分页信息字段 (page)

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      {
        "id": "61f57e4d9a301ef93d53b88a",
        "store_id": "store_123456",
        "root_path": "shop.example.com",
        "shop_type": "shopify",
        "plat_type": ["tiktok", "facebook"],
        "icon": "https://fb-cdn.pipispy.com/images/icon.png",
        "all_data_count": 2285852,
        "all_play_count": 76792774635,
        "all_digg_count": 661586882,
        "all_put_days": 59,
        "all_found_time": 1700000000,
        "all_latest_found_time": 1700086400,
        "all_page_count": 3256,
        "all_min_cpm": 15.5,
        "all_max_cpm": 45.8,
        "popular_person_count": 1157348,
        "is_collection": false,
        "good_source": [
          {
            "cover": "https://fb-cdn.pipispy.com/images/cover1.png",
            "app_image": "https://fb-cdn.pipispy.com/images/app1.png",
            "count": 1088,
            "video_id": "video_001"
          },
          {
            "cover": "https://fb-cdn.pipispy.com/images/cover2.png",
            "app_image": "https://fb-cdn.pipispy.com/images/app2.png",
            "count": 5715,
            "video_id": "video_002"
          },
          {
            "cover": "https://fb-cdn.pipispy.com/images/cover3.png",
            "app_image": "https://fb-cdn.pipispy.com/images/app3.png",
            "count": 172,
            "video_id": "video_003"
          }
        ],
        "website_info": {
          "website_id": "web_001",
          "website_url": "https://shop.example.com",
          "website_title": "Example Shop",
          "website_monthly_visits": 5000000,
          "website_bounce_rate": 0.45,
          "website_visit_seconds": 180
        }
      }
    ],
    "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

使用说明

1. 相似度排序: 默认情况下(sort=10),店铺列表按图片相似度降序排列,最相似的店铺排在最前面
2. 平台筛选: 使用 data_type 参数可以筛选特定平台的店铺数据
3. 时间范围: 使用 time 参数可以获取指定时间范围内的店铺数据
4. 关键词搜索: 支持按店铺名字或店铺URL搜索
5. 地区过滤: 支持按店铺所在国家筛选
6. 店铺类型: 支持按电商系统类型筛选(如Shopify、WooCommerce等)
7. 数据统计: 返回结果包含 TikTok、Facebook 和全平台的完整统计数据