{
"success": true,
"requestId": "05987ff6-42e3-4e31-9554-9504f18d0004",
"data": {
"id": "eMAhklUHwptnAZfjN",
"status": "running",
"type": "search",
"createdAt": "2026-09-28T16:15:32.452Z",
"statusUrl": "/v1/jobs/eMAhklUHwptnAZfjN",
"resultsUrl": "/v1/jobs/eMAhklUHwptnAZfjN/results"
},
"meta": {
"results": 0,
"usage": {
"searches": 0,
"productsReturned": 0,
"detailLookups": 0,
"reviewsReturned": 0,
"storeLookups": 0,
"monitorChecks": 0
},
"durationMs": 22507
}
}
curl --location --request POST 'https://zylalabs.com/api/14021/aliexpress+product+data+and+research+api/33876/search+products' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"query": "wireless earbuds",
"sortBy": "orders",
"maxResults": 1
}'
{
"success": true,
"requestId": "a3fbb4a7-1f5b-4732-b99d-4e361ef79762",
"data": {
"id": "gHORx4HGNacVsGP0E",
"status": "succeeded",
"createdAt": "2026-09-28T16:51:31.153Z",
"statusUrl": "/v1/jobs/gHORx4HGNacVsGP0E",
"resultsUrl": "/v1/jobs/gHORx4HGNacVsGP0E/results",
"finishedAt": "2026-09-28T16:52:04.530Z",
"usageUsd": 0.003987672618109319
},
"meta": {
"results": 1,
"usage": {
"searches": 0,
"productsReturned": 0,
"detailLookups": 0,
"reviewsReturned": 0,
"storeLookups": 0,
"monitorChecks": 0
},
"durationMs": 144
}
}
curl --location --request GET 'https://zylalabs.com/api/14021/aliexpress+product+data+and+research+api/33882/get+job+status&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw ''
{
"success": true,
"requestId": "a46462bd-baa7-4adb-8a50-e228d25cff4a",
"data": [
{
"recordType": "product",
"inputSource": "direct",
"productId": "3256811621288203",
"productUrl": "https://www.aliexpress.com/item/3256811621288203.html",
"scrapedAt": "2026-09-28T16:51:32.620Z",
"detailsCaptured": true,
"detailSource": "pdp_mtop_browser",
"detailTitle": "2026 New Air 3【 Pro 3 】 Bluetooth Wireless Earbuds with Heart Rate Monitoring, Active Noise Cancellation Headphones, Waterproof for Daily Use, For IPhone IOS Smartphone, Gaming /Sports /Fitness Earphones.",
"detailPrice": 21.08,
"detailPriceText": "$21.08",
"detailOriginalPrice": 57.13,
"detailOriginalPriceText": "$57.13",
"detailCurrency": "USD",
"selectedSkuId": "12000056622341652",
"reviewCount": 508,
"detailRating": 4.9,
"stock": 90,
"available": true,
"availabilityNote": null,
"totalSkuCount": 1,
"availableSkuCount": 1,
"brand": "ZZLOVE",
"seller": {
"name": "Shop1105233629 Store",
"positiveRate": 0,
"score": 0,
"country": "China",
"openedYear": 0,
"establishedAt": null,
"followersCount": null,
"totalSales": null,
"topRatedSeller": false,
"url": "https://www.aliexpress.com/store/1105246100",
"sellerId": "6003897797",
"storeId": "1105246100"
},
"wishlistCount": null,
"coupons": [
"prePlatformItemSubsidy-ITEM-5000000217933864,realSuperDeals-ITEM-5000000205694502,platformItemSubsidy-ITEM-5000000210792318"
],
"videoUrl": null,
"descriptionUrl": "https://pdp.aliexpress-media.com/product/description/pc/v2/en_US/desc.htm?productId=1005011807602955&key=S568dd7aa8cc14b1da558a54503320cfdP.zip&token=11df8c33cbe64e5230ed0236afa930e2&sellerId=6003897797",
"detailImages": [
"https://ae-pic-a1.aliexpress-media.com/kf/Sa57a4580c1274b01988d5df3fa8e76cbx.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/Sd4e396cd1abe4e8abdd18af12559e993Y.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/S5aa455871a95472c965645aeb8b56df35.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/Sef791dacf016455691e6ffe4aaf7ddf7K.jpg",
"https://ae-pic-a1.aliexpress-media.com/kf/Sdac3379fc2ec4a1c8f6a5f99ac1b4794Y.png",
"https://ae-pic-a1.aliexpress-media.com/kf/S369d1fe2f3aa4cbebed651d49b188506P.jpg"
],
"variants": [
{
"name": "Color",
"values": [
{
"id": "29",
"name": "WHITE",
"imageUrl": "https://ae-pic-a1.aliexpress-media.com/kf/S1ade62ca5e984825ab3edf50fc8f4cbeI.jpg"
}
]
},
{
"name": "Ships From",
"values": [
{
"id": "201336106",
"name": "United States",
"imageUrl": null
}
]
}
],
"variantPrices": [
{
"skuId": "12000056622341651",
"salePrice": 21.08,
"salePriceText": "$21.08",
"originalPrice": 57.13,
"originalPriceText": "$57.13",
"currency": "USD",
"availableInventory": null,
"saleableStatus": null,
"minBuyCount": null,
"maxBuyCount": null
}
],
"specifications": {
"Department": "Unisex-adult",
"High-concerned chemical": "none",
"Material": "Plastic",
"Maximum wireless range[m]": "10m-20m",
"Sound Isolating": "Yes",
"Category": "Earphones & Headphones",
"Charging Method": "Charging case",
"Bluetooth Version": "5.3",
"Package List": "User Manual,Charging case,Charging Cable,Replaceable Pads Set",
"Features": "With microphone,Active Noice Cancelling",
"With Microphone": "Yes",
"Is wireless": "Yes",
"Audio latency": "20",
"Control Method": "Touch,Others",
"whether electrical": "Yes",
"Speaker maximum output power": "7.5",
"Charging Time": "1.5",
"Function": "For Internet Bar,for Video Game,for Flying,Common Headphone,For Mobile Phone,for Powersports,HiFi Headphone,Sport,For Outdoor,For Swimming,For Office,For DJ,For Study",
"Active Noise-Cancellation": "Yes",
"Volume Control": "Yes",
"Vocalism Principle": "Dynamic",
"Wireless Type": "Bluetooth",
"Connectors": "Type c",
"Communication": "True wireless",
"Style": "Tws in-ear headphones",
"Origin": "Mainland China",
"Brand Name": "ZZLOVE",
"FCC ID": "2A5TA-I39"
},
"shipping": {
"shipFrom": "United States",
"shipTo": "US",
"deliveryDaysMax": 8,
"etaMin": "Oct. 01",
"etaMax": "Oct. 06",
"amount": "free",
"options": [
{
"name": "US AliExpress Delivery-Saver",
"amount": "free",
"isFree": true,
"shipFrom": "United States",
"shipTo": "US",
"deliveryDaysMin": 3,
"deliveryDaysMax": 8,
"etaMin": "Oct. 01",
"etaMax": "Oct. 06",
"tracking": null
}
]
},
"categoryPathDetail": "44/100000306/63705",
"price": 21.08,
"originalPrice": 57.13,
"currency": "USD",
"rating": 4.9
}
],
"meta": {
"results": 1,
"offset": 0,
"limit": 100,
"usage": {
"searches": 0,
"productsReturned": 1,
"detailLookups": 1,
"reviewsReturned": 0,
"storeLookups": 0,
"monitorChecks": 0
},
"durationMs": 360,
"apifyRunId": "gHORx4HGNacVsGP0E"
}
}
curl --location --request GET 'https://zylalabs.com/api/14021/aliexpress+product+data+and+research+api/33883/get+successful+job+results?offset=Optionallimit=100&id=Required' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw ''
{
"success": true,
"requestId": "6cb84b27-6324-438c-a072-5a7251e64516",
"data": {
"id": "tdOafv42HddYGSbKf",
"status": "queued",
"type": "product",
"createdAt": "2026-09-28T15:54:52.879Z",
"statusUrl": "/v1/jobs/tdOafv42HddYGSbKf",
"resultsUrl": "/v1/jobs/tdOafv42HddYGSbKf/results"
},
"meta": {
"results": 0,
"usage": {
"searches": 0,
"productsReturned": 0,
"detailLookups": 0,
"reviewsReturned": 0,
"storeLookups": 0,
"monitorChecks": 0
},
"durationMs": 373
}
}
curl --location --request POST 'https://zylalabs.com/api/14021/aliexpress+product+data+and+research+api/33900/get+product+details' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"product": "3256812453673234",
"maxReviews": 20,
"mediaOnly": false,
"hideReviewerName": false
}'
{
"success": true,
"requestId": "6237474b-c135-491d-9357-f35042165910",
"data": {
"id": "4SBgumXYaIEdijwbl",
"status": "queued",
"type": "reviews",
"createdAt": "2026-09-28T15:59:13.147Z",
"statusUrl": "/v1/jobs/4SBgumXYaIEdijwbl",
"resultsUrl": "/v1/jobs/4SBgumXYaIEdijwbl/results"
},
"meta": {
"results": 0,
"usage": {
"searches": 0,
"productsReturned": 0,
"detailLookups": 0,
"reviewsReturned": 0,
"storeLookups": 0,
"monitorChecks": 0
},
"durationMs": 520
}
}
curl --location --request POST 'https://zylalabs.com/api/14021/aliexpress+product+data+and+research+api/33906/get+product+reviews' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"product": "REAL_PRODUCT_ID",
"maxReviews": 20,
"mediaOnly": false,
"hideReviewerName": false
}'
{
"success": true,
"requestId": "6a6f6fb5-4b0e-4e60-8cbd-8b3c2c54ebf9",
"data": {
"id": "DvKSPj7XblusEcRCC",
"status": "queued",
"type": "store_products",
"createdAt": "2026-09-28T16:00:16.606Z",
"statusUrl": "/v1/jobs/DvKSPj7XblusEcRCC",
"resultsUrl": "/v1/jobs/DvKSPj7XblusEcRCC/results"
},
"meta": {
"results": 0,
"usage": {
"searches": 0,
"productsReturned": 0,
"detailLookups": 0,
"reviewsReturned": 0,
"storeLookups": 0,
"monitorChecks": 0
},
"durationMs": 509
}
}
curl --location --request POST 'https://zylalabs.com/api/14021/aliexpress+product+data+and+research+api/33912/get+supplier+store+products' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"store": "REAL_ALIEXPRESS_STORE_URL_OR_ID",
"maxResults": 25,
"sort": "orders"
}'
{
"success": true,
"requestId": "71fc9487-7e92-49c6-a0db-6551e73df50c",
"data": {
"id": "h9QTH5ghHCRJcxrGZ",
"status": "queued",
"type": "store_products",
"createdAt": "2026-09-28T16:00:18.520Z",
"statusUrl": "/v1/jobs/h9QTH5ghHCRJcxrGZ",
"resultsUrl": "/v1/jobs/h9QTH5ghHCRJcxrGZ/results"
},
"meta": {
"results": 0,
"usage": {
"searches": 0,
"productsReturned": 0,
"detailLookups": 0,
"reviewsReturned": 0,
"storeLookups": 0,
"monitorChecks": 0
},
"durationMs": 408
}
}
curl --location --request POST 'https://zylalabs.com/api/14021/aliexpress+product+data+and+research+api/33913/get+supplier+store+products' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"store": "REAL_ALIEXPRESS_STORE_URL_OR_ID",
"maxResults": 25,
"sort": "orders"
}'
{
"success": true,
"requestId": "cf591563-f80d-4db0-8a5b-8706f6e30e8a",
"data": {
"id": "lWoaz1I7fvIYboy5r",
"status": "queued",
"type": "monitor",
"createdAt": "2026-09-28T16:01:13.827Z",
"statusUrl": "/v1/jobs/lWoaz1I7fvIYboy5r",
"resultsUrl": "/v1/jobs/lWoaz1I7fvIYboy5r/results"
},
"meta": {
"results": 0,
"usage": {
"searches": 0,
"productsReturned": 0,
"detailLookups": 0,
"reviewsReturned": 0,
"storeLookups": 0,
"monitorChecks": 0
},
"durationMs": 631
}
}
curl --location --request POST 'https://zylalabs.com/api/14021/aliexpress+product+data+and+research+api/33924/check+product+changes' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"products": ["REAL_PRODUCT_ID"],
"emitUnchanged": false
}'
{
"success": true,
"requestId": "16eb56a4-1c16-417e-aad2-c62543378e87",
"data": {
"id": "DRPoU2sgyd1RRKulM",
"status": "queued",
"type": "monitor",
"createdAt": "2026-09-28T16:01:15.337Z",
"statusUrl": "/v1/jobs/DRPoU2sgyd1RRKulM",
"resultsUrl": "/v1/jobs/DRPoU2sgyd1RRKulM/results"
},
"meta": {
"results": 0,
"usage": {
"searches": 0,
"productsReturned": 0,
"detailLookups": 0,
"reviewsReturned": 0,
"storeLookups": 0,
"monitorChecks": 0
},
"durationMs": 452
}
}
curl --location --request POST 'https://zylalabs.com/api/14021/aliexpress+product+data+and+research+api/33930/check+product+changes' --header 'Authorization: Bearer YOUR_API_KEY'
--data-raw '{
"products": ["REAL_PRODUCT_ID"],
"emitUnchanged": false
}'
注册后,每个开发者都会被分配一个个人 API 访问密钥,这是一个唯一的字母和数字组合,用于访问我们的 API 端点。要使用 AliExpress产品数据和研究 API 进行身份验证,只需在 Authorization 标头中包含您的 bearer token。
| 标头 | 描述 |
|---|---|
授权
|
必需
应为 Bearer access_key. 订阅后,请查看上方的"您的 API 访问密钥"。
|
无长期承诺。随时升级、降级或取消。 免费试用包括最多 50 个请求。
(年度计费可节省 2 个月 🎉)
每个端点返回与AliExpress产品相关的结构化数据,包括产品详细信息、评论、供应商信息和任务状态。例如,搜索产品端点返回产品ID、标题、URL和图片,而获取任务状态端点提供研究任务的当前状态
关键字段包括 `productId`、`title`、`productUrl`、`imageUrl` 和 `requestId` 用于产品搜索。对于与工作相关的端点,`jobId`、`status` 和 `results` 等字段对于跟踪工作进展和结果至关重要
响应数据以JSON格式组织,顶层结构指示成功状态和相关数据数组例如搜索产品的响应包括一个`data`数组,包含产品记录,每个记录都有详细属性
API提供多种信息类型:产品详情(标题、价格、图片)、评论(深度和内容)、供应商店铺数据(可获取的产品)和工作状态(进度和结果)。每个端点专注于特定数据方面
参数因端点而异;例如,搜索产品端点接受 `searchQuery`、`page` 和 `sortBy`。用户可以通过指定这些参数来自定义请求,以根据他们的需求优化搜索结果
数据准确性通过对Apify Actor的持续监控和更新来保持,确保信息反映来自AliExpress的最新可用数据。定期检查有助于识别差异并保持质量
典型的用例包括市场研究 竞争分析 产品采购 和监测价格变化 企业可以利用这些数据做出关于产品供应和供应商关系的明智决策
如果结果是部分或为空,用户应该检查他们的查询参数是否准确或拓宽他们的搜索条件。即使没有数据,API也可能返回成功状态,这表明搜索执行正确但没有找到匹配项