Actions11
Overview
The "Get FeaturedPromo Product" operation of the AliExpress Affiliate node fetches a list of featured promotional products from the AliExpress Affiliate API. This allows users to retrieve products that are part of special promotions such as "Hot Product" or "New Arrival" campaigns.
This node is beneficial for affiliate marketers and e-commerce managers who want to programmatically access current promotional product listings to display on their websites, apps, or marketing materials. For example, an affiliate website can use this node to dynamically show trending or discounted products to increase conversions.
Properties
| Name | Meaning |
|---|---|
| Tracking ID | Your tracking ID used for affiliate link tracking. |
| Category ID | Filter products by a specific category ID. You can obtain category IDs via the AliExpress "get category" API. |
| Fields | Comma-separated list of response fields to include (e.g., commission_rate, sale_price). |
| Page No | Page number for paginated results (default 1). |
| Page Size | Number of records per page (1-50, default 10). |
| Target Currency | Currency code for prices (e.g., USD, GBP, EUR). |
| Target Language | Language code for returned data (e.g., EN, RU, FR). |
| Country | Ship-to country filter; filters products that can be shipped to this country and adjusts price accordingly. |
| Sort | Sorting order of results (e.g., SALE_PRICE_ASC, LAST_VOLUME_DESC). |
| Promotion Name | Name of the promotion to filter by (e.g., "Hot Product", "New Arrival"). |
| Promotion Start Time | Start time of the promotion in PST timezone. |
| Promotion End Time | End time of the promotion in PST timezone. |
Output
The node outputs JSON data containing the response body from the AliExpress Affiliate API call for featured promotional products. The structure typically includes product details such as IDs, names, prices, commissions, and other requested fields depending on the Fields parameter.
Example output JSON snippet:
{
"products": [
{
"product_id": "123456789",
"product_title": "Example Product",
"sale_price": "19.99",
"commission_rate": "5.0",
...
},
...
],
"total_count": 100,
"page_no": 1,
"page_size": 10
}
No binary data output is produced by this operation.
Dependencies
- Requires an API key credential with AliExpress Affiliate API access.
- The node uses the AliExpress SDK client internally to communicate with the API endpoint at
https://api-sg.aliexpress.com/sync. - Proper configuration of the API key, secret, and optionally a default tracking ID is necessary.
Troubleshooting
- Missing Credentials: If the API key or secret is missing, the node will throw an error. Ensure credentials are properly set up in n8n.
- Invalid Tracking ID: If no tracking ID is provided either in the node parameters or credentials, the request may fail or not track affiliate clicks correctly.
- API Response Errors: Network issues or invalid parameters (e.g., wrong category ID or date format) can cause API errors. Check the error message for details.
- Pagination Limits: Page size must be between 1 and 50; exceeding this may cause errors.
- Date Format: Promotion start/end times must be in PST timezone and correctly formatted; otherwise, the API may reject the request.