AliExpress API
Retrieve cross-border products, detailed variants, rating distributions, and buyer reviews to compare merchandise and compile consumer feedback.
Localize searches using a destination country code and display currency, though retrieving a variant does not guarantee it remains available for purchase.
Platform availability
- 24h health
- 97%
Last 30 days
Available capabilities
Each AliExpress action, what it does, its price and its health over the last 24 hours. Open an action for its parameters, response fields and code samples.
| Capability | What it does | Per 1,000 | 24-hour health |
|---|---|---|---|
Searchsearch | Browse AliExpress listings for a product keyword, comparing price with the original price, discount, orders, rating, ship-from location and seller. | $1.39 per 1,000 requestsEvery 50 rows count as one call | Healthy · health 100% |
Detailsprofile | Open an AliExpress item link and get the product's title, prices, currency, rating, units sold, shipping, store details and stock signals. | $1.39 per 1,000 requests | Normal |
Variantsvariants | List the variants and SKUs of an AliExpress product, with each option's properties, color, image and price where the listing shows them. | $1.39 per 1,000 requests | Healthy · health 97% |
Reviewsreviews | Collect buyer feedback on an AliExpress product, including star rating, country, variant bought, shipping method, helpful votes and photos. | $1.39 per 1,000 requests | Normal |
Rating summaryratings | Read the average star rating and total review count for one AliExpress product. | $1.39 per 1,000 requests | Normal |
Product detailsproduct_detail | Fetch the full AliExpress product page for one item: price and discount, units sold, rating, shipping, variants, attributes, total stock and store background. | $1.39 per 1,000 requests | Normal |
Open a capability for its parameters, response fields, code samples and trial.
What does each AliExpress action accept?
Each answer below pairs one callable action with its real inputs. Parameter meanings and allowed values are action-specific; a familiar name does not carry the same meaning across every platform.
Official sources are linked only to clarify the platform term beside them. They do not imply platform authorization or endorsement, and they do not add official-site features to the EveryInfra API contract.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Browse AliExpress listings for a product keyword, comparing price with the original price, discount, orders, rating, ship-from location and seller. Filters cover minimum price, minimum star rating and sort order; the figures describe each listing, not demand or margin. | keyword | min_price, min_rating, sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requestsEvery 50 rows count as one call | product_id · title · url · price · original_price · currency · discount · rating · rating_scale · orders_count · review_count · image_url · ships_from · seller_name · category · is_top_rated · free_shipping · images · search_rank · seller_rating · seller_url · platform · tags |
profileDetails Open an AliExpress item link and get the product's title, prices, currency, rating, units sold, shipping, store details and stock signals. Despite the name, | url | country, currency | Sync delivery | — | $1.39 per 1,000 requests | id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · images · description_images · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform |
variantsVariants List the variants and SKUs of an AliExpress product, with each option's properties, color, image and price where the listing shows them. A missing combination does not mean it is sold out, and the list is not a full stock record. | url | country, currency | Sync delivery | — | $1.39 per 1,000 requests | id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · images · description_images · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform |
reviewsReviews Collect buyer feedback on an AliExpress product, including star rating, country, variant bought, shipping method, helpful votes and photos. When | url | sort | Sync delivery | Catalog values: defaultLimit=20, maxLimit=200. A limit can control pages or per-parent expansion for some actions, so it is not always a final row count. | $1.39 per 1,000 requests | review_id · text · rating · rating_scale · posted_at · country · author · sku_info · helpful_count · logistics · product_id · is_anonymous · unhelpful_count · language · original_text · is_translated · review_labels · sku_id · platform · images |
ratingsRating summary Read the average star rating and total review count for one AliExpress product. The star-by-star breakdown and the positive, neutral and negative rates are temporarily unavailable; use | url | — | Sync delivery | — | $1.39 per 1,000 requests | average_star · total_reviews · positive_rate · neutral_rate · negative_rate · five_star · four_star · three_star · two_star · one_star · platform |
product_detailProduct details Fetch the full AliExpress product page for one item: price and discount, units sold, rating, shipping, variants, attributes, total stock and store background. | url | country, currency | Sync delivery | — | $1.39 per 1,000 requests | id · url · name · text · price · original_price · currency · discount · sold_count · rating · rating_scale · review_count · shipping · variants · store_name · store_url · image_url · images · description_images · price_max · original_price_max · sold_text · attributes · category_id · category_path · ship_to · total_stock · video_url · store_id · seller_id · store_country · store_opened_at · store_positive_rate · store_rating · store_sold_180d · store_is_top_rated · platform |
What do the AliExpress search parameters mean?
Browse AliExpress listings for a product keyword, comparing price with the original price, discount, orders, rating, ship-from location and seller. Filters cover minimum price, minimum star rating and sort order; the figures describe each listing, not demand or margin.
Full API reference: parameters, code samples, response example and health →keywordRequired- Specifies the product search query (for example, wireless earbuds) to return listing collections. Pass search keywords instead of seller IDs; access product details, variants, and reviews using item URLs.
min_priceOptional- Sets the minimum item price numeric threshold for search queries to exclude lower-priced items. This is an item price filter rather than a discount percentage or API request budget; result currencies depend on search metadata.
min_ratingOptional- Filters item searches by minimum star rating using a numeric scale from 0 to 5 (such as 4.5). This parameter evaluates overall product rating rather than review counts, positive feedback percentages, or individual review scores.
sortOptional- Sorts action results using allowed values. For search, options include relevance (default), popular, price_asc, price_desc, and top_rated (supporting legacy values default, orders, rating). For reviews, options are relevance (default) and newest, which sorts by review submission date rather than product listing date. ratings takes no sort.Allowed values:
popularprice_ascprice_descrelevancetop_rated
What do the AliExpress profile parameters mean?
Open an AliExpress item link and get the product's title, prices, currency, rating, units sold, shipping, store details and stock signals. Despite the name, profile describes the product, not a shopper's profile, and stock figures are not guaranteed inventory.
urlRequired- Specifies the target AliExpress item using a full URL (such as https://www.aliexpress.com/item/<item_id>.html). Use url with profile to fetch product metadata, variants for SKUs, reviews or ratings for feedback summaries, or product_detail (which also accepts a numeric item ID).
countryOptional- The country or region code, such as US, that profile, variants and product_detail read the product for (default US, converted to uppercase). It picks the regional view of the item; it does not change your account country or a real order's shipping address.
currencyOptional- The currency for the item prices returned by profile, variants and product_detail, such as USD (default USD, converted to uppercase). It changes displayed prices only and has nothing to do with how EveryInfra API calls are billed.
What do the AliExpress variants parameters mean?
List the variants and SKUs of an AliExpress product, with each option's properties, color, image and price where the listing shows them. A missing combination does not mean it is sold out, and the list is not a full stock record.
Full API reference: parameters, code samples, response example and health →urlRequired- Specifies the target AliExpress item using a full URL (such as https://www.aliexpress.com/item/<item_id>.html). Use url with profile to fetch product metadata, variants for SKUs, reviews or ratings for feedback summaries, or product_detail (which also accepts a numeric item ID).AliExpress: Category SKU Attributes and General Attributes — Open platform attribute lookup endpoints separate SKU attributes from general attributes under a category, providing fields such as attribute name, attribute value, and whether a field is required. This explanation serves only to clarify AliExpress variant terminology and does not indicate that this endpoint supports product listing or guarantees returning all category combinations. · Checked
countryOptional- The country or region code, such as US, that profile, variants and product_detail read the product for (default US, converted to uppercase). It picks the regional view of the item; it does not change your account country or a real order's shipping address.
currencyOptional- The currency for the item prices returned by profile, variants and product_detail, such as USD (default USD, converted to uppercase). It changes displayed prices only and has nothing to do with how EveryInfra API calls are billed.
What do the AliExpress reviews parameters mean?
Collect buyer feedback on an AliExpress product, including star rating, country, variant bought, shipping method, helpful votes and photos. When is_translated is true, text is a translation and original_text holds the reviewer's own words.
urlRequired- Specifies the target AliExpress item using a full URL (such as https://www.aliexpress.com/item/<item_id>.html). Use url with profile to fetch product metadata, variants for SKUs, reviews or ratings for feedback summaries, or product_detail (which also accepts a numeric item ID).
sortOptional- Sorts action results using allowed values. For search, options include relevance (default), popular, price_asc, price_desc, and top_rated (supporting legacy values default, orders, rating). For reviews, options are relevance (default) and newest, which sorts by review submission date rather than product listing date. ratings takes no sort.Allowed values:
newestrelevance
What do the AliExpress ratings parameters mean?
Read the average star rating and total review count for one AliExpress product. The star-by-star breakdown and the positive, neutral and negative rates are temporarily unavailable; use reviews for individual reviews.
urlRequired- Specifies the target AliExpress item using a full URL (such as https://www.aliexpress.com/item/<item_id>.html). Use url with profile to fetch product metadata, variants for SKUs, reviews or ratings for feedback summaries, or product_detail (which also accepts a numeric item ID).
What do the AliExpress product_detail parameters mean?
Fetch the full AliExpress product page for one item: price and discount, units sold, rating, shipping, variants, attributes, total stock and store background. country and currency set the regional context, and sold_text is the rounded figure shown on the page, not an exact count.
urlRequired- Specifies the target AliExpress item using a full URL (such as https://www.aliexpress.com/item/<item_id>.html). Use url with profile to fetch product metadata, variants for SKUs, reviews or ratings for feedback summaries, or product_detail (which also accepts a numeric item ID).
countryOptional- The country or region code, such as US, that profile, variants and product_detail read the product for (default US, converted to uppercase). It picks the regional view of the item; it does not change your account country or a real order's shipping address.
currencyOptional- The currency for the item prices returned by profile, variants and product_detail, such as USD (default USD, converted to uppercase). It changes displayed prices only and has nothing to do with how EveryInfra API calls are billed.
How to use the AliExpress API
- 01Read the public catalog and choose a platform action.
- 02Send the platform, action, and required parameters to POST /api/v1/social.
- 03Handle a synchronous result, or poll the returned job ID when the action runs asynchronously.
- 04Store the structured response fields needed by your application.
curl -X POST https://api.everyinfra.com/api/v1/social \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{"platform":"aliexpress","action":"search","params":{"keyword":"<keyword>"}}'
AliExpress guides
Worked examples and methods built on these actions. Check the current actions, parameters and fields on this page first; an article's examples and limits do not replace the live catalog.
Commercializing Price Scraping: Building a Price Monitoring Product Merchants Will Renew
Why merchants pay for price monitoring and why they cancel subscriptions. Examine price data delivery methods, pricing units, and pilot acceptance through product matching, exception lists, and pricing approval workflows.
Read the article →Unified Data API Getting Started: From Capability Catalog to First Available Result
Access multi-platform data using platform, action, and params: read the capability catalog, complete minimal requests, handle asynchronous tasks, partial results, and billing, and establish traceable data records.
Read the article →API Failures, Credit Returns, and Reconciliation: How to Audit the Net Charge of a Request
Separate tasks, call attempts, delivery states, and wallet events to handle pre-charge rejections, empty results, and partial credit returns without double-counting, using integer-based offline examples.
Read the article →AliExpress API questions
What can I retrieve with the AliExpress API?
Set platform to aliexpress. The current catalog lists search, details, variants, reviews, rating summary, and more. These action names identify different AliExpress objects or views; they are not interchangeable search modes.
Does AliExpress have an official API?
AliExpress Open Platform has APIs for sellers, which work only on stores that authorize your app and cover their own products and orders, for affiliates, who must first register as AliExpress Portals publishers and have their developer profile approved, and for dropshippers.
Official sources: AliExpress Open Platform: Global APIs overview · AliExpress Open Platform: affiliate quick start · Checked
Do I need a AliExpress developer account or API key?
No. Requests go through EveryInfra with an EveryInfra API key: sign up, create a key in the console and send it as Authorization: Bearer <API_KEY>. You do not register a AliExpress developer app, apply for AliExpress API access or sign in with a AliExpress account, and the actions return public AliExpress data only.
How much does the AliExpress API cost per 1,000 requests?
$1.39 per 1,000 requests, depending on the action; each action's price is listed in the table on this page and in the public catalog. There is no subscription: you top up a USD balance and pay per call, and failed calls and empty results are not charged.
Which input starts a AliExpress `search` request?
Specifies the product search query (for example, wireless earbuds) to return listing collections. Pass search keywords instead of seller IDs; access product details, variants, and reviews using item URLs. Send it as keyword inside params.
Which fields can AliExpress `search` return?
Its declared schema includes product_id, title, price, and original_price. A declared field can still be absent from an individual record, and every other action has its own field list.
Does every AliExpress action return immediately?
Actions labeled asynchronous return a job ID you poll. Every other action can also run asynchronously: add "mode": "async" to the request body to receive a job ID immediately, useful for slow tasks or large limits. The current catalog contains sync delivery.