Amazon Selling Partner icon

Amazon Selling Partner

Interact with Amazon Selling Partner API
Join our community

Actions18

Overview

This node interacts with the Amazon Selling Partner API to retrieve sales and traffic analytics data by ASIN (Amazon Standard Identification Number). It is useful for sellers and analysts who want to monitor product performance across various Amazon marketplaces. The node supports detailed filtering, metric selection, sorting, and output formatting options, enabling users to customize the analytics data according to their needs. For example, a seller can use this node to get daily sales and traffic metrics for specific ASINs in the US marketplace over the last 30 days, with results sorted by sales volume.

Use Case Examples

  1. Retrieve daily sales and traffic data for a list of ASINs in the US marketplace for the last 30 days.
  2. Get weekly sales metrics filtered by brand and fulfillment channel, outputting results as CSV for further analysis.
  3. Fetch monthly analytics data with currency normalization to USD and include product listing details for enhanced reporting.

Properties

Name Meaning
Marketplace IDs Select the Amazon marketplaces to retrieve analytics data from, such as US, Canada, UK, etc.
Date Range Type Choose how to specify the date range for analytics data, either by absolute specific dates or relative presets.
Start Date Start date for the analytics data (inclusive), used when Date Range Type is absolute.
End Date End date for the analytics data (inclusive), used when Date Range Type is absolute.
Date Preset Select a preset date range or choose custom when Date Range Type is relative.
Custom Days Number of days to look back from today when using a custom relative date range.
Granularity Time granularity for the analytics data, such as daily, weekly, or monthly.
Timezone Timezone for date boundaries and output formatting.
Filters Collection of filters to narrow down analytics data by ASINs, parent ASIN, SKUs, brands, fulfillment channel, and activity thresholds.
Metrics Selection Select traffic, sales, conversion, buy box, and computed metrics to include in the analytics data.
Sorting & Limiting Options to sort the results by a specific metric, direction, limit the number of results, and specify secondary sorting.
Output Options Options to configure the output format (JSON raw, JSON flattened, CSV), CSV formatting, pivoting, currency normalization, and additional data joining.
Advanced Options Advanced settings for analytics mode, schema version, raw query override, pagination, chunking, retries, diagnostics, and validation.

Output

Binary

CSV formatted analytics data if CSV output is selected

JSON

  • data - The main analytics data output, structured according to selected metrics and filters
  • metadata - Optional diagnostics and metadata about the API response and request
  • pagination - Information about pagination if applicable

Dependencies

  • Amazon Selling Partner API
  • API key credential for Amazon SP-API authentication

Troubleshooting

  • Ensure correct marketplace IDs are selected to avoid empty results.
  • Verify date range and granularity settings to match available data.
  • If using SKU filters, ensure SKU resolution is enabled and Listings API access is available.
  • Handle API rate limits by enabling chunking and retry options.
  • Check for missing metrics if strict validation is enabled and adjust metric selection accordingly.
  • Common errors include authentication failures, invalid date ranges, and exceeding API limits; verify credentials and parameters.

Links

Discussion