AliExpress Search API

GET   /api/v1/search?engine=aliexpress_search

The AliExpress Search API returns AliExpress products for a search, up to 60 per page, for the country they ship to, in its currency and language. Each product carries its price, original price and discount, rating, number of orders, the country it ships from, a delivery estimate, its badges, category ids and images, and whether it is an ad, an AliExpress Choice product, shows a free shipping badge or shows a new-shopper price. Sort by best match, best sellers or price, filter by price, free shipping, Choice, ships-from country or the attributes AliExpress lists in filters, and page through up to 60 pages. When AliExpress translates or corrects the search terms, search_information.translated_query names the terms it searched.

API Parameters

Search Query

  • Name
    q
    Required
    Required
    Description

    Parameter defines the search terms, such as phone case or wireless earbuds, up to 200 characters.

Localization

  • Name
    delivery_country
    Required
    Optional
    Description

    Parameter defines the country the products ship to, as a two-letter country code such as US, DE or BR. It sets the products, prices and delivery estimates for that country, and the currency and language AliExpress uses there unless currency or language is given. It defaults to US. China, Russia and Belarus are not supported.

  • Name
    currency
    Required
    Optional
    Description

    Parameter defines the currency of the prices, as a three-letter currency code such as USD, EUR, GBP or BRL. 83 currencies are supported.

  • Name
    language
    Required
    Optional
    Description

    Parameter defines the language of titles, badges and filters. It can be set to ar_MA, de_DE, en_US, es_ES, fr_FR, he_IL, id_ID, it_IT, ja_JP, ko_KR, nl_NL, pl_PL, pt_BR, th_TH, tr_TR or uk_UA.

Sorting

  • Name
    sort_by
    Required
    Optional
    Description

    Parameter defines the order of the products. It can be set to best_match, best_seller, price_low_to_high or price_high_to_low, and defaults to best_match.

Filters

  • Name
    price_min
    Required
    Optional
    Description

    Parameter defines the lowest price, in the currency of the results.

  • Name
    price_max
    Required
    Optional
    Description

    Parameter defines the highest price, in the currency of the results. It must be at least price_min.

  • Name
    is_free_shipping
    Required
    Optional
    Description

    Parameter keeps only the products with free shipping when set to true.

  • Name
    is_choice
    Required
    Optional
    Description

    Parameter keeps only AliExpress Choice products when set to true.

  • Name
    ships_from
    Required
    Optional
    Description

    Parameter keeps only the products shipping from a country, given as the value of an option in the ships_from filter, such as US.

  • Name
    attribute_ids
    Required
    Optional
    Description

    Parameter filters on product attributes such as brand, color or material, as a comma-separated list of up to 20 option values from the attribute_ids filters, such as 3079-4148343 or 3079-4148343,3203-4163876.

Pagination

  • Name
    page
    Required
    Optional
    Description

    Parameter defines the page of results, with up to 60 products per page, from 1 to 60. It defaults to 1, and pagination.next is the next page while there is one.

Engine

  • Name
    engine
    Required
    Required
    Description

    Parameter defines an engine that will be used to retrieve real-time data. It must be set to aliexpress_search.

API key

  • Name
    api_key
    Required
    Required
    Description

    The api_key authenticates your requests. Use it as a query parameter (https://www.searchapi.io/api/v1/search?api_key=YOUR_API_KEY) or in the Authorization header (Bearer YOUR_API_KEY).

Zero Data Retention

  • Name
    zero_retention
    Enterprise Only
    Enterprise Only
    Required
    Optional
    Description

    Set this parameter to true to disable all logging and persistent storage. No request parameters, HTML, or JSON responses are stored or logged. Suitable for high-compliance use cases. Debugging and support may be limited while enabled.

API Examples

Full Response

Full Response
GET
https://www.searchapi.io/api/v1/search?engine=aliexpress_search&q=phone+case
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "aliexpress_search",
  "q": "phone case"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_GgYj5VxWDGhNFpsusHJsZt2L",
    "status": "Success",
    "created_at": "2026-11-13T12:31:12Z",
    "request_time_taken": 2.39,
    "parsing_time_taken": 0.02,
    "total_time_taken": 2.4,
    "request_url": "https://www.aliexpress.com/w/wholesale-phone-case.html",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_GgYj5VxWDGhNFpsusHJsZt2L.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_GgYj5VxWDGhNFpsusHJsZt2L"
  },
  "search_parameters": {
    "engine": "aliexpress_search",
    "q": "phone case"
  },
  "search_information": {
    "total_results": 100586,
    "currency": "USD"
  },
  "organic_results": [
    {
      "position": 1,
      "product_id": "3256807637171608",
      "title": "Luxury Transparent Case For iPhone 16 15 11 12 13 14 Pro Max Soft TPU Silicone For iPhone XR XS Max 8 Plus Back Cover Clear Case",
      "link": "https://www.aliexpress.us/item/3256807637171608.html",
      "price": "US $0.33",
      "extracted_price": 0.33,
      "original_price": "US $2.95",
      "extracted_original_price": 2.95,
      "discount": 88,
      "rating": 4.9,
      "sold": "50,000+ sold",
      "extracted_sold": 63427,
      "ships_from": "CN",
      "delivery": {
        "min_days": 7,
        "max_days": 12,
        "from_date": "2026-11-20",
        "to_date": "2026-11-25"
      },
      "badges": [
        "Save $2.62",
        "Fastest delivery in 7 days"
      ],
      "sku_id": "12000042335817323",
      "category_ids": [
        "202192403",
        "202228401",
        "380230"
      ],
      "listed_date": "2024-09-29",
      "thumbnail": "https://ae-pic-a1.aliexpress-media.com/kf/Sba03fd9e2b8d40aea726e1a6bdd0f922i.jpg",
      "images": [
        "https://ae-pic-a1.aliexpress-media.com/kf/Sba03fd9e2b8d40aea726e1a6bdd0f922i.jpg",
        "..."
      ],
      "is_sponsored": false,
      "is_choice": true,
      "has_free_shipping_badge": false,
      "is_new_shopper_price": false
    },
    "..."
  ],
  "filters": [
    {
      "name": "Compatible-Phone Models",
      "parameter": "attribute_ids",
      "options": [
        {
          "name": "iPhone 15",
          "value": "11745-4352280",
          "is_selected": false
        },
        "..."
      ]
    },
    "..."
  ],
  "pagination": {
    "current": 1,
    "next": 2
  }
}

White Earbuds, Cheapest First

White Earbuds, Cheapest First
GET
https://www.searchapi.io/api/v1/search?attribute_ids=3079-4148343&engine=aliexpress_search&q=wireless+earbuds&sort_by=price_low_to_high
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "aliexpress_search",
  "q": "wireless earbuds",
  "attribute_ids": "3079-4148343",
  "sort_by": "price_low_to_high"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_cxn5GmbsyUyXkQUiBGLLj9rO",
    "status": "Success",
    "created_at": "2026-11-13T12:32:18Z",
    "request_time_taken": 2.58,
    "parsing_time_taken": 0.02,
    "total_time_taken": 2.6,
    "request_url": "https://www.aliexpress.com/w/wholesale-wireless-earbuds.html?sortType=price_asc&attr=3079-4148343",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_cxn5GmbsyUyXkQUiBGLLj9rO.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_cxn5GmbsyUyXkQUiBGLLj9rO"
  },
  "search_parameters": {
    "engine": "aliexpress_search",
    "q": "wireless earbuds",
    "sort_by": "price_low_to_high",
    "attribute_ids": "3079-4148343"
  },
  "search_information": {
    "total_results": 2370,
    "currency": "USD"
  },
  "organic_results": [
    {
      "position": 1,
      "product_id": "3256812503886599",
      "title": "T2 Tws Wireless Bluetooth Headset Transparent Headphones ENC Power Digital Display Stereo Sound Earphones for All Smartphones",
      "link": "https://www.aliexpress.us/item/3256812503886599.html",
      "price": "US $0.33",
      "extracted_price": 0.33,
      "discount": 95,
      "rating": 3.7,
      "sold": "620 sold",
      "extracted_sold": 620,
      "ships_from": "CN",
      "delivery": {
        "min_days": 7,
        "max_days": 12,
        "from_date": "2026-11-20",
        "to_date": "2026-11-25"
      },
      "badges": [
        "Fastest delivery in 7 days",
        "Save $7.71"
      ],
      "sku_id": "12000059065807500",
      "category_ids": [
        "44",
        "100000306",
        "63705"
      ],
      "listed_date": "2026-07-09",
      "thumbnail": "https://ae-pic-a1.aliexpress-media.com/kf/Sf52a0006bc6142dc858e9c67f465ca66s.jpg",
      "images": [
        "https://ae-pic-a1.aliexpress-media.com/kf/Sf52a0006bc6142dc858e9c67f465ca66s.jpg",
        "..."
      ],
      "is_sponsored": false,
      "is_choice": true,
      "has_free_shipping_badge": false,
      "is_new_shopper_price": false
    },
    "..."
  ],
  "filters": [
    {
      "name": "Main color",
      "parameter": "attribute_ids",
      "options": [
        {
          "name": "White",
          "value": "3079-4148343",
          "is_selected": true
        },
        "..."
      ]
    },
    "..."
  ]
}

Shipping to Germany in Euros and German

Shipping to Germany in Euros and German
GET
https://www.searchapi.io/api/v1/search?currency=EUR&delivery_country=DE&engine=aliexpress_search&language=de_DE&q=gaming+mouse
Request
import requests

url = "https://www.searchapi.io/api/v1/search"
params = {
  "engine": "aliexpress_search",
  "q": "gaming mouse",
  "delivery_country": "DE",
  "currency": "EUR",
  "language": "de_DE"
}

response = requests.get(url, params=params)
print(response.text)
Response
{
  "search_metadata": {
    "id": "search_6lJ8zpkGDZcN4RA5AGFXvgcn",
    "status": "Success",
    "created_at": "2026-11-13T12:31:20Z",
    "request_time_taken": 1.9,
    "parsing_time_taken": 0.03,
    "total_time_taken": 1.93,
    "request_url": "https://www.aliexpress.com/w/wholesale-gaming-mouse.html",
    "html_url": "https://www.searchapi.io/api/v1/searches/search_6lJ8zpkGDZcN4RA5AGFXvgcn.html",
    "json_url": "https://www.searchapi.io/api/v1/searches/search_6lJ8zpkGDZcN4RA5AGFXvgcn"
  },
  "search_parameters": {
    "engine": "aliexpress_search",
    "q": "gaming mouse",
    "delivery_country": "DE",
    "currency": "EUR",
    "language": "de_DE"
  },
  "search_information": {
    "total_results": 48601,
    "currency": "EUR"
  },
  "organic_results": [
    {
      "position": 1,
      "product_id": "1005012841955659",
      "title": "AJAZZ AJ159 APEX Esports Gaming-Maus, PAW3950, Kabellos 8K, Leichtgewichtig, Tri-Mode, für Kleine bis Mittelgroße Hände, mit Ladefunktion",
      "link": "https://de.aliexpress.com/item/1005012841955659.html",
      "price": "€ 62,69",
      "extracted_price": 62.69,
      "discount": 14,
      "rating": 4.9,
      "sold": "580 verkauft",
      "extracted_sold": 580,
      "ships_from": "PL",
      "delivery": {
        "min_days": 2,
        "max_days": 7,
        "from_date": "2026-11-15",
        "to_date": "2026-11-20"
      },
      "badges": [
        "Zustellung: Um Nov 15 - 20",
        "Kostenloser Versand",
        "Keine Einfuhrkosten",
        "2,4 GHz kabellos | Bluetooth | Gaming | Akku",
        "Niedrigster Preis seit 30 Tagen: 73,45€",
        "10,76€ sparen",
        "Toller Preis im letzten Monat"
      ],
      "sku_id": "12000059486359850",
      "category_ids": [
        "7",
        "200001081",
        "200001082",
        "70805"
      ],
      "listed_date": "2026-07-30",
      "thumbnail": "https://ae-pic-a1.aliexpress-media.com/kf/Sc32e8e05b57f4a7cbc9d3bfad7c90cc2h.jpg",
      "is_sponsored": false,
      "is_choice": false,
      "has_free_shipping_badge": true,
      "is_new_shopper_price": false
    },
    "..."
  ]
}