Amazon Selling Partner icon

Amazon Selling Partner

Interact with Amazon Selling Partner API

Actions26

Data Kiosk → Run Query and Download

AI-generated

Overview

This node operation allows users to run a GraphQL query against Amazon's Data Kiosk service and download the resulting data. It is useful for retrieving detailed analytics and sales data using versioned GraphQL schemas. Users can specify the query, control query minification, set polling intervals and timeouts for query completion, and choose how to handle multi-page results. The output can be downloaded as either binary data (e.g., a file) or text.

Use Case Examples

  1. A seller wants to analyze sales and traffic trends for specific ASINs over a date range by submitting a GraphQL query and downloading the results as a CSV file.
  2. A data analyst needs to automate the retrieval of marketplace analytics data, polling the query status until completion, and then processing the downloaded binary file in a workflow.

Properties

Name Meaning
Query The GraphQL query string to be executed against the Data Kiosk service. It must use a versioned schema and can be up to 8000 characters after minification.
Minify GraphQL Boolean flag to remove comments and unnecessary whitespace from the GraphQL query before sending it to optimize request size and performance.
Output Determines the format of the downloaded document returned by the node, either as binary data or plain text.
Binary Property The property name under which the binary file data will be stored if the output is set to binary.
Poll Interval (Ms) The interval in milliseconds at which the node polls the query status to check if the query has completed.
Timeout (Ms) The maximum time in milliseconds to wait for the query to complete before timing out.
Multi-Page Handling Specifies how to handle paginated query results, either keeping pages separate or stopping after the first page.

Output

Binary

Contains the downloaded document file when output is set to binary, stored under the specified binary property name.

JSON

  • data - The JSON data returned from the executed GraphQL query if output is set to text or parsed JSON.
    binary - The binary file data of the downloaded document if output is set to binary.

Dependencies

  • Requires an Amazon Selling Partner API credential with access to the Data Kiosk service.

Troubleshooting

  • Common issues include query syntax errors, exceeding the maximum query length, or timeouts if the query takes too long to complete.
  • Errors related to authentication or permissions if the API credentials are invalid or lack required scopes.
  • Polling interval too short or timeout too low may cause premature termination of the query process.

Links

Discussion