以图搜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-product/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-product/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-product/search",
    "params": {
        "image_id": "img_1737532800123456",
        "current_page": 1,
        "page_size": 20,
        "search_type": 1,
        "keyword": "fashion",
        "region": "US",
        "sales_volume_min": 1000,
        "price_usd_min": 10,
        "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-product/search",
    "params": {
        "image_id": "img_1737532800123456",
        "current_page": 1,
        "page_size": 20,
        "sales_trend": 1,
        "delivery": "overseas",
        "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对象信息

分页信息字段 (page)

响应示例

{
  "code": 200,
  "message": "success",
  "data": {
    "data": [
      {
        "id": "product_001",
        "image": "https://cdn-product.pipispy.com/tiktok_product_001.jpg",
        "title": "Wireless Bluetooth Earbuds",
        "desc": "High quality wireless earbuds with noise cancellation",
        "price": 29.99,
        "price_usd": 29.99,
        "sales_volume": 15234,
        "score": 4.8,
        "shop_name": "TechStore Official",
        "shop_id": "shop_12345",
        "shop_image": "https://cdn-shop.pipispy.com/shop_icon.jpg",
        "shop_sales_volume": 125000,
        "video_count": 45,
        "categorize": {
          "id": "cat_001",
          "name": "Electronics"
        },
        "region": "US",
        "play_count": 2345678,
        "share_count": 12345,
        "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": ["wireless", "bluetooth", "earbuds"],
        "card_found_time": 1700086400,
        "card_last_found_time": 1737446400,
        "commission_rate": 0.15,
        "sales_trend": 1,
        "sales_trend_data": [],
        "gmv": 456789.50,
        "gmv_usd": 456789.50,
        "delivery": "overseas",
        "is_in_marketplace": true,
        "is_managed": false,
        "person_count": 23
      },
      {
        "id": "product_002",
        "image": "https://cdn-product.pipispy.com/tiktok_product_002.jpg",
        "title": "Smart Watch Fitness Tracker",
        "desc": "Advanced fitness tracker with heart rate monitor",
        "price": 49.99,
        "price_usd": 49.99,
        "sales_volume": 8765,
        "score": 4.6,
        "shop_name": "FitGear Store",
        "shop_id": "shop_67890",
        "shop_image": "https://cdn-shop.pipispy.com/shop_icon2.jpg",
        "shop_sales_volume": 89000,
        "video_count": 32,
        "categorize": {
          "id": "cat_002",
          "name": "Wearables"
        },
        "region": "GB",
        "play_count": 1234567,
        "share_count": 8901,
        "found_time": 1699913600,
        "last_found_time": 1737446400,
        "insert_time": 1699913600,
        "update_time": 1737446400,
        "min_cpm": 18.2,
        "max_cpm": 52.3,
        "currency": "USD",
        "is_collection": true,
        "root_path": "tiktok.com",
        "keywords": ["smartwatch", "fitness", "tracker"],
        "card_found_time": 1700000000,
        "card_last_found_time": 1737360000,
        "commission_rate": 0.12,
        "sales_trend": 0,
        "sales_trend_data": [],
        "gmv": 437823.35,
        "gmv_usd": 437823.35,
        "delivery": "local",
        "is_in_marketplace": true,
        "is_managed": true,
        "person_count": 18
      }
    ],
    "page": {
      "total_count": 1000,
      "page_count": 50,
      "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=9),商品列表按图片相似度降序排列,最相似的商品排在最前面
2. 关键词搜索: 支持按产品名称、店铺名称、红人名称等不同维度搜索
3. 地区过滤: 支持按商品投放地区筛选
4. 销售数据: 支持按销量、GMV、销售趋势等销售指标筛选
5. 广告数据: 支持按广告播放量、广告数、广告花费等广告指标筛选
6. 发货方式: 支持按跨境发货或本地发货筛选
7. 时间范围: 使用 time 参数可以获取指定时间范围内的商品数据
8. 达人营销: 支持按达人数量筛选,了解商品的网红营销情况