Data Kiosk
运行亚马逊 Data Kiosk GraphQL 查询——销售与流量、经济性、Vendor 分析——并读取结果,用对话或代码完成。
一句话
Data Kiosk 是亚马逊的 GraphQL 分析 API。AI 编写查询、提交、等待亚马逊并读取文档——按日期或 ASIN 的销售与流量、单件费用与利润、Vendor 分析。
查询、等待、读取
提交查询
dataKiosk_createQuery 为一个数据集和日期范围提交 GraphQL 查询。
等亚马逊处理
dataKiosk_getQuery 查询状态,完成后下载结果。dataKiosk_getQueries 列出最近的查询;dataKiosk_cancelQuery 取消查询。
读取文档
dataKiosk_getDocument 按文档 ID 获取已完成的结果。
可以这样问
“运行一个上个月按 ASIN 的 Data Kiosk 销售与流量查询。”
“看看我还在处理中的 Data Kiosk 查询。”
查询状态的两种调用方式
MCP——你说:“我的 Data Kiosk 查询好了吗?” AI 调用 dataKiosk_getQuery。
在 AI 客户端中(MCP)
{
"name": "dataKiosk_getQuery",
"arguments": {
"store": "myStore-US",
"queryId": "<query id>"
}
}在代码中(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>"}'抢先体验 — 如需 Tool API 访问,请 联系我们.
本页用到的工具
| 工具 | 权限 | 作用(英文) |
|---|---|---|
dataKiosk_cancelQuery | read | Cancel a Data Kiosk query that is IN_QUEUE or IN_PROGRESS. |
dataKiosk_createQuery | read | Submit a Data Kiosk GraphQL query; returns queryId at once. |
dataKiosk_getDocument | read | Fetch a Data Kiosk document by document ID. |
dataKiosk_getQueries | read | List Data Kiosk queries for this store with optional filters. |
dataKiosk_getQuery | read | Poll Data Kiosk query status. |
常见问题
销售与流量已经同步了吗?
是的——按日期和按 ASIN 两张已同步的表,可立即查询。见已同步报表和数据标签页。
AI 怎么写出有效的查询?
data-kiosk 技能带有每个数据集的字段、参数和枚举。见安装技能。