Piloterr

AliExpress Store Product

GET
/v2/aliexpress/store/product

AliExpress Store Product API: list products from an AliExpress seller store by URL or store ID. Returns store metadata and product cards (~40 SSR items) as JSON via browser rendering. Pagination is not supported.

Credit cost: 2 credits per call

Autorização

ApiKeyAuth
x-api-key<token>

Your API key. Include it in the x-api-key header for every request.

In: header

Parâmetros de consulta

query*string

AliExpress store URL or numeric store ID.

Example (store URL):

https://www.aliexpress.com/store/1101705614

Example (all-items page URL):

https://www.aliexpress.com/store/1101705614/pages/all-items.html

Example (store ID only):

1101705614

Notes:

  • Pass a /store/{id} URL, an all-items page URL, or the numeric store ID.
  • Search URLs and product URLs are rejected (400).
  • Returns up to ~40 store products from the SSR all-items page (AliExpress store pagination is JavaScript-only and is not supported).
  • Use each result listing_url with AliExpress Product for full PDP data.
sort?string

Optional sort alias for the store all-items page.

Accepted values: default, bestmatch, orders, new, price

Maps to AliExpress shop_sortType query params (e.g. ordersorders_sort).

return_page_source?boolean

When true, return the raw HTML page source as {"result": "..."} instead of structured JSON. Defaults to false.

Corpo da resposta

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v2/aliexpress/store/product?query=string"
{  "results": [    {      "price": 0.99,      "title": "Car Phone Holder Magnetic Dashboard Mount",      "rating": 4.8,      "currency": "USD",      "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/Sexample1.jpg",      "product_id": "3256802427534863",      "sold_count": 1200,      "listing_url": "https://www.aliexpress.com/item/3256802427534863.html"    },    {      "price": 8.39,      "title": "Universal Car Air Vent Phone Mount Stand",      "rating": 4.5,      "currency": "USD",      "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/Sexample2.jpg",      "product_id": "1005008808856805",      "sold_count": 800,      "listing_url": "https://www.aliexpress.com/item/1005008808856805.html"    }  ],  "store_id": "1101705614",  "seller_id": "911768809",  "store_name": "Nunua Car Car Store",  "owner_member_id": "251242175"}
{  "error": "Bad Request"}
{  "error": "Invalid API Key"}
{  "error": "Payment required"}
{  "error": "Rate limit exceeded for the API key: quota monthly"}
{  "error": "Internal Error"}