EveryData platform API
AliExpress API
The AliExpress catalog exposes 6 action-specific paths for AliExpress products, variants, ratings, buyer reviews, and product details, beginning with `search`, `profile`, `variants` and preserving each object boundary.
The opening AliExpress path, `search`, works with matching public results using `keyword`; `profile` instead works with the selected public record using `url`, preventing cross-action assumptions.
- Endpoint
- POST /api/v1/social
- Capabilities
- 6
- Per 1,000
- $1.389
Available capabilities
Compare the AliExpress actions by required input, returned data, and price. Use the action identifier exactly as shown in your request.
| Action | Required | Optional | Delivery | Limit | Per 1,000 | Response fields |
|---|---|---|---|---|---|---|
searchSearch Search public results on AliExpress. Accepts these parameters: | 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 requests | 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 · platform |
profileProduct details Retrieve product details from AliExpress. Accepts these parameters: | url | — | Sync delivery | — | $1.39 per 1,000 requests | product_id · title · url · price · price_max · original_price · currency · rating · rating_scale · review_count · variant_count · brand · category_id · category_path · ships_from · seller_country · store_id · store_name · store_url · store_rating · store_sales · store_opened_at · image_url · platform |
variantsVariants Use the | url | — | Sync delivery | — | $1.39 per 1,000 requests | product_id · title · url · variant_count · platform · sku_id · name · properties · color_hex · image_url · price · original_price · currency · stock · available |
reviewsReviews Retrieve public reviews from AliExpress. Accepts these parameters: | 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 · platform |
ratingsRatings Use the | url | sort | 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 · count · rate |
product_detailProduct details Retrieve product details from AliExpress. Accepts these parameters: | 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 · platform |
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.
What do the AliExpress search parameters mean?
Search public results on AliExpress. Accepts these parameters: min_rating, min_price, keyword, and sort. Returns these fields: discount, original_price, category, and image_url.
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 and ratings, options are relevance (default) and newest, which sorts by review submission date rather than product listing date.
What do the AliExpress profile parameters mean?
Retrieve product details from AliExpress. Accepts these parameters: url. Returns these fields: ships_from, price, original_price, and category_path.
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 variants parameters mean?
Use the variants action on AliExpress. Accepts these parameters: url. Returns these fields: price, variant_count, color_hex, and product_id.
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 AttributesOpen 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
What do the AliExpress reviews parameters mean?
Retrieve public reviews from AliExpress. Accepts these parameters: sort and url. Returns these fields: product_id, posted_at, logistics, and country.
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 and ratings, options are relevance (default) and newest, which sorts by review submission date rather than product listing date.Allowed values:
newestrelevance
What do the AliExpress ratings parameters mean?
Use the ratings action on AliExpress. Accepts these parameters: url and sort. Returns these fields: positive_rate, one_star, three_star, and total_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).
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 and ratings, options are relevance (default) and newest, which sorts by review submission date rather than product listing date.Allowed values:
newestrelevance
What do the AliExpress product_detail parameters mean?
Retrieve product details from AliExpress. Accepts these parameters: currency, country, and url. Returns these fields: currency, shipping, original_price, and variants.
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- Specifies the target country/region code for product_detail (default US, auto-converted to uppercase). This parameter sets localized product query details without modifying account settings or shipping destination addresses.
currencyOptional- Specifies the display currency for product_detail item pricing (default USD, auto-converted to uppercase). This parameter changes product display values only and does not affect EveryInfra API call billing.
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 selected action is asynchronous.
- 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 API questions
What can I retrieve with the AliExpress API?
Set platform to aliexpress. The current catalog lists search, product details, variants, reviews, ratings, and more. These action names identify different AliExpress objects or views; they are not interchangeable search modes.
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 source record, and every other action has its own field list.
Does every AliExpress action return immediately?
No assumption is needed: this page labels each action's delivery mode. The current catalog contains sync delivery; poll a returned job ID only for an action labeled asynchronous.