temu.item_search
公共参数
前往测试
名称 |
类型 |
必须 |
描述 |
key |
String |
是 |
调用key（必须以GET方式拼接在URL中） |
secret |
String |
是 |
调用密钥 |
api_name |
String |
是 |
API接口名称（包括在请求地址中）[item_search,item_get,item_search_shop等] |
cache |
String |
否 |
[yes,no]默认yes，将调用缓存的数据，速度比较快 |
result_type |
String |
否 |
[json,jsonu,xml,serialize,var_export]返回数据格式，默认为json，jsonu输出的内容中文可以直接阅读 |
lang |
String |
否 |
[cn,en,ru]翻译语言，默认cn简体中文 |
version |
String |
否 |
API版本 |
请求参数
请求参数：q=shoe&start_price=&end_price=&page=&list_id=&cat=&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=
参数说明：q:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
list_id:列表id
sort:排序[bid,_bid,bid2,_bid2,_sale,_credit]
(bid:总价,bid2:商品价格,sale:销量,credit信用,加_前缀为从大到小排序)
page:
响应参数
Version: Date:2023-12-18
名称 |
类型 |
必须 |
示例值 |
描述 |
items |
items[] |
0 |
按关键字搜索商品 |
|
page |
Int |
0 |
1 |
页码 |
page_size |
Int |
0 |
20 |
接口返回数量 |
has_more |
String |
0 |
true |
是否有下一页 |
item |
item[] |
0 |
详情数据 |
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw.onebound.cn/temu/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=shoe&start_price=&end_price=&page=&list_id=&cat=&discount_only=&sort=&page_size=&seller_info=&nick=&ppath="
响应示例
{ "items": { "page": 1, "page_size": 120, "has_more": true, "data_from": "app", "item": [ { "title": "2022 Minimalist Mens Fashion Ultra Thin Watches Simple Men Business Stainless Steel Mesh Belt Quartz Watch", "pic_url": "https:\/\/img.kwcdn.com\/product\/Fancyalgo\/VirtualModelMatting\/c7ef2fecd0a44b17857a152b674969fb.jpg", "price": "2.09", "orginal_price": "2.09", "sales": "90K+", "num_iid": 601099512645657, "detail_url": "https:\/\/www.temu.com\/2022-minimalist-mens-fashion-ultra-thin-watches-simple-men-business-stainless-steel-mesh-belt-quartz-watch-g-601099512645657.html?&top_gallery_url=https%3A%2F%2Fimg.kwcdn.com%2Fproduct%2FFancyalgo%2FVirtualModelMatting%2Fc7ef2fecd0a44b17857a152b674969fb.jpg&spec_gallery_id=7257449&refer_page_sn=10009&refer_source=0&freesia_scene=2&_oak_freesia_scene=2&_oak_rec_ext_1=MjA5", "list_id": "896ae23b45bdb231845f7d33fb5eaadc_1708653658747" }, { "title": "POEDAGAR Waterproof Luminous Calendar Mens Quartz Watch Stainless Steel Wrist Watch, Ideal choice for Gifts", "pic_url": "https:\/\/img.kwcdn.com\/product\/Fancyalgo\/VirtualModelMatting\/af19f3e3847f330cebe874a0665b4ad2.jpg", "price": "8.98", "orginal_price": "8.98", "sales": "20K+", "num_iid": 601099520399445, "detail_url": "https:\/\/www.temu.com\/poedagar-waterproof-luminous-calendar-mens-quartz-watch-stainless-steel-wrist-watch-g-601099520399445.html?&top_gallery_url=https%3A%2F%2Fimg.kwcdn.com%2Fproduct%2FFancyalgo%2FVirtualModelMatting%2Faf19f3e3847f330cebe874a0665b4ad2.jpg&spec_gallery_id=2011275199&refer_page_sn=10009&refer_source=0&freesia_scene=2&_oak_freesia_scene=2&_oak_rec_ext_1=ODk4", "list_id": "896ae23b45bdb231845f7d33fb5eaadc_1708653658747" } ] } }
异常示例
{ "error": "item-not-found", "reason": "没找到", "error_code": "2000", "success": 0, "cache": 0, "api_info": "today:0 max:10000", "execution_time": 0.081, "server_time": "Beijing/2023-12-15 17:44:00", "call_args": [], "api_type": "temu", "request_id": "shoe"}
相关资料错误码解释
状态代码(error_code) |
状态信息 |
详细描述 |
是否收费 |
0000 |
success |
接口调用成功并返回相关数据 |
是 |
2000 |
Search success but no result |
接口访问成功，但是搜索没有结果 |
是 |
4000 |
Server internal error |
服务器内部错误 |
否 |
4001 |
Network error |
网络错误 |
否 |
4002 |
Target server error |
目标服务器错误 |
否 |
4003 |
Param error |
用户输入参数错误 |
忽略 |
4004 |
Account not found |
用户帐号不存在 |
忽略 |
4005 |
Invalid authentication credentials |
授权失败 |
忽略 |
4006 |
API stopped |
您的当前API已停用 |
忽略 |
4007 |
Account stopped |
您的账户已停用 |
忽略 |
4008 |
API rate limit exceeded |
并发已达上限 |
忽略 |
4009 |
API maintenance |
API维护中 |
忽略 |
4010 |
API not found with these values |
API不存在 |
忽略 |
4012 |
Please add api first |
请先添加api |
忽略 |
4013 |
Number of calls exceeded |
调用次数超限 |
忽略 |
4014 |
Missing url param |
参数缺失 |
忽略 |
4015 |
Wrong pageToken |
参数pageToken有误 |
忽略 |
4016 |
Insufficient balance |
余额不足 |
忽略 |
4017 |
timeout error |
请求超时 |
否 |
5000 |
unknown error |
未知错误 |
否 |
