以图搜TikTok店铺接口

调用整体流程

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（本接口）

接口概述

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

该接口支持丰富的过滤条件，包括关键词搜索、地区、分类、销量、价格、广告数据等多维度筛选，帮助用户精准定位目标店铺。

接口信息

• 接口名称: 以图搜TikTok店铺
• 请求方法: POST
• 接口地址: /open-api/v1/data
• 接口路径: /v3/api/open/ai-search/image/tiktok-shop/search
• 接口描述: 根据图片ID查询相似TikTok店铺，支持多维度过滤和排序
• 价格说明: 获取一条数据结果消耗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/tiktok-shop/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/tiktok-shop/search",
    "params": {
        "image_id": "img_1737532800123456",
        "current_page": 1,
        "page_size": 20,
        "keyword": "fashion store",
        "region": "US",
        "sales_volume_min": 1000,
        "avg_price_usd_min": 10,
        "avg_price_usd_max": 100,
        "sort": 3,
        "sort_type": "desc"
    }
  }'

按销售趋势和店铺类型过滤

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/tiktok-shop/search",
    "params": {
        "image_id": "img_1737532800123456",
        "current_page": 1,
        "page_size": 20,
        "sales_trend": 1,
        "delivery": "overseas",
        "product_type": "brand",
        "gmv_min": 10000,
        "time": 30,
        "sort": 4
    }
  }'

响应参数

响应体结构

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

响应字段说明

顶层字段

店铺数据字段 (data)

CategoryDTO对象信息

SalesTrendData对象信息

BestSellingGood对象信息

分页信息字段 (page)

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      {
        "id": "shop_001",
        "image": "https://cdn-shop.pipispy.com/tiktok_shop_001.jpg",
        "title": "Fashion Store Official",
        "desc": "Premium fashion and accessories",
        "sales_volume": 125000,
        "score": 4.8,
        "shop_name": "Fashion Store Official",
        "shop_id": "shop_12345",
        "shop_image": "https://cdn-shop.pipispy.com/shop_icon.jpg",
        "shop_sales_volume": 125000,
        "video_count": 245,
        "categorize": [
          {
            "_id": "cat_001",
            "name_en": "Fashion",
            "name_zh": "时尚"
          }
        ],
        "region": ["US", "GB"],
        "play_count": 12345678,
        "share_count": 45678,
        "found_time": 1700000000,
        "last_found_time": 1737532800,
        "insert_time": 1700000000,
        "update_time": 1737532800,
        "min_cpm": 15.5,
        "max_cpm": 45.8,
        "currency": "USD",
        "is_collection": false,
        "root_path": "tiktok.com",
        "keywords": ["fashion", "clothing", "accessories"],
        "card_found_time": 1700086400,
        "card_last_found_time": 1737446400,
        "sales_trend": 1,
        "sales_trend_data": [],
        "gmv": 3750000.00,
        "gmv_usd": 3750000.00,
        "is_in_marketplace": true,
        "is_managed": false,
        "person_count": 156,
        "landing_page": "https://www.tiktok.com/@fashionstore",
        "goods_count": 450,
        "goods_ad_count": "245",
        "best_selling_goods": [
          {
            "id": "prod_001",
            "image": "https://cdn-product.pipispy.com/prod_001.jpg",
            "title": "Summer Dress",
            "price": 29.99,
            "sales_volume": 5000
          }
        ],
        "avg_price": 35.50,
        "avg_price_usd": 35.50,
        "product_type": ["brand"],
        "delivery": ["overseas", "local"]
      }
    ],
    "page": {
      "total_count": 500,
      "page_count": 25,
      "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
}

错误码说明

相关接口

完整的以图搜TikTok店铺流程涉及以下接口:

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=11),店铺列表按图片相似度排序,最相似的店铺排在最前面。注意:当sort=11时,sort_type参数无效
2. 关键词搜索: 支持按店铺名字、店铺描述等维度搜索
3. 地区过滤: 支持按店铺投放地区筛选
4. 销售数据: 支持按销量、GMV、销售趋势等销售指标筛选
5. 广告数据: 支持按广告播放量、广告数、广告花费等广告指标筛选
6. 店铺类型: 支持按发货方式(跨境/本地)和商品类型(品牌/零售商)筛选
7. 时间范围: 使用 time 参数可以获取指定时间范围内的店铺数据
8. 达人营销: 支持按达人数量筛选,了解店铺的网红营销情况
9. 价格筛选: 支持按平均销售价格筛选店铺