AliExpress Affiliate icon

AliExpress Affiliate

Use the AliExpress Affiliate API

Actions11

Overview

The "Get HotProduct Download" operation in the AliExpress Affiliate node allows users to retrieve downloadable data about hot products from AliExpress. This can be useful for affiliates or marketers who want to access trending product information in bulk, potentially for analysis, promotion, or integration into their own platforms.

Typical use cases include:

  • Downloading lists of currently popular products within a specific category.
  • Filtering hot products by locale site to target specific markets.
  • Integrating hot product data into marketing campaigns or affiliate websites.

For example, an affiliate marketer could use this operation to download the latest hot products in electronics for the global market and then generate affiliate links to promote those products.

Properties

Name Meaning
Tracking ID Your tracking ID used for affiliate tracking.
Category ID Category ID to filter hot products; can be obtained via the "get category" API.
Locale Site Local site to specify the market region, e.g., global, it_site, es_site, ru_site.
Fields Comma-separated list of response parameters to include, e.g., commission_rate, sale_price.
Page No Page number for paginated results (default is 1).
Page Size Number of records per page, between 1 and 50 (default is 10).
Target Currency Currency code for price conversion, e.g., USD, GBP, EUR, etc.
Target Language Language code for localized content, e.g., EN, RU, PT, ES, etc.
Country Ship-to country code to filter products that can be shipped there and adjust prices according to local tax policies.

Output

The output is a JSON object containing the response body from the AliExpress Affiliate API's hot product download endpoint. The structure depends on the API response but generally includes details about hot products such as product IDs, names, prices, commission rates, and other requested fields.

Example output snippet (conceptual):

{
  "products": [
    {
      "product_id": "123456789",
      "product_name": "Example Product",
      "sale_price": "19.99",
      "commission_rate": "5.0",
      ...
    },
    ...
  ],
  "total_count": 100,
  "page_no": 1,
  "page_size": 10
}

No binary data output is indicated for this operation.

Dependencies

  • Requires an API key credential with AliExpress Affiliate API access.
  • The node uses the AliExpress SDK client configured with the API key and secret.
  • Network access to https://api-sg.aliexpress.com/sync is required.
  • Proper configuration of the API credentials in n8n is necessary.

Troubleshooting

  • Missing Credentials: If the API key or secret is missing, the node will throw an error. Ensure the API credentials are correctly set up in n8n.
  • Invalid Parameters: Passing invalid category IDs or unsupported locale sites may result in empty or error responses.
  • API Rate Limits: Frequent requests might hit API rate limits; consider adding delays or handling errors gracefully.
  • Unexpected API Response Structure: If the API changes its response format, the node might fail to parse the response properly.
  • Tracking ID Issues: If no tracking ID is provided in the node parameters or credentials, the request may not track affiliate commissions correctly.

Links and References

Discussion