TikTok for Developers

开发者文档

上次更新时间:2026年9月1日

查询 TikTok Shop 信息

用户交互 - 店铺 API 端点

查询参数

Key

类型

描述

示例

是否必填

category


字符串 (String)

需要分析的数据类别。由于各数据类别的脚本语言相同,因此该值将用于确定要获取的目标数据。

tiktok_shop_info


是

condition_groups


对象 (Object)


指定要查询的数据。




condition_groups = [ { "operator": "and", "conditions": [ { "field": "shop_name", "operator": "eq", "field_values": ["tiktok_shop"] } ] } ]

否


fields


字符串 (String)


需返回的数据字段。接口将只返回此处列出的字段。

shop_name,shop_rating,shop_review_count,item_sold_count,shop_id


否

limit


整数 (int)

返回的最大记录数。

测试阶段

默认值为 10。

执行阶段

默认值为 100。


否

查询条件

Key

类型

描述

是否必填

and

list<Condition>

and 条件规定查询结果必须满足列表中的所有条件。

否

or

list<Condition>

or 条件规定查询结果必须满足至少一个列表中的条件。

否

not


list<Condition>

not 条件规定查询结果不能符合任何列表中的条件。

否

响应

Key

类型

描述

示例

result


字符串 (String)


查询任务返回的数据字段。该接口仅返回已在欧盟地区上架的店铺的指定字段。

shop_name,shop_rating,shop_review_count,item_sold_count,shop_id,shop_performance_value

TikTok for Developers