Actions11
Overview
The "Get Hot Products" operation of the AliExpress Affiliate node fetches a list of trending or popular products from AliExpress. This is useful for affiliate marketers, e-commerce managers, or developers who want to promote currently popular items and potentially increase sales commissions by linking to these hot products.
Typical use cases include:
- Displaying trending products on a website or app.
- Creating marketing campaigns focused on popular items.
- Analyzing market trends by monitoring hot product data.
For example, an affiliate marketer can retrieve hot products in specific categories, filter by price range, and sort by sales volume to select the best items to promote.
Properties
| Name | Meaning |
|---|---|
| Tracking ID | Your tracking ID used for affiliate tracking. |
| Category IDs | Comma-separated list of category IDs to filter products (e.g., "111,222,333"). Category IDs can be obtained via the AliExpress "get category" API. |
| Fields | Comma-separated list of response fields to include, such as commission_rate, sale_price, etc. |
| Page No | Page number of results to retrieve (pagination). Default is 1. |
| Page Size | Number of records per page, between 1 and 50. Default is 10. |
| Target Currency | Currency code for prices, e.g., USD, GBP, CAD, EUR, UAH, MXN, TRY, RUB, BRL, AUD, INR, JPY, IDR, SEK, KRW, ILS, THB, CLP, VND. Default is USD. |
| Target Language | Language code for localized content, e.g., EN, RU, PT, ES, FR, ID, IT, TH, JA, AR, VI, TR, DE, HE, KO, NL, PL, MX, CL, IN. Default is EN. |
| Ship to Country | Filter products that can be shipped to this country. Also affects price calculation based on local tax policies. |
| Keywords | Filter products by keywords (e.g., "mp3"). |
| Sort | Sorting order of results, options include SALE_PRICE_ASC, SALE_PRICE_DESC, LAST_VOLUME_ASC, LAST_VOLUME_DESC, etc. |
| Max Sale Price | Maximum sale price filter (in unit cents). |
| Min Sale Price | Minimum sale price filter (in unit cents). |
| Platform Product Type | Product type filter: ALL, PLAZA, TMALL. Default is ALL. |
| Delivery Days | Estimated delivery days filter (e.g., "3" means delivery within 3 days). |
Output
The node outputs an array of JSON objects, each representing a product returned by the AliExpress API for hot products. The structure depends on the requested fields but typically includes product details such as:
- Product ID
- Title
- Price and currency
- Commission rate
- Sales volume
- Shipping information
- Images and URLs
If the API returns binary data (not typical for this operation), it would represent downloadable content related to hot products, but this operation primarily returns JSON data.
Dependencies
- Requires an API key credential with AliExpress Affiliate API access.
- Uses the AliExpress Affiliate API endpoint at
https://api-sg.aliexpress.com/sync. - The node requires proper configuration of credentials including API key, secret, and optionally a default tracking ID.
- Network connectivity to AliExpress API servers is necessary.
Troubleshooting
- Missing Credentials: If the API key or secret is missing or invalid, the node will throw an error. Ensure credentials are correctly set up in n8n.
- Invalid Parameters: Passing invalid category IDs, unsupported currency codes, or incorrect pagination values may cause API errors or empty responses.
- API Rate Limits: Frequent requests might hit AliExpress API rate limits; handle errors gracefully and consider retry logic.
- Empty Results: If filters are too restrictive (e.g., very narrow price range or keywords), no products may be returned.
- Tracking ID Issues: If no tracking ID is provided either in credentials or input, affiliate tracking may not work properly.
Links and References
- AliExpress Affiliate API Documentation
- AliExpress Affiliate Hot Products API (referenced for category IDs and parameters)