# Real-Time AliExpress Data - AliExpress Products, Reviews, Shipping, Stores & Deals Data

> Fast and reliable AliExpress data API - search products, get product details, reviews, shipping options to any country, categories, image search, store info and listings, hot products and SuperDeals in real-time.

## Overview

Real-Time AliExpress Data is a fast and reliable API for AliExpress data in real-time. It returns structured JSON via REST.

Who is this API for: developers building dropshipping and product research tools, price monitoring, competitor and supplier analysis, and review analytics.

What it returns: product search results with prices, discounts, ratings and sales; product details; customer reviews with photos and translations; every delivery option to a country with carrier, price and delivery estimates; the category tree; image search results; store profiles and store listings; hot products and SuperDeals.

Need help integrating? Contact support@openwebninja.com.
For high volume / large scale plans, please contact support@openwebninja.com.

## Endpoints

### GET /search - Search
Search AliExpress products by keyword or category, with price, shipping-origin, free-shipping, Choice and sort filters.
Parameters:
- **query** (string, required): What to search for.
- page (integer, default: `1`): Results page, 60 products each. AliExpress serves 60 pages.
- sort_by (string, default: `relevance`, allowed: relevance | best_sellers | lowest_price | highest_price): Result order.
- min_price (number): Lowest price, in the response currency.
- max_price (number): Highest price, in the response currency.
- category_id (string): AliExpress catalog category id(s) to search within, comma-separated: the category_id search rows and the search_category_ids of /categories carry.
- ship_from (string): Two-letter code of the country the products must ship from (e.g. US for US warehouses).
- free_shipping (string, default: `false`, allowed: false | true): Only products with free shipping.
- choice_only (string, default: `false`, allowed: false | true): Only products in AliExpress's Choice programme.
- country (string, default: `US`): Two-letter code of the country to ship to; prices and availability follow it.
- currency (string, default: `USD`, allowed: USD | EUR | GBP | CAD | AUD | NZD | BRL | MXN | ARS | CLP | COP | PEN | JPY | KRW | CNY | HKD | TWD | SGD | MYR | THB | PHP | IDR | VND | INR | PKR | BDT | KZT | PLN | CHF | SEK | NOK | DKK | CZK | HUF | RON | BGN | UAH | RUB | TRY | ILS | SAR | AED | QAR | KWD | EGP | MAD | NGN | ZAR): Three-letter currency code for the prices.
- language (string, default: `en`, allowed: en | ar | de | es | fr | he | it | ja | ko | nl | pl | pt | ru | th | tr | uk): Language of the titles.
Full URL: `https://api.openwebninja.com/realtime-aliexpress-data/search`

### GET /product-details - Product Details
Get the full details of an AliExpress product: title, photos, prices and discounts, variants, specifications, rating and review counts, sales, and the store selling it.
Parameters:
- **product_id** (string, required): AliExpress product id (either the 1005… or the 3256… form search returns) or the product URL.
Full URL: `https://api.openwebninja.com/realtime-aliexpress-data/product-details`

### GET /product-reviews - Product Reviews
Get the customer reviews of an AliExpress product, with rating, text and its English translation, photos, reviewer country and the variant bought, plus the rating breakdown.
Parameters:
- **product_id** (string, required): AliExpress product id (either the 1005… or the 3256… form search returns) or the product URL.
- page (integer, default: `1`): Reviews page.
- page_size (integer, default: `20`): Reviews per page, up to 100. **Default:** `20`
- star_rating (string, default: `all`, allowed: all | 5_stars | 4_stars | 3_stars | 2_stars | 1_star): Only reviews with this many stars.
- with_photos (string, default: `false`, allowed: false | true): Only reviews with photos. Cannot be combined with star_rating.
- country (string, default: `US`): Two-letter country code; AliExpress lists reviews from that country's buyers first.
- language (string, default: `en`, allowed: en | ar | de | es | fr | he | it | ja | ko | nl | pl | pt | ru | th | tr | uk): Language the reviews are translated into, and the dates written in.
Full URL: `https://api.openwebninja.com/realtime-aliexpress-data/product-reviews`

### GET /shipping-options - Shipping Options
Get every delivery option AliExpress offers for a product to a country: carrier, shipping price, free-shipping threshold, delivery days and estimated dates, tracking, and where it ships from.
Parameters:
- **product_id** (string, required): AliExpress product id, as returned by Search, or the product URL. **Examples:** `1005007272286071` `https://www.aliexpress.com/item/1005007272286071.html`
- country (string, default: `US`): Two-letter code of the country to deliver to. **Default:** `US`
- currency (string, default: `USD`, allowed: USD | EUR | GBP | CAD | AUD | NZD | BRL | MXN | ARS | CLP | COP | PEN | JPY | KRW | CNY | HKD | TWD | SGD | MYR | THB | PHP | IDR | VND | INR | PKR | BDT | KZT | PLN | CHF | SEK | NOK | DKK | CZK | HUF | RON | BGN | UAH | RUB | TRY | ILS | SAR | AED | QAR | KWD | EGP | MAD | NGN | ZAR): Three-letter code of the currency to price shipping in. **Default:** `USD`
- quantity (integer, default: `1`): Number of units to ship. Some delivery options change with quantity. **Default:** `1`
Full URL: `https://api.openwebninja.com/realtime-aliexpress-data/shipping-options`

### GET /categories - Categories
Get AliExpress's category tree: every top-level category and its subcategories, with the ids Search and Hot Products accept.
Parameters:
- category_id (string): List this category's subcategories: a category_id from this endpoint (level 1 or 2) or a level-1 platform_category_id. Omit for the top level.
- country (string, default: `US`): Two-letter country code; the menu differs per market.
- language (string, default: `en`, allowed: en | ar | de | es | fr | he | it | ja | ko | nl | pl | pt | ru | th | tr | uk): Language of the category names.
Full URL: `https://api.openwebninja.com/realtime-aliexpress-data/categories`

### GET /image-search - Image Search
Find AliExpress products that look like an image.
Parameters:
- **image_url** (string, required): The picture to search with: any public http(s) image URL (JPEG, PNG, WebP or BMP).
- page (integer, default: `1`): Results page, 60 products each. AliExpress serves 5 pages.
- sort_by (string, default: `relevance`, allowed: relevance | best_sellers | lowest_price | highest_price): Result order.
- country (string, default: `US`): Two-letter code of the country to ship to; prices and availability follow it.
- currency (string, default: `USD`, allowed: USD | EUR | GBP | CAD | AUD | NZD | BRL | MXN | ARS | CLP | COP | PEN | JPY | KRW | CNY | HKD | TWD | SGD | MYR | THB | PHP | IDR | VND | INR | PKR | BDT | KZT | PLN | CHF | SEK | NOK | DKK | CZK | HUF | RON | BGN | UAH | RUB | TRY | ILS | SAR | AED | QAR | KWD | EGP | MAD | NGN | ZAR): Three-letter currency code for the prices.
Full URL: `https://api.openwebninja.com/realtime-aliexpress-data/image-search`

### GET /store-details - Store Details
Get the profile of an AliExpress store: name, seller, logo, rating and feedback scores, followers, opening date, location, Top Brand and vacation status.
Parameters:
- **store_id** (string, required): AliExpress store id, or the store URL (e.g. https://www.aliexpress.com/store/2343184).
Full URL: `https://api.openwebninja.com/realtime-aliexpress-data/store-details`

### GET /store-products - Store Products
List the products an AliExpress store sells to a country, 40 per page, with prices, discounts, ratings and sales.
Parameters:
- **store_id** (string, required): AliExpress store id, or the store URL (e.g. https://www.aliexpress.com/store/2343184).
- page (integer, default: `1`): Page of the store list, 40 products per page.
- country (string, default: `US`): Two-letter code of the shopper's country: AliExpress lists only what the store ships there.
- currency (string, default: `USD`, allowed: USD | EUR | GBP | CAD | AUD | NZD | BRL | MXN | ARS | CLP | COP | PEN | JPY | KRW | CNY | HKD | TWD | SGD | MYR | THB | PHP | IDR | VND | INR | PKR | BDT | KZT | PLN | CHF | SEK | NOK | DKK | CZK | HUF | RON | BGN | UAH | RUB | TRY | ILS | SAR | AED | QAR | KWD | EGP | MAD | NGN | ZAR): Three-letter currency code for the prices.
Full URL: `https://api.openwebninja.com/realtime-aliexpress-data/store-products`

### GET /hot-products - Hot Products
Get AliExpress's hot products feed for all categories or one top-level category, with prices, discounts, ratings and sales, per shopper country and currency.
Parameters:
- country (string, default: `US`): Two-letter code of the shopper's country. AliExpress lists different products per country.
- currency (string, default: `USD`, allowed: USD | EUR | GBP | CAD | AUD | NZD | BRL | MXN | ARS | CLP | COP | PEN | JPY | KRW | CNY | HKD | TWD | SGD | MYR | THB | PHP | IDR | VND | INR | PKR | BDT | KZT | PLN | CHF | SEK | NOK | DKK | CZK | HUF | RON | BGN | UAH | RUB | TRY | ILS | SAR | AED | QAR | KWD | EGP | MAD | NGN | ZAR): Three-letter currency code the prices are given in.
- language (string, default: `en`, allowed: en | ar | de | es | fr | he | it | ja | ko | nl | pl | pt | ru | th | tr | uk): Two-letter language code for the product titles.
- page (integer): Page number (24 products a page, up to 10); defaults to 1. To read on past a page, prefer the cursor it returned: it answers faster and has no page limit.
- cursor (string): The cursor a previous answer returned, for the page after it. Send the same country, currency, language and category as that call, and no page.
- category_id (string): List only one top-level category's hot products: a level-1 category_id or platform_category_id from the categories endpoint (electronics, 10536), or AliExpress's catalog id of a top-level category (44). Omit for all categories. A category with no hot products list is refused with the ids that have one.
Full URL: `https://api.openwebninja.com/realtime-aliexpress-data/hot-products`

### GET /deals - Deals
Get AliExpress's SuperDeals or Bundle Deals feed, with the deal price, original price, discount, rating and sales of each product.
Parameters:
- country (string, default: `US`): Two-letter code of the shopper's country. AliExpress lists different products per country.
- currency (string, default: `USD`, allowed: USD | EUR | GBP | CAD | AUD | NZD | BRL | MXN | ARS | CLP | COP | PEN | JPY | KRW | CNY | HKD | TWD | SGD | MYR | THB | PHP | IDR | VND | INR | PKR | BDT | KZT | PLN | CHF | SEK | NOK | DKK | CZK | HUF | RON | BGN | UAH | RUB | TRY | ILS | SAR | AED | QAR | KWD | EGP | MAD | NGN | ZAR): Three-letter currency code the prices are given in.
- language (string, default: `en`, allowed: en | ar | de | es | fr | he | it | ja | ko | nl | pl | pt | ru | th | tr | uk): Two-letter language code for the product titles.
- page (integer): Page number (24 products a page, up to 10); defaults to 1. To read on past a page, prefer the cursor it returned: it answers faster and has no page limit.
- cursor (string): The cursor a previous answer returned, for the page after it. Send the same country, currency, language and category as that call, and no page.
- deal_type (string, default: `superdeals`, allowed: superdeals | bundle_deals): Which promotion to list: superdeals (SuperDeals, limited-time prices) or bundle_deals (Bundle Deals, prices when bought together).
Full URL: `https://api.openwebninja.com/realtime-aliexpress-data/deals`

## Base URL and Authentication

- Base URL: `https://api.openwebninja.com/realtime-aliexpress-data`
- Auth: API key in the `x-api-key` header. Get a key by subscribing (free tier available) at https://app.openwebninja.com/api/realtime-aliexpress-data

## Topics

aliexpress api, aliexpress product api, aliexpress search api, aliexpress reviews api, aliexpress shipping api, aliexpress scraper api, dropshipping api, aliexpress store api, aliexpress deals api, ecommerce data api

## Links

- API page: https://www.openwebninja.com/api/real-time-aliexpress-data
- Get an API key / subscribe: https://app.openwebninja.com/api/realtime-aliexpress-data
- Pricing & plans: https://app.openwebninja.com/api/realtime-aliexpress-data/pricing
- Website: https://www.openwebninja.com
- OpenAPI spec: https://openwebninja.s3.us-east-1.amazonaws.com/portal/openapi/realtime_aliexpress_data.yaml
- Support: support@openwebninja.com

_Last updated: 2026-10-26_