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 generate customized reports on product sessions, sales, conversion rates, and other key performance indicators over specified date ranges and granularities.

Use Case Examples

  1. A seller wants to analyze daily sales and traffic metrics for their products on Amazon.com and Amazon.co.uk over the last 30 days to optimize inventory and marketing strategies.
  2. An analyst needs to generate a CSV report of weekly sales units and ordered product sales for specific ASINs filtered by brand and fulfillment channel, normalized to USD currency.
  3. A business wants to track conversion metrics and buy box percentages for their product listings, including child ASINs, with data pivoted by marketplace for easier comparison.

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 absolute specific dates or relative preset/custom ranges.
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 selected metric, direction, limit the number of results, and specify secondary sort metric.
Output Options Options to configure output format (JSON raw, JSON flattened, CSV), CSV formatting, pivoting, currency normalization, joining listing data, and output property name.
Advanced Options Advanced settings including 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 representing sales and traffic metrics by ASIN and other filters.
  • metadata - Optional diagnostics and metadata about the API response, included if diagnostics option is enabled.

Dependencies

  • Amazon Selling Partner API
  • API authentication credentials

Troubleshooting

  • Ensure valid Amazon Selling Partner API credentials are provided to avoid authentication errors.
  • If no data is returned, verify that the selected date range, marketplaces, and filters are correct and that data exists for those parameters.
  • When using SKU filters, ensure the 'Resolve SKUs to ASINs' option is enabled to correctly map SKUs to ASINs.
  • If API rate limits are hit, enable chunking and adjust chunk size to reduce request size.
  • Check the output format settings to ensure compatibility with downstream processing, especially when using CSV output.

Links

Discussion