Amazon PA API icon

Amazon PA API

Interact with Amazon Product Advertising API 5.0 (PAAPI)
Join our community

Actions4

Overview

This node integrates with the Amazon Product Advertising API (PAAPI) to retrieve detailed information about Amazon browse nodes. The "Get Browse Nodes" operation allows users to fetch metadata and hierarchical data related to specific browse nodes identified by their IDs. This is useful for applications that need to explore or categorize Amazon product categories programmatically.

Common scenarios include:

  • Building a product catalog browser that reflects Amazon's category structure.
  • Analyzing category-specific sales ranks or other browse node attributes.
  • Enriching product data with category-related metadata.

For example, a user can input one or more browse node IDs and specify which resources (such as browse node info, images, item info, offers, etc.) they want included in the response. The node then returns structured data about those browse nodes.

Properties

Name Meaning
Partner Tag Amazon Partner Tag used for affiliate tracking; overrides default if set.
Browse Node IDs (for Get Browse Nodes) Comma-separated list of Amazon browse node IDs to retrieve information for.
Resources List of resource fields to include in the response. Options include various browse node info, images, item info, and offer details. Default includes item title, offer price, and medium primary image.
Use OffersV2 Boolean flag to use the newer OffersV2 resource format (requires API version 1.2.2 or higher).
Additional Options Collection of optional parameters:
- Language of Preference Preferred language for item information. Options: Default, English, Spanish, French, German, Italian, Japanese.

Output

The node outputs an array of JSON objects, each representing the result of a request for browse node information. Each output object contains:

  • success: Boolean indicating whether the request was successful.
  • If successful, the response includes the requested browse node data structured according to the selected resources.
  • If errors occur, an errors array with error details, an errorMessage string summarizing the errors, and the originalResponse from the API are included.
  • In case of exceptions during execution, the output contains success: false, an errorMessage describing the issue, and optionally an errorDetail with stack trace information.

The exact structure of the browse node data depends on the selected resources but generally includes hierarchical browse node info, sales rank data, images, item info, and offer details as requested.

Dependencies

  • Requires an active Amazon Product Advertising API credential with access keys and partner tag.
  • The node uses the official Amazon PAAPI client library (amazon-paapi) to communicate with the API.
  • The user must configure credentials in n8n with valid Amazon API access key, secret key, partner tag, and marketplace.

Troubleshooting

  • Missing Partner Tag: The node requires a partner tag either from credentials or input property. If missing, it throws an error "PartnerTag is required but was not provided".
  • Missing Browse Node IDs: For the "Get Browse Nodes" operation, browse node IDs must be provided. Omitting them results in an error "Browse Node IDs are required but were not provided."
  • API Errors: If the Amazon API returns errors, these are logged and included in the output with detailed messages. Common issues include invalid IDs, permission issues, or quota limits.
  • Version Compatibility: Using the "Use OffersV2" option requires API version 1.2.2 or higher; otherwise, the request may fail.
  • Network or Credential Issues: Network failures or invalid credentials will cause request errors, which are caught and reported in the output.

To resolve errors:

  • Ensure all required inputs are provided.
  • Verify credentials and partner tag correctness.
  • Check API usage limits and permissions.
  • Confirm API version compatibility when using newer features.

Links and References

Discussion