Aliexpress Product Search

Aliexpress Product Search Actor Documentation

Description

Search for products on Aliexpress based on a query and return product details, including pricing, images, store information, and more.

---

Request Parameters

Parameter	Type	Required	Description
query	string	Yes	The search query (e.g., "winter hats").
page	number	Yes	The page number for pagination.

---

Request Example

1{
2  "query": "winter hats",
3  "page": 1
4}

---

Response Format

Field	Type	Description
image	object	Contains image details (imgUrl, imgWidth, imgHeight).
itemType	string	Type of item (e.g., productV3).
productId	string	Unique ID of the product.
store	object	Contains store details (storeUrl, storeName, storeId).
title	object	Product titles (displayTitle, seoTitle).
evaluation	object	Product ratings (starRating, starUrl).
productDetailUrl	string	URL to the product details page.
prices	object	Contains pricing details (originalPrice, salePrice, currencyCode).
sellingPoints	array	List of special selling points for the product.
trade	object	Contains sales description (e.g., "4000+ sold").

---

Response Example

1{
2  "data": {
3    "content": [
4      {
5        "image": {
6          "imgUrl": "//ae-pic-a1.aliexpress-media.com/kf/Sc67b0ccaab7f421eb0151ef924e2be31b/Unisex-WY-Letter-Embroidery-Beanies-Autumn-Winter-Warm-Hat-Hip-Caps-for-Women-Men.jpg_350x350xz.jpg",
7          "imgWidth": 350,
8          "imgHeight": 350
9        },
10        "itemType": "productV3",
11        "productId": "3256806325802948",
12        "store": {
13          "storeUrl": "//www.aliexpress.com/store/1103847754",
14          "storeName": "Shop1103840755 Store",
15          "storeId": 1103847754
16        },
17        "title": {
18          "displayTitle": "Unisex WY Letter Embroidery Beanies Autumn Winter Warm Hat Hip Caps for Women Men",
19          "seoTitle": "Unisex WY Letter Embroidery Beanies Autumn Winter Warm Hat Hip Caps for Women Men"
20        },
21        "evaluation": {
22          "starUrl": "https://ae01.alicdn.com/kf/S567d6bf538214abf95c1e5825c7e6a05t/48x48.png",
23          "starRating": 4.7
24        },
25        "productDetailUrl": "https://www.aliexpress.com/gcp/300000512/nnmixupdatev3?productIds=1005006512117700&pha_manifest=ssr&_immersiveMode=true",
26        "prices": {
27          "originalPrice": {
28            "formattedPrice": "US $5.71",
29            "minPrice": 5.71
30          },
31          "salePrice": {
32            "formattedPrice": "US $0.33",
33            "minPrice": 0.33,
34            "discount": 94
35          },
36          "currencyCode": "USD"
37        },
38        "sellingPoints": [
39          {
40            "tagContent": {
41              "tagText": "Free shipping"
42            },
43            "source": "platformFreeShipping_no_threshold_freeReturn_atm"
44          }
45        ],
46        "trade": {
47          "tradeDesc": "4000+ sold"
48        }
49      },
50      // others products...
51    ]
52  }
53}

---

Frequently Asked Questions (FAQs)

1. What is the Aliexpress Product Search API? The Aliexpress Product Search API allows developers to fetch detailed product information from Aliexpress using a query and page parameters.

2. What type of data can I retrieve with this API? You can retrieve product details such as titles, images, pricing, store information, ratings, and more.

3. Is the API response in real-time? Yes, the API fetches data in real-time, ensuring accurate and up-to-date product information.

4. How can I use the query parameter effectively? Use relevant and specific keywords in the query parameter to ensure precise search results, such as "smartphone accessories" or "winter jackets."

5. What is the page parameter used for? The page parameter is used for pagination. Start with page 1 and increment the value to fetch subsequent product listings.

6. Are the image URLs in the API response ready for use? No, the image URLs are relative. You need to prepend them with https: to access them directly.

7. Can I filter results based on price or rating? The current API does not support direct filtering, but you can implement custom filtering logic on the client side using the data in the response.

8. How many products can I fetch in one API call? The number of products per call depends on Aliexpress's internal logic for results per page. Typically, it ranges between 20 and 50 products.

9. Is there a rate limit for the API? Rate limits depend on your API subscription plan. Check your account or documentation for specific limitations.

10. Does the API support multiple languages? Currently, the API fetches data in English. You can translate results on the client side if needed.

11. How are the product ratings represented? Ratings are shown as a numerical value (e.g., 4.7) alongside an image URL for visual representation (stars).

12. Can I use this API for building an ecommerce application? Absolutely! This API is perfect for building ecommerce applications that need to integrate Aliexpress product listings seamlessly.

Discover Millions of Products with the Aliexpress Product Search API

The Aliexpress Product Search API is your gateway to exploring millions of products across various categories. Whether you’re building an ecommerce app, integrating product data into your website, or analyzing market trends, this API provides real-time product details with ease.

With robust features such as detailed product descriptions, high-resolution images, accurate pricing, and ratings, this API empowers developers to create tailored solutions for their users. Imagine building a marketplace with live Aliexpress product feeds, complete with pricing comparisons and product recommendations.

Key Features:

Real-time Data: Get up-to-date product listings with a simple query. Rich Metadata: Access product titles, images, pricing, and ratings in one call.

Notes

• Image URLs are provided in relative format; prepend them with https: to use directly.
• Paginate through results using the page parameter.
• Products might have multiple images and selling points.

This API is ideal for fetching products and their metadata to integrate Aliexpress search capabilities into your applications.