Amazon Selling Partner icon

Amazon Selling Partner

Interact with Amazon Selling Partner API

Data Kiosk → Create Query

AI-generated

Overview

This node operation allows users to create and submit GraphQL queries to Amazon's Data Kiosk service via the Amazon Selling Partner API. It is useful for retrieving detailed analytics and sales data by specifying queries using versioned schemas. Users can customize queries to fetch specific data such as sales trends, traffic, and marketplace information over defined date ranges.

Use Case Examples

  1. A seller wants to analyze sales and traffic trends for a specific product ASIN over a week to optimize marketing strategies.
  2. A business analyst needs to extract detailed marketplace sales data aggregated by day to generate performance reports.

Properties

Name Meaning
Query The GraphQL query string to be executed against the Data Kiosk API. It must use a versioned schema and can include various fields and filters to specify the data to retrieve.
Minify GraphQL A boolean option to remove comments and unnecessary whitespace from the GraphQL query before sending it, optimizing the request size.
Pagination Token A token string used to fetch a specific page of results from a previous query, enabling pagination through large datasets.

Output

JSON

  • data - The JSON response data returned from the Data Kiosk GraphQL query, containing the requested analytics and sales information.
  • paginationToken - A token provided in the response to retrieve the next page of results if the query supports pagination.

Dependencies

  • Amazon Selling Partner API credentials with access to Data Kiosk service

Troubleshooting

  • Ensure the GraphQL query is valid and conforms to the versioned schema as per the Amazon Data Kiosk Schema Explorer.
  • Check that the API credentials have the necessary permissions to access the Data Kiosk service.
  • If pagination tokens are used, verify that the token is correctly copied from a previous response and is not expired.
  • Common errors include invalid query syntax, unauthorized access, and exceeding query size limits (max 8000 characters after minification).
  • Use the 'Minify GraphQL' option to reduce query size and avoid errors related to query length.

Links

Discussion