AliExpress Affiliate icon

AliExpress Affiliate

Use the AliExpress Affiliate API
Join our community

Actions11

Overview

This node integrates with the AliExpress Affiliate API to retrieve detailed product information based on specified product IDs. It is particularly useful for affiliate marketers or e-commerce platforms that want to fetch up-to-date product details such as pricing, commission rates, and availability directly from AliExpress. For example, a user can input a list of product IDs and receive comprehensive data about those products, which can then be used to display product info on a website or analyze affiliate commissions.

Properties

Name Meaning
Tracking ID Your tracking ID used for affiliate tracking; optional but recommended for proper attribution.
Fields Comma-separated list of response parameters to include (e.g., commission_rate, sale_price).
Target Currency The currency in which prices should be returned. Options include USD, GBP, CAD, EUR, UAH, MXN, TRY, RUB, BRL, AUD, INR, JPY, IDR, SEK, KRW, ILS, THB, CLP, VND. Default is USD.
Target Language The language for the response content. Options include EN, RU, PT, ES, FR, ID, IT, TH, JA, AR, VI, TR, DE, HE, KO, NL, PL, MX, CL, IN. Default is EN.
Country Ship-to country filter to only return products that can be shipped there; also affects price tax calculations.
Product IDs Comma-separated list of product IDs to query details for.
Ship to Country Similar to Country, filters products by shipping destination.

Output

The output is an array of JSON objects where each object corresponds to the API response body for a requested product detail query. The structure depends on the AliExpress API response but generally includes detailed product attributes such as pricing, commission rates, availability, descriptions, and other metadata.

If the API returns binary data (not typical for this operation), it would represent associated media or files related to the product, but this node primarily outputs JSON data.

Example output snippet:

{
  "product_id": "123456789",
  "sale_price": "19.99",
  "commission_rate": "5%",
  "currency": "USD",
  "title": "Sample Product",
  ...
}

Dependencies

  • Requires an active AliExpress Affiliate API credential with an API key, secret, and optionally a default tracking ID.
  • The node uses the AliExpress SDK client internally to communicate with the API endpoint https://api-sg.aliexpress.com/sync.
  • Proper configuration of the API credentials in n8n is necessary before use.

Troubleshooting

  • Missing Credentials: If the API key or secret is missing, the node will throw an error. Ensure that the AliExpress Affiliate API credentials are correctly set up in n8n.
  • Invalid Product IDs: Providing invalid or empty product IDs may result in empty or error responses from the API.
  • API Rate Limits: Frequent requests might hit AliExpress API rate limits, causing errors or throttling.
  • Unexpected API Response Structure: If the API changes or returns unexpected data, the node may fail to parse the response properly.
  • Tracking ID Issues: If no tracking ID is provided either in the node parameter or credentials, some affiliate features might not work as expected.

To resolve these issues:

  • Verify credentials and their permissions.
  • Double-check product IDs format and validity.
  • Handle errors gracefully using the node's "Continue On Fail" option if available.
  • Consult AliExpress API documentation for any updates or changes.

Links and References

Discussion