item_search-按关键字搜索aliexpress商品 注册开通
onebound.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 | 商品链接 |
请求示例
- Curl
- PHP
- PHPsdk
- JAVA
- C#
- Python
-- 请求示例 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": "453438",
"total_results": 4400,
"item": [
{
"title": "Zapatillas de deporte vulcanizadas transpirables informales para Mujer, a la moda mocasines de suela gruesa, tenis, 2022",
"pic_url": "//ae04.alicdn.com/kf/S9d8cb2a5e9c04db0854ead8b2c523619G.jpg",
"promotion_price": 5.87,
"price": 5.87,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804443696695",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-0",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804443696695.html"
},
{
"title": "Zapatillas de deporte de moda para mujer, zapatos planos de plataforma de Color sólido, informales, transpirables, con tacón de cuña, para caminar",
"pic_url": "https://ae04.alicdn.com/kf/S973f37df9f98417dad3498eb589df409b.jpg",
"promotion_price": 19.95,
"price": 19.95,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804418555420",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-1",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804418555420.html"
},
{
"title": "Zapatillas deportivas vulcanizadas para mujer, zapatos planos informales con cordones, de malla, ligeras y transpirables",
"pic_url": "//ae04.alicdn.com/kf/Hbc91dcf8e36845219a82654b434b8c3fo.jpg",
"promotion_price": 24.68,
"price": 24.68,
"orginal_price": "",
"sales": 0,
"num_iid": "3256802945582352",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-2",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256802945582352.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.6,
"price": 3.6,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804226773913",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-3",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804226773913.html"
},
{
"title": "Botas de nieve impermeables para niños y niñas, zapatos de cuero sintético, botas de goma, a la moda, novedad de invierno, 2022",
"pic_url": "//ae04.alicdn.com/kf/Sb5100b42cf4e412b825da6ed4b61556fE.jpg",
"promotion_price": 11.3,
"price": 11.3,
"orginal_price": "",
"sales": 0,
"num_iid": "2251832027324502",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-4",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/2251832027324502.html"
},
{
"title": "Zapatos de invierno para mujer, botas Chelsea de tacón grueso con plataforma y punta redonda a la moda, botines de cuero cómodos para fiesta, diseño de lujo",
"pic_url": "https://ae04.alicdn.com/kf/S774066f17c0c43d6a31720010fb48e1dL.jpg",
"promotion_price": 143.22,
"price": 143.22,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804438691675",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-5",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804438691675.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": "Zapatos casuales para Hombre, Zapatillas cómodas para correr, zapatos para caminar a la moda, Zapatillas transpirables de talla grande, 2022",
"pic_url": "https://ae04.alicdn.com/kf/Hc0d9a40e469442b4b027532f79974f77c.jpg",
"promotion_price": 12.71,
"price": 12.71,
"orginal_price": "",
"sales": 0,
"num_iid": "3256802256175093",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-7",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256802256175093.html"
},
{
"title": "Zapatillas de deporte para niña, zapatos transpirables de malla para bebé, zapatillas planas para niña pequeña, zapatillas para exteriores, novedad de 2022",
"pic_url": "https://ae04.alicdn.com/kf/Sf1b3b5dddb21472faedec3419c0899db9.jpg",
"promotion_price": 11.21,
"price": 11.21,
"orginal_price": "",
"sales": 0,
"num_iid": "3256803612454382",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-8",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256803612454382.html"
},
{
"title": "Botas informales para bebé, zapatos de nieve para niños y niñas, calzado deportivo blanco de marca, zapatillas de deporte para niños 22-28",
"pic_url": "//ae04.alicdn.com/kf/H17d3bbd6915b408aac1cb0ec3265776eM.png",
"promotion_price": 9.59,
"price": 9.59,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804396405635",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-9",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804396405635.html"
},
{
"title": "DEKABR-Botas cálidas de piel auténtica para hombre, botines de nieve impermeables hechos a manos, de invierno",
"pic_url": "//ae04.alicdn.com/kf/Se67ada468d9442898e8e8ddba4a5b249X.jpg",
"promotion_price": 32.9,
"price": 32.9,
"orginal_price": "",
"sales": 0,
"num_iid": "2255799897710441",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-10",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/2255799897710441.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": "Zapatos deportivos para niños, zapatillas de moda para niños y niñas, zapatos para correr en la escuela, Tenis transpirables con cordones de invierno de 5 a 15 años, 2022 tenis para niño zapatillas para",
"pic_url": "//ae04.alicdn.com/kf/Sea9e1e47ad5a4b629902fe551baa549fQ.jpg",
"promotion_price": 6.11,
"price": 6.11,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804127615711",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-12",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804127615711.html"
},
{
"title": "LP-zapatos informales de punta redonda para mujer, calzado con colgante de pie plano, cómodos, a la moda, para primavera y otoño, 2022",
"pic_url": "//ae04.alicdn.com/kf/S3c6da287e2a74a71ae97ae4739aa7968q.jpg",
"promotion_price": 41.49,
"price": 41.49,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804412497648",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-13",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804412497648.html"
},
{
"title": "Zapatillas de deporte para bebé, zapatos planos de moda para niños y niñas, zapatillas deportivas de malla elástica sólida para correr, 2020",
"pic_url": "https://ae04.alicdn.com/kf/Hafaf35221d644b0eb9ecac3a15e4e0cbs.jpg",
"promotion_price": 9.49,
"price": 9.49,
"orginal_price": "",
"sales": 0,
"num_iid": "3256801199795215",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-14",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256801199795215.html"
},
{
"title": "Zapatillas deportivas de amortiguación para niños y niñas, zapatos deportivos informales resistentes al desgaste, ligeros, transpirables, talla 21-30",
"pic_url": "https://ae04.alicdn.com/kf/Sc184eaad797b4e548b85ee8149c1b154m.jpg",
"promotion_price": 9.64,
"price": 9.64,
"orginal_price": "",
"sales": 0,
"num_iid": "3256803728446891",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-15",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256803728446891.html"
},
{
"title": "zapatillas hombre Zapatilla deportivas transpirables para hombres, zapatos masculinos de deporte, cómodos, ligeros, antideslizantes, de estilo casual y resistentes al desgaste, adecuados para correr, en oferta",
"pic_url": "https://ae04.alicdn.com/kf/S54dc8fda03c24b07abef3d3d66e750f7r.jpg",
"promotion_price": 15.75,
"price": 15.75,
"orginal_price": "",
"sales": 0,
"num_iid": "2255801036808411",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-16",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/2255801036808411.html"
},
{
"title": "Zapatos de fútbol TF/FG para hombre, botas de fútbol altas/bajas, antideslizantes para exteriores, hierba Multicolor, zapatillas de entrenamiento, EUR35-45",
"pic_url": "https://ae04.alicdn.com/kf/Sb51910b34bc245608c7359962d83a6e5c.jpg",
"promotion_price": 11.02,
"price": 11.02,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804146829423",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-17",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804146829423.html"
},
{
"title": "Conjunto informal de dos piezas para mujer, jersey de cuello redondo, Tops y pantalones largos sólidos, moda elegante para oficina, 2021",
"pic_url": "//ae04.alicdn.com/kf/Ha2f2d3eb1a954448bc5d77dbea9b1c78X.jpg",
"promotion_price": 15.58,
"price": 15.58,
"orginal_price": "",
"sales": 0,
"num_iid": "3256802092388974",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-18",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256802092388974.html"
},
{
"title": "Zapatillas De lona transpirables para Hombre, zapatos planos informales para caminar, vulcanizados sin cordones, calzado De trabajo De verano",
"pic_url": "https://ae04.alicdn.com/kf/S900a126b69d24c499e0ed3b80d1fd16dI.jpg",
"promotion_price": 5.83,
"price": 5.83,
"orginal_price": "",
"sales": 0,
"num_iid": "3256804085362912",
"sample_id": "5dd30fed-3c23-4c8b-b2dc-7123e828ed26-19",
"seller_nick": "",
"detail_url": "https://www.aliexpress.com/item/3256804085362912.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": 1662620749,
"secache_date": "2022-09-08 15:05:49",
"error": "",
"cache": 0,
"api_info": "today:70 max:10100 all[122=70+25+27];expires:2030-12-31",
"execution_time": "1.393",
"server_time": "Beijing/2022-09-08 15:05:49",
"client_ip": "106.6.32.13",
"call_args": {
"q": "shoe"
},
"api_type": "aliexpress",
"translate_language": "zh-CN",
"translate_engine": "google_cn",
"server_memory": "0.86MB",
"request_id": "gw-4.6319944bd46ea",
"last_id": "1203543829"
}异常示例相关资料错误码解释
状态代码(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 | 未知错误 | 否 |
