当前位置：网站首页>速卖通：按关键字搜索商品 API
速卖通：按关键字搜索商品 API
2022-07-27 17:46:00 【分享干货的猫】
一、参数
公共参数
请求地址: https://api-gw.onebound.cn/aliexpress/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=&cat=&discount_only=&sort=&page_size=&seller_info=&nick=&ppath=
参数说明：q:搜索关键字
cat:分类ID
start_price:开始价格
end_price:结束价格
sort:排序[bid,_bid,_sale,_new]
(bid:总价,sale:销量,new上架时间,加_前缀为从大到小排序)
page:
响应参数
Version: Date:
| 名称 | 类型 | 必须 | 示例值 | 描述 |
|---|---|---|---|---|
num_iid | Bigint | 0 | 32944112999 | 宝贝ID |
title | String | 0 | Male Breathable Comfortable Casual Shoes Fashion Men Canvas Shoes Lace up Wear-resistant Men Sneakers zapatillas deportiva | 商品标题 |
pic_url | String | 0 | //ae01.alicdn.com/kf/HTB1_AwYXdfvK1RjSspfq6zzXFXap/Male-Breathable-Comfortable-Casual-Shoes-Fashion-Men-Canvas-Shoes-Lace-up-Wear-resistant-Men-Sneakers-zapatillas.jpg_220x220xz.jpg | 宝贝图片 |
promotion_price | String | 0 | 8.75-8.97 | 优惠价 |
price | String | 0 | 8.75-8.97 | 价格 |
sales | Int | 0 | 销量 | |
feedback | Int | 0 | 80 | 评论数 |
orders | Int | 0 | 815 | 订单数 |
sample_id | String | 0 | 商品风格标识ID | |
post_fee | Float | 0 | 9.91 | 物流费用 |
star | String | 0 | 4.8 | 商品评分 |
area | String | 0 | 店铺所在地 | |
detail | String | 0 | //www.aliexpress.com/item/Male-Breathable-Comfortable-Casual-Shoes-Fashion-Men-Canvas-Shoes-Lace-up-Wear-resistant-Men-Sneakers-zapatillas/32944112999.html | 商品链接 |
二、示例
请求示例
-- 请求示例 url 默认请求参数已经URL编码处理 curl -i "https://api-gw.onebound.cn/aliexpress/item_search/?key=<您自己的apiKey>&secret=<您自己的apiSecret>&q=shoe&start_price=&end_price=&page=&cat=&discount_only=&sort=&page_size=&seller_info=&nick=&ppath="
响应示例
{
"items": {
"page": 1,
"error": "",
"real_total_results": "3950970",
"total_results": 4400,
"item": [
{
"title": "Zapatos de hombre",
"pic_url": "https://ae04.alicdn.com/kf/S146337910c4242daaed0cc400b6635e5v.jpg",
"promotion_price": 20.87,
"price": 20.87,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804369275759",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-0",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804369275759.html"
},
{
"title": "Zapatos de malla para mujer WJ161",
"pic_url": "https://ae04.alicdn.com/kf/S3b3a9294dded435dbb9f5b51395751f9o.jpg",
"promotion_price": 17.5,
"price": 17.5,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804369292813",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-1",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804369292813.html"
},
{
"title": "Colgante de plata de ley 925 para mujer, dije de amor, compatible con Pandora, pulseras, joyería Original, serie oceánica de verano, novedad",
"pic_url": "//ae04.alicdn.com/kf/S2da341e0ad7c44e3951763c2e7f1f055x.jpg",
"promotion_price": 0.01,
"price": 0.01,
"orginal_price": "",
"sales": 0,
"num_iid": "3256803242880791",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-2",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256803242880791.html"
},
{
"title": "Chanclas de verano para hombre, sandalias de playa antideslizantes, zapatos planos informales, Zapatillas de casa para interior y exterior, 2022",
"pic_url": "https://ae04.alicdn.com/kf/S3303f3d624e148a384c913a7ffc33e68Z.jpg",
"promotion_price": 3.89,
"price": 3.89,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804184357575",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-3",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804184357575.html"
},
{
"title": "Botas de Cosplay de Ojamajo Doremi Hana Makihatayama, zapatos de cuero blanco a medida",
"pic_url": "https://ae04.alicdn.com/kf/Sf478a18c2cd443babe9f40498731f1ffI.jpg",
"promotion_price": 35.64,
"price": 35.64,
"orginal_price": "",
"sales": 0,
"num_iid": "3256802726545330",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-4",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256802726545330.html"
},
{
"title": "Zapatillas de suela gruesa para hombre y mujer, chanclas de plataforma antideslizantes, zapatos de diseñador, sandalias",
"pic_url": "https://ae04.alicdn.com/kf/Sec33322602a94251bf12531885670b07x.jpg",
"promotion_price": 3.92,
"price": 3.92,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804226773913",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-5",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804226773913.html"
},
{
"title": "B",
"pic_url": null,
"promotion_price": null,
"price": null,
"orginal_price": "",
"sales": 0,
"num_iid": null,
"sample_id": null,
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/.html"
},
{
"title": "Sandalias de verano para niñas pequeñas, zapatos bonitos de princesa caramelo, sandalias romanas antideslizantes, zapatos transpirables de playa con agujeros en la cueva",
"pic_url": "//ae04.alicdn.com/kf/S71f03a99254641e8a0cea0686d5e59a2Z.jpg",
"promotion_price": 7.9,
"price": 7.9,
"orginal_price": "",
"sales": 0,
"num_iid": "3256803872305870",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-7",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256803872305870.html"
},
{
"title": "Zapatillas de tiburón para mujer, sandalias de verano, chanclas antideslizantes para el hogar, zapatos de moda para parejas, zapatillas divertidas para interiores y exteriores, 2022",
"pic_url": "//ae04.alicdn.com/kf/S6f5f4b77db6a47ff84e44ec75f4fe83be.jpg",
"promotion_price": 8.08,
"price": 8.08,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804002500233",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-8",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804002500233.html"
},
{
"title": "Zapatillas de playa para hombre y mujer, chanclas suaves de Eva, de suela gruesa dentada, antideslizantes",
"pic_url": "https://ae04.alicdn.com/kf/S8f0d6d2e0ce14b0c834cbdccff982e58z.jpg",
"promotion_price": 8.99,
"price": 8.99,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804137655133",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-9",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804137655133.html"
},
{
"title": "White Sneakers Women Shoes Casual Platform Mesh Breathable Vulcanized Shoes Ladies Outdoor Walking Footwear Chaussure Femme",
"pic_url": "https://ae04.alicdn.com/kf/S5c34e405ba854e2b944b397c36565005H.jpg",
"promotion_price": 10.46,
"price": 10.46,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804344307211",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-10",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804344307211.html"
},
{
"title": "B",
"pic_url": null,
"promotion_price": null,
"price": null,
"orginal_price": "",
"sales": 0,
"num_iid": null,
"sample_id": null,
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/.html"
},
{
"title": "Zapatillas de tiburón para hombre y mujer, chanclas de playa con plataforma de 4CM, para interior y baño, suaves, de EVA, para verano",
"pic_url": "https://ae04.alicdn.com/kf/S4ee5e71c3c664db1b6183e49c6787f59R.jpg",
"promotion_price": 6.39,
"price": 6.39,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804223634744",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-12",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804223634744.html"
},
{
"title": "Sandalias de Plataforma para Mujer, Zapatos Planos de Verano, a la Moda para Interiores y el Hogar, Nuevo, 2022",
"pic_url": "https://ae04.alicdn.com/kf/S62b2b9205384410fa2833ec76d2851aa7.jpg",
"promotion_price": 10.17,
"price": 10.17,
"orginal_price": "",
"sales": 0,
"num_iid": "3256803602412251",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-13",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256803602412251.html"
},
{
"title": "Zapatillas de deporte informales para hombre, Tenis de lujo, transpirables, para correr, baloncesto, caminar",
"pic_url": "//ae04.alicdn.com/kf/Sb1e8292672bb4bba8863670afc596d9aA.jpg",
"promotion_price": 40,
"price": 40,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804181619191",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-14",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804181619191.html"
},
{
"title": "Zapatillas de deporte de alta calidad para Hombre, zapatos transpirables, blancos, a la moda, para gimnasio, calzado ligero informal para caminar",
"pic_url": "https://ae04.alicdn.com/kf/S62f5c44e5aba442c9dd8bf8cc743e539D.jpg",
"promotion_price": 19.5,
"price": 19.5,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804370443445",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-15",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804370443445.html"
},
{
"title": "Zapatillas peludas para mujer, sandalias mullidas de pelo de zorro de felpa, pantuflas de piel cálidas para invierno",
"pic_url": "https://ae04.alicdn.com/kf/Se7d1c776fd6e4a9c844dc6e3aa5dc1d5q.jpg",
"promotion_price": 7.98,
"price": 7.98,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804038443132",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-16",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804038443132.html"
},
{
"title": "Lolita-zapatos de tacón alto con plataforma para mujer, sandalias de estilo japonés, Estilo Vintage, para estudiantes",
"pic_url": "https://ae04.alicdn.com/kf/S9142e109e5674cb19961770656feb369Y.jpg",
"promotion_price": 9.4,
"price": 9.4,
"orginal_price": "",
"sales": 0,
"num_iid": "2255801092398027",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-17",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/2255801092398027.html"
},
{
"title": "Abalorio de plata de ley 925 con diseño de gato y bicicleta, accesorio Original compatible con pulseras Pandora, joyería DIY para hacer regalos, novedad",
"pic_url": "https://ae04.alicdn.com/kf/Had57949a494b4decac372d2909f7820fu.jpg",
"promotion_price": 3.14,
"price": 3.14,
"orginal_price": "",
"sales": 0,
"num_iid": "3256803389168840",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-18",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256803389168840.html"
},
{
"title": "Zapatos de Seguridad Ligeros y Transpirables con Punta de Acero Antigolpes, Zapatillas a Prueba de Perforaciones para el Trabajo, Calzado para Hombre y Mujer",
"pic_url": "//ae04.alicdn.com/kf/H805ef31d8a784faab67ddf38bd53dd67t.jpg",
"promotion_price": 24.38,
"price": 24.38,
"orginal_price": "",
"sales": 0,
"num_iid": "2261800176846677",
"sample_id": "452e4cb8-a885-4923-8616-f182c0740010-19",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/2261800176846677.html"
}
],
"related_keywords": [],
"nav_catcamp": [],
"crumbs": [],
"breadcrumbs": [],
"navs": [],
"data_from": "",
"url": "",
"keyword": "shoe",
"cid": "",
"page_size": 20,
"pagecount": ""
},
"error_code": "0000",
"reason": "ok",
"secache": "a799cd7c0b5c3217932480868ddb51cc",
"secache_time": 1658883513,
"secache_date": "2022-07-27 08:58:33",
"error": "",
"cache": 0,
"api_info": "today:75 max:10100 all[160=75+26+59];expires:2030-12-31",
"execution_time": "2.172",
"server_time": "Beijing/2022-07-27 08:58:33",
"client_ip": "106.6.35.233",
"call_args": {
"q": "shoe"
},
"api_type": "aliexpress",
"translate_language": "zh-CN",
"translate_engine": "google_cn",
"server_memory": "3.25MB",
"request_id": "gw-1.62e08db758267",
"last_id": "1105609715"
}三、错误码解释
| 状态代码(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 | 未知错误 | 否 |
边栏推荐
- Wu Hequan: digital technology empowering "double carbon" practice according to local conditions
- ACL11.12
- conda常用命令
- Software configuration | tigervnc download, installation and configuration
- 内置函数时间日期函数
- unity2D 动态漫画剧本（给猛虎桥章节做动画演示二）
- C191: password compilation
- Leetcode exercise 2 - sum of two numbers
- 产品经理：排查下线上哪里冒出个“系统异常”的错误提示
- [paper reading] rich feature hierarchies for accurate object detection and semantic segmentation
猜你喜欢
How to run kevinchappell / FormBuilder
How to encrypt the data in MySQL database? Mysql8.0 comes with new features
Detailed introduction to common coordinate system of cesium
Qtexttospeech class of QT realizes voice broadcast function
Introduction to basic cesium controls
PC Museum (3) MITs Altair 8800
电容串联与并联以及电容串联与平衡电阻
What does bus mean
剑指 Offer 25. 合并两个排序的链表
Product Manager: check where there is an error prompt of "system exception" on the offline
随机推荐
Assignment 1 - Hello World ! - Simple thread Creation
How to encrypt the data in MySQL database? Mysql8.0 comes with new features
Compiling ncnn with vs
MongoDB 学习笔记： BSON 结构分析
TS2532: Object is possibly ‘undefined‘
[redis] redis penetration, avalanche and breakdown
An in-depth understanding of crystal oscillation circuit derived from xtalin pin and xtalout pin of single chip microcomputer
uva1421
[IOT] Wei Peng: Interpretation of 6000 + words | seven necessary product management tools for product people in 2022 (version 1.0)
Function summary
内置函数锁相关
【IoT】卫朋：6000+ 字解读 | 2022年产品人必备的7个产品管理工具（1.0版）
Datepicker date selector in viewui compatible solution in ie11 browser
连接池-归还连接详解(上)
conda常用命令
由单片机XTALIN引脚和XTALOUT引脚导出的对晶体震荡电路的深入理解
Talk about how redis handles requests
Container summary
Online judge output overrun
LG Group announced that it would donate 3million yuan in cash, 1.2 million masks and 10000 sets of protective clothing to Hubei