AliExpress

Search AliExpress products

Returns one page (up to 60 products) of public keyword search results with product ids, titles, links, images, prices, ratings, sold text, discount, SKU id, ship-from country, and store name when AliExpress lists them. Results can be sorted and filtered by price, free shipping, the Choice program, and product attributes; list the attribute values for a keyword with the search-filters endpoint. The search uses the anonymous US English/USD locale. Product-detail pages are currently unavailable through the supported HTTP profiles.

get/aliexpress/search

Request

  • Base URL: https://api.crawlora.net/api/v1
  • URL: https://api.crawlora.net/api/v1/aliexpress/search
  • Auth: API key in header x-api-key

Query parameters

qstring required

Free-text search keywords

pageinteger

1-indexed result page (1-200), defaults to 1

sort'best_match' | 'orders' | 'price_asc' | 'price_desc'

Sort order. Allowed values: best_match (default), orders, price_asc, price_desc

min_pricenumber

Minimum price in USD (0-1000000)

max_pricenumber

Maximum price in USD (0-1000000), not below min_price

free_shippingboolean

Only free-shipping products

choiceboolean

Only products in AliExpress's Choice program

attrstring

Attribute filter <attributeId>-<valueId>, from the search-filters endpoint for the same q; comma-separate up to 5 values, one per attribute group

Headers

x-api-keystring required

API key required

Response

OK

codeinteger
msgstring

Example response

{
  "code": 200,
  "data": {
    "count": 60,
    "filters": {
      "attr": [
        "3079-4148335"
      ],
      "max_price": 30,
      "min_price": 20,
      "sort": "price_asc"
    },
    "page": 1,
    "page_size": 60,
    "products": [
      {
        "currency_code": "USD",
        "discount_percent": 72,
        "image_url": "https://ae-pic-a1.aliexpress-media.com/kf/example.jpg",
        "original_price": 18.33,
        "price": 2.18,
        "product_id": "3256812072210872",
        "rating": 4.9,
        "ship_from": "US",
        "sku_id": "12000056622341651",
        "sold_text": "3,000+ sold",
        "store_name": "PinZhen Store",
        "title": "Wireless Bluetooth Earbuds",
        "url": "https://www.aliexpress.com/item/3256812072210872.html"
      }
    ],
    "query": "wireless earbuds",
    "total_pages": 282,
    "total_results": 16912
  },
  "msg": "OK"
}

Changes

No recorded changes to this operation across all 2 revisions of this API.