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 Use AliExpress | 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 Use AliExpress | 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 AliExpress keeps product variants inside 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 The object handled by AliExpress | 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 Treat | 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 The object handled by AliExpress | 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?
Use AliExpress search to discover AliExpress public results. AliExpress search takes min_rating, min_price, keyword, and sort and yields discount, original_price, category, image_url, rating, ships_from, url, rating_scale, currency, orders_count, product_id, title, platform, is_top_rated, review_count, seller_name, free_shipping, and price.
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?
Use AliExpress profile to read one AliExpress public record. For AliExpress profile, url selects the AliExpress record. Pass url to AliExpress profile; returned objects expose ships_from, price, original_price, category_path, title, url, store_id, store_url, brand, store_sales, platform, seller_country, currency, store_rating, rating, price_max, store_opened_at, rating_scale, review_count, image_url, store_name, variant_count, product_id, and category_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).
What do the AliExpress variants parameters mean?
AliExpress keeps product variants inside the variants response scope. Use AliExpress variants with url; AliExpress then selects product variants. AliExpress variants reads url, with price, variant_count, platform, color_hex, product_id, properties, image_url, name, available, stock, title, url, original_price, currency, and sku_id available in its response.
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?
The object handled by AliExpress reviews is review records. Use AliExpress reviews with url; AliExpress then selects review records. Call AliExpress reviews with sort and url; AliExpress reviews exposes product_id, posted_at, logistics, country, rating_scale, sku_info, text, helpful_count, platform, review_id, author, and rating.
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?
Treat ratings as the AliExpress view for rating records. Use AliExpress ratings with url; AliExpress then selects rating records. For AliExpress ratings, supply url and sort; results include positive_rate, one_star, three_star, platform, total_reviews, count, neutral_rate, negative_rate, rate, four_star, five_star, two_star, and average_star.
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?
The object handled by AliExpress product_detail is one product record. Use AliExpress product_detail with url; AliExpress then selects one product record. AliExpress product_detail takes currency, country, and url and yields url, currency, shipping, original_price, variants, platform, text, rating_scale, discount, store_url, rating, sold_count, image_url, id, review_count, price, name, and store_name.
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.