Data Kiosk

Run Amazon Data Kiosk GraphQL queries — Sales & Traffic, Economics, Vendor Analytics — and read the results, by conversation or by code.

In short

Data Kiosk is Amazon's GraphQL analytics API. Your agent writes the query, submits it, waits for Amazon and reads the document — sales and traffic by date or ASIN, per-unit fees and margin, vendor analytics.

Query, wait, read

Submit the query

dataKiosk_createQuery sends a GraphQL query for one dataset and date range.

Wait for Amazon

dataKiosk_getQuery checks the status and downloads the result when it is done. dataKiosk_getQueries lists your recent queries; dataKiosk_cancelQuery stops one.

Read the document

dataKiosk_getDocument fetches a finished result by its document ID.

Try asking

"Run a Data Kiosk Sales & Traffic query by ASIN for last month."

"Check my pending Data Kiosk queries."

Checking a query, both ways

MCP — you ask: "Is my Data Kiosk query done yet?" Your agent calls dataKiosk_getQuery.

In an AI client (MCP)

tools/call
{
  "name": "dataKiosk_getQuery",
  "arguments": {
    "store": "myStore-US",
    "queryId": "<query id>"
  }
}

From code (Tool API)

curl -X POST https://api.sellersheetai.com/api/v1/tools/dataKiosk_getQuery \
  -H "Authorization: Bearer $SELLERSHEET_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"store":"myStore-US","queryId":"<query id>"}'
Early access — the Tool API is open on request, contact us.

Tools on this page

ToolAccessWhat it does
dataKiosk_cancelQueryreadCancel a Data Kiosk query that is IN_QUEUE or IN_PROGRESS.
dataKiosk_createQueryreadSubmit a Data Kiosk GraphQL query; returns queryId at once.
dataKiosk_getDocumentreadFetch a Data Kiosk document by document ID.
dataKiosk_getQueriesreadList Data Kiosk queries for this store with optional filters.
dataKiosk_getQueryreadPoll Data Kiosk query status.

FAQ

Is Sales & Traffic already synced?

Yes — by date and by ASIN, as synced tables you query instantly. See Synced reports and the Data tab.

How does my agent write a valid query?

The data-kiosk skill carries each dataset's fields, arguments and enums. See Install the skills.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude