商品查询接口

Temu 商品数据查询

该接口用于VIP 用户查询 Temu 商品数据，支持多维度筛选（价格、评分、销量等）、排序与分页。

项目	说明
接口类型	REST API
请求方式	POST
数据格式	JSON
鉴权方式	API Key
适用用户	VIP / 订阅用户

接口地址 text

POST /api/vi/temu-items

鉴权说明 请求需在 Header 中携带 API Key： text

X-VIP-TOKEN: your_api_key_here

请求参数

参数名	类型	必填	说明
search_key	string	否	搜索关键词或商品ID/店铺ID
category_home	string	否	前台类目ID
category_backend	string	否	后台类目ID
price	string	否	价格范围，格式：10~100
rating	string	否	评分范围，格式：4~5
reviews	string	否	评论数范围，格式：100~1000
sales_total	string	否	总销量范围，格式：100~1000
sales_weekly	string	否	周销量范围，格式：10~100
sales_daily	string	否	日销量范围，格式：1~50
sold_out	int	否	是否下架：0=上架，1=下架，默认0
is_local	int	否	是否半托管：0=全托管，1=半托管，默认0
region	string	否	半托管地区，多个用逗号分隔
tags	string	否	商品标签，多个用逗号分隔
custom_tags	string	否	自定义标签，多个用逗号分隔
publish_time	string	否	上架时间范围，格式：YYYY-MM-DD~YYYY-MM-DD
sort_by	string	否	排序字段和方向，如 order_week-0（周销量降序）、order_week-1（周销量升序），默认 order_week-0
page_num	int	否	页码，从1开始
page_size	int	否	每页数量，最大100

请求示例 python

import requests
import json

url = "https://api.ehunt.ai/api/vi/temu-items"
headers = {
    "Content-Type": "application/json",
    "X-VIP-TOKEN": "your_api_key_here"
}
payload = {
    "search_key": "women dress",
    "price": "10~50",
    "sales_weekly": "10~100",
    "rating": "4~5",
    "sort_by": "order_week-0",
    "page_num": 1,
    "page_size": 20
}
response = requests.post(url, headers=headers, json=payload)
print(json.dumps(response.json(), indent=2))

返回示例 json

{
  "code": 200,
  "message": "OK",
  "data": {
    "product_num": 100,
    "page_size": 20,
    "final_count": 20,
    "list": [
      {
        "product_id": "100500123456789",
        "product_name": "Elegant Women's Floral Dress",
        "product_name_cn": "优雅女士碎花连衣裙",
        "logo_url": "https://img.kwcdn.com/product/.../image.jpg",
        "price": 29.99,
        "order_total": 5000,
        "order_week": 200,
        "order_day": 30,
        "order_month": 800,
        "rating": 4.7,
        "review_num": 1200,
        "publish_time": "2024-01-15",
        "sold_out": 0,
        "is_local": 0,
        "local_region": [],
        "store_id": "store_12345",
        "tags": ["floral", "summer"],
        "custom_tags": [],
        "category_home": "1001",
        "category_backend": "2001"
      }
    ]
  },
  "used_today": 150,
  "remaining_today": 350
}

响应字段说明

字段名	类型	说明
product_id	string	商品ID
product_name	string	商品名称（英文）
product_name_cn	string	商品名称（中文）
logo_url	string	商品主图URL
price	float	价格（美元）
order_total	int	总销量
order_week	int	周销量
order_day	int	日销量
order_month	int	月销量
rating	float	评分（0-5）
review_num	int	评论数
publish_time	string	上架时间
sold_out	int	是否下架（0=上架，1=下架）
is_local	int	是否半托管（0=全托管，1=半托管）
local_region	array	半托管地区列表
store_id	string	店铺ID
tags	array	商品标签
custom_tags	array	自定义标签
category_home	string	前台类目ID
category_backend	string	后台类目ID

API 返回码说明

Code	说明
200	成功
401	认证失败（API Key 无效或过期）
402	积分不足或订阅过期
403	无访问权限
429	请求频率过高，触发限流
500	服务器内部错误

积分说明

按实际返回数据量计费，每条数据消耗 1 个积分，清晰透明的消费机制。

商品查询：每条返回的商品消耗 1 积分
店铺查询：每条返回的店铺消耗 1 积分
每日积分上限与订阅套餐有关， Etsy、Shopify、Temu 全部 VIP 接口共用每日积分\

​Temu 商品数据查询

​API 返回码说明

​积分说明

Temu 商品数据查询

API 返回码说明

积分说明