Product
获取单个 AliExpress 商品：价格、每个 SKU 及其库存、图片、规格、卖家，以及按需提供的运费。
GET | POST /v1/aliexpress/product参数可以用 GET 的查询字符串发送，也可以用 POST 的 JSON 请求体发送，两者等价。
请求
curl "https://gateway.apinoa.com/v1/aliexpress/product?id=1005012583726882" \
-H "x-api-key: $APINOA_API_KEY"参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | string | 是 | AliExpress product id, as carried by a search item. |
currency | string | Presentment currency. | |
include | enum | include=shipping adds delivery: the cheapest shipping cost and delivery days to region for the product's listed variant. Costs one more unit. shipping | |
language | string | Presentment language. | |
region | string | Buyer country (ISO 3166-1 alpha-2). |
这些参数及所有响应类型也写在OpenAPI 文档中。
响应
在 data 中返回 Product。 真实响应的节选：数组只保留前几项，长文本已截断。
{
"data": {
"marketplace": "aliexpress",
"id": "1005012583726882",
"url": "https://www.aliexpress.com/item/1005012583726882.html",
"title": "New Floating Airbag Waterproof Swimming Bag Phone Case For iPhone Samsung Xiaomi Redmi Huawei Google OPPO Vivo Phone Co…",
"price": {
"currency": "USD",
"amount": 2.25
},
"listPrice": {
"currency": "USD",
"amount": 4.5
},
"brand": "GOT-TOG",
"rating": {
"average": 0
},
"seller": {
"id": "1105627229",
"name": "Shop1105624218 Store",
"country": "CN",
"ext": {
"detailedRatings": {
"itemAsDescribed": 4.5,
"communication": 4.7,
"shippingSpeed": 4.7
}
}
},
"salesCount": 2,
"salesLabel": "2",
"inStock": true,
"delivery": {
"handlingDays": 7
},
"stock": 39,
"badges": [],
"promotions": [],
"attributes": [
{
"name": "High-concerned chemical",
"value": "none"
},
{
"name": "Origin",
"value": "Mainland China"
}
],
"description": "<p><img src=\"https://ae-pic-a1.aliexpress-media.com/kf/S3541bd22822b4ded8745118983aa6c485.jpg\" slate-data-type=\"image\"/…",
"features": [],
"media": {
"images": [
"https://ae01.alicdn.com/kf/Se9739ac4e32a46deaae06bba6a6d0003l.jpg",
"https://ae01.alicdn.com/kf/Sa167b127f8bb44cd85473d9928d486c5G.jpg"
],
"videos": []
},
"category": [
{
"name": "Luggage & Bags"
},
{
"name": "Special Purpose Bags"
}
],
"options": [
{
"id": "14",
"name": "Color",
"values": [
{
"id": "193",
"name": "black",
"imageUrl": "https://ae01.alicdn.com/kf/S3541bd22822b4ded8745118983aa6c485.jpg"
}
]
}
],
"variants": [
{
"id": "12000058743753115",
"price": {
"currency": "USD",
"amount": 2.25
},
"listPrice": {
"currency": "USD",
"amount": 4.5
},
"inStock": true,
"stock": 39,
"selections": [
{
"optionId": "14",
"valueId": "193",
"optionName": "Color",
"valueName": "black"
}
],
"ext": {
"taxIncluded": false
}
}
],
"offers": [],
"reviewAspects": [],
"boxContents": [],
"reviews": [],
"package": {
"weightKg": 0.043,
"ext": {
"heightCm": 1,
"lengthCm": 23,
"soldInLot": false,
"widthCm": 16
}
},
"ext": {
"wholesale": false
}
},
"requestId": "6fc82fad9e5249c1b0bccff6aede0c73",
"success": true
}错误
| 状态 | 代码 | 含义 |
|---|---|---|
| 400 | INVALID_PARAMS | 参数缺失、未知或超出范围。消息中会指出是哪一个。 |
| 401 | UNAUTHORIZED | 缺少 x-api-key 请求头，或密钥已吊销或未知。 |
| 402 | INSUFFICIENT_BALANCE | 余额不足以支付本次调用。请在控制台充值。 |
| 404 | ITEM_NOT_FOUND | AliExpress 上没有该商品。 |
| 503 | TOKEN_EXPIRED | AliExpress 暂时不可用。请稍后重试。 |
全部错误代码见 Errors。失败的调用不计费。
价格
价格 每次调用 $0.001，每多一次调用加 $0.001——最多再加 1 次，合计最多 $0.002。标价；单日调用超过 1,000 次后单价下调。
说明
- 搜索结果条目的
id可直接衔接。 include=shipping会加上配送到region的信息，针对报告价格的那个变体：delivery是最便宜的选项（价格加上delivery.cost即为到手价），shippingOptions列出所有报价选项，最便宜的在前。该调用计 2 个单位。Shipping 可单独为任意变体报价。