dataKiosk_getQueries

List Data Kiosk queries for this store with optional filters.

readAmazon Seller (SP-API)sp.dataKiosk_2023-11-15

Amazon SP-API · getQueries · GET /dataKiosk/2023-11-15/queries Useful for checking query history or finding queryIds for completed queries. Read a DONE query's results with dataKiosk_getQuery.

Call it

In an AI client (MCP)

tools/call
{
  "name": "dataKiosk_getQueries",
  "arguments": {
    "store": "myStore-US"
  }
}

From code (Tool API)

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

Arguments

NameTypeDescription
storerequiredstringthe store ref `<store>-<CC>` (name-country, e.g. 'myStore-US') — one of get_user_context's store_refs, verbatim.
processingStatusesstring[]the query statuses to keep (at least 1 value if given); omit for all. Allowed: CANCELLED | DONE | FATAL | IN_PROGRESS | IN_QUEUE.CANCELLEDDONEFATALIN_PROGRESSIN_QUEUE
pageSizeinteger · 1–100Number of results per page (1-100; defaults to 10).
createdSincestring · date-timeEarliest query-creation time to include, ISO 8601 date time (e.g. '2026-06-01T00:00:00Z'). Defaults to 90 days ago.
createdUntilstring · date-timeLatest query-creation time to include, ISO 8601 date time. Defaults to the time of the request.
paginationTokenstringToken from a previous response (data.pagination.nextToken) for the next page. When paging, resend processingStatuses / createdSince / createdUntil unchanged (only pageSize may change).

Result

Every tool answers {notification, data, human_action}; data carries:

  • data.queries — list of query objects, each with queryId, query, processingStatus, createdTime, and (when DONE/FATAL) dataDocumentId or errorDocumentId.
  • data.pagination.nextToken — present when more results are available; pass back as paginationToken for the next page.

On this page

Actions

View as Markdown

Ask an assistant

Ask ChatGPTAsk Claude