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 reports for specific date ranges, marketplaces, and product identifiers. Practical applications include tracking sales trends, analyzing traffic metrics, and optimizing inventory and marketing strategies based on granular ASIN-level data.

Use Case Examples

  1. A seller wants to analyze the last 30 days of sales and traffic data for their products on Amazon.com and Amazon.co.uk, filtered by specific ASINs and brands, to identify top-performing items.
  2. An analyst needs weekly sales metrics and conversion rates for all ASINs in the US marketplace over the past quarter to prepare a performance report.
  3. A business wants to export monthly sales and traffic data in CSV format, normalized to USD, including product titles and brands, for integration with their internal analytics system.

Properties

Name Meaning
Marketplace IDs Select the Amazon marketplaces to retrieve analytics data from, such as US, UK, Germany, etc.
Date Range Type Choose how to specify the date range for analytics data, either by absolute specific dates or relative preset/custom ranges.
Start Date Start date for the analytics data (inclusive), required if using absolute date range.
End Date End date for the analytics data (inclusive), required if using absolute date range.
Date Preset Select a preset relative date range or choose custom, used if date range type is relative.
Custom Days Number of days to look back from today when using a custom relative date range (1 to 90 days).
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 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 as JSON objects or flattened rows depending on output format
  • metadata - Optional diagnostics and metadata about the API response if enabled

Dependencies

  • Amazon Selling Partner API with appropriate credentials

Troubleshooting

  • Ensure valid and active Amazon Selling Partner API credentials are provided to avoid authentication errors.
  • Check that the selected marketplaces and date ranges are supported and correctly formatted to prevent API request failures.
  • If using SKU resolution, verify that SKUs exist and are correctly mapped to ASINs to avoid empty results.
  • Be aware of API rate limits and use chunking and retry options to handle large data requests gracefully.
  • If strict validation is enabled, missing metrics in the response will cause errors; disable strict mode to allow partial data.
  • CSV output issues may arise from incorrect delimiter or decimal separator settings; verify these match the expected format.

Links

Discussion