aliexpress.com
AliExpress API
Query public AliExpress data with GeckoAPI and receive structured JSON. Choose an operation to review its inputs, credit cost and response fields.
Extracts product listing (PLP) from AliExpress by URL or keyword. Cost: 5 credits per request.
GeckoAPI is independent of AliExpress. This integration reads public data; it does not grant access to private accounts or account management operations.
Available operations
Search products
aliexpress.com:plp
Extracts product listing (PLP) from AliExpress by URL or keyword. Cost: 5 credits per request.
5 credits per request
Get product details
aliexpress.com:pdp
Returns the raw JSON of the product endpoint (PDP) of AliExpress, without field normalization. Cost: 5 credits per request.
5 credits per request
These are standard credit costs. Account-specific pricing is shown in the dashboard. Each operation has its own supported inputs and regional coverage.
Coverage and limitations
Use keyword or a search URL for discovery, then send a full product URL for details. PDP returns the raw upstream JSON rather than normalized fields. Do not pass region: this endpoint does not accept it. Use the returned currency; do not assume a currency from your own location.
Make your first request
The example uses search products. Replace YOUR_API_KEY with your server-side API key. Copy supported inputs from the reference for the operation you choose.
curl -X POST https://api.geckoapi.com.br/v1/extract \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"url": "https://pt.aliexpress.com/w/wholesale-relogio.html",
"target": "aliexpress.com",
"type": "plp",
"page": 1
}'Example JSON response
Abbreviated example from the same operation. Arrays and nested objects are shortened here; the endpoint reference includes the full documented schema. Source content retains its original language.
{
"requestId": "7a0c0e3f-7d85-4d9b-a57d-730527fb8f40",
"executionId": "6dfd2e49-e431-4375-8db1-f3b1eeefdf28",
"data": {
"source": "aliexpress.com",
"type": "plp",
"url": "https://pt.aliexpress.com/w/wholesale-relogio.html",
"requestUrl": "https://pt.aliexpress.com/w/wholesale-relogio.html",
"extractedAt": "2026-03-28T14:00:00.000Z",
"query": "relogio",
"totalResults": 123505,
"primaryResults": 60,
"page": 1,
"resultsPerPage": 60,
"offset": 0,
"nextPage": 2,
"nextPageUrl": "https://pt.aliexpress.com/w/wholesale-relogio.html?page=2",
"items": [
{
"position": 1,
"url": "https://pt.aliexpress.com/item/1005008606965599.html",
"sku": "1005008606965599",
"productId": "1005008606965599",
"name": "Novo relogio t10 ultr relogio inteligente masculino 49mm",
"currency": "BRL",
"currencyRaw": "R$",
"price": 34.99,
"regularPrice": 74.15,
"discountPercentage": 52,
"aggregateRating": {
"rating": 4.3,
"reviewCount": 0
},
"orders": 2246,
"thumbnail": "https://ae-pic-a1.aliexpress-media.com/kf/S7feedf9731414a63ac9e1e072d53d122b.jpg",
"images": [
{
"url": "https://ae-pic-a1.aliexpress-media.com/kf/S7feedf9731414a63ac9e1e072d53d122b.jpg"
}
],
"sellerName": "Loja Oficial T10",
"sellerUrl": "https://pt.aliexpress.com/store/1100000000",
"sponsored": false
}
]
}
}Integrate with REST or MCP
Call POST /v1/extract from your backend, or use the operation-specific tool on POST /v1/mcp. The API reference includes both request formats. Keep credentials in your backend and handle missing fields, pagination and errors according to that operation's rules.
Ready to test the AliExpress API?
Open the documented example in the sandbox and inspect the response before integrating it into your application.