AliExpress Affiliate icon

AliExpress Affiliate

Use the AliExpress Affiliate API

Actions11

Overview

The "Get Products" operation of the AliExpress Affiliate node allows users to query and retrieve product listings from the AliExpress affiliate API. This operation is useful for affiliates or marketers who want to fetch product data such as pricing, categories, availability, and other details to promote products and earn commissions.

Common scenarios include:

  • Fetching a list of products based on keywords or category filters.
  • Filtering products by price range, delivery time, or shipping country.
  • Sorting products by sales volume, price, or other criteria.
  • Localizing product information by specifying target currency and language.

For example, an affiliate marketer could use this node to get a list of popular electronics products priced between $50 and $200, available for shipping to the US, and display them in English with prices shown in USD.

Properties

Name Meaning
Tracking ID Your tracking ID used for affiliate tracking. Optional.
Category IDs Comma-separated list of category IDs to filter products (e.g., "111,222,333"). Category IDs can be obtained via the "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 is 1.
Page Size Number of records per page (1 - 50). Default is 10.
Target Currency Currency code for price conversion. Supported values 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 Language code for localized product information. Supported values include EN, RU, PT, ES, FR, ID, IT, TH, JA, AR, VI, TR, DE, HE, KO, NL, PL, MX, CL, IN. Default is EN.
Keywords Filter products by keywords (e.g., "mp3"). Optional.
Sort Sorting order for results. Possible values include SALE_PRICE_ASC, SALE_PRICE_DESC, LAST_VOLUME_ASC, LAST_VOLUME_DESC, etc. Optional.
Max Sale Price Maximum sale price filter in unit cents (e.g., 10000 = $100.00). Optional.
Min Sale Price Minimum sale price filter in unit cents. Optional.
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). Optional.
Ship to Country Filter products that can be shipped to the specified country code. Optional.

Output

The output is an array of JSON objects where each object corresponds to one API response body containing product data matching the query parameters.

  • The json field contains the full response body returned by the AliExpress Affiliate API for the "getProducts" method.
  • The structure of the response depends on the API but typically includes product details such as product IDs, titles, prices, commission rates, shipping info, and images.
  • There is no binary data output for this operation.

Example output snippet (simplified):

{
  "json": {
    "products": [
      {
        "product_id": "123456789",
        "product_title": "Wireless Bluetooth Headphones",
        "sale_price": "29.99",
        "commission_rate": "5%",
        "ship_to_countries": ["US", "CA"],
        ...
      },
      ...
    ],
    "total_results": 100,
    "page_no": 1,
    "page_size": 10
  }
}

Dependencies

  • Requires an API key credential for the AliExpress Affiliate API with valid apiKey, apiSecret, and optionally a default trackingId.
  • The node uses the AliExpress SDK client internally to make authenticated requests to the AliExpress Affiliate API endpoint.
  • Network access to https://api-sg.aliexpress.com/sync is required.

Troubleshooting

  • Missing credentials error: If the node throws "No credentials returned!" or "Missing required credential fields," ensure that the API key credential is properly configured with all required fields.
  • API response errors: Errors from the AliExpress API may occur due to invalid parameters, expired tokens, or quota limits. Check the error message returned in the node output.
  • Empty or unexpected response: If the response does not contain expected product data, verify that the input parameters like category IDs, keywords, and pagination are correct.
  • Tracking ID issues: If no tracking ID is provided in the node parameters, the node attempts to use the default tracking ID from credentials. Ensure at least one tracking ID is set to track affiliate commissions properly.

Links and References

Discussion