Skip to content

AliExpress

AliExpress marketplace product data, including seller offers. Delivered via partner data feeds in kwery's standard normalized shape.

Rolling out. AliExpress is onboarding now and is not yet enabled by default on new accounts. Contact us to be enabled as it goes live — the API shape documented on this page is final and will not change.

Supported countries

country accepts: us

AliExpress is a global marketplace served from a single storefront; us selects the US-facing catalogue and USD pricing.

Keys

KeyValuesDescription
termFree textKeyword search.
idAliExpress product IDDirect product lookup.

Topics

TopicDescription
search (default)Product page, including the lead offer.
search_and_offersAlso fetches the seller/variant offer list.

Response

Returns the standard normalized content object (see Sources overview): name, url, currency, price_min / price_avg / price_max, offers_count, offers[], review_rating / review_count. With topic: search_and_offers, offers[] lists each seller / variant offer (price, currency, shipping).

Example request

curl -s https://api.kwery.co/job \
  -H "Authorization: Bearer $KWERY_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"source":"aliexpress","country":"us","key":"term","topic":"search_and_offers","values":["wireless earbuds"]}'

Example response

Results are fetched with GET /job/{id}/download once the job is finished — each entry is the result for one input value (abridged):

[
  {
    "key": "wireless earbuds",
    "success": true,
    "reason": null,
    "content": {
      "name": "Wireless Earbuds Bluetooth 5.3",
      "url": "https://www.aliexpress.us/item/1234567890.html",
      "currency": "USD",
      "price_min": 14.99,
      "price_avg": 18.50,
      "price_max": 22.99,
      "offers_count": 2,
      "offers": [
        { "price": 14.99, "currency": "USD", "shipping": 0 },
        { "price": 22.99, "currency": "USD", "shipping": 2.50 }
      ],
      "review_rating": 4.3,
      "review_count": 5210
    }
  }
]