Market NinjaMarket Ninja
方法

获取某个解析会话的状态

GET
/me/scrapes/{id}

当会话中的每一条提交记录都不再处于 pending/processing 状态时，status 就会变为 completed——这并不一定代表「每一项都成功合并了」，具体明细请查看 stats。stats.total 为 0 的会话会一直是 processing，永远不会变成 completed，无论是因为还没有任何数据到达，还是（很久之后）因为其提交记录已经 超出保留期限而被清除。

Authorization

bearerAuth
AuthorizationBearer <token>

Bearer 令牌——获取方式与使用方法请参阅 API 概览。

In: header

Path Parameters

id*string
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/me/scrapes/b1f8b6b0-2f7d-4a1a-9a3c-2f6d8e9a1234"
{  "data": {    "id": "b1f8b6b0-2f7d-4a1a-9a3c-2f6d8e9a1234",    "status": "processing",    "stats": {      "total": 40,      "pending": 12,      "processing": 0,      "merged": 28,      "rejected": 0,      "flagged": 0    },    "metadata": {      "source_type": "bulk",      "intent": "data",      "url_count": 40    },    "created_at": "2026-08-04T10:15:00.000Z",    "updated_at": "2026-08-04T10:16:42.000Z"  }}

列出商品 GET

返回符合给定筛选条件的一页商品。没有任何一个筛选参数是必填的，但通常都应至少传入 一个识别性参数（`url`、`external_id`+`marketplace`，或 `seller_code`）——否则 您得到的会是整个数据集的一个宽泛切片。

获取某个解析会话的商品 GET

真正解析到的数据——「把我刚解析到的东西给我」。返回该会话中的每一条提交记录， 不只是已合并的那些：后台合并流程是按计划批处理运行的，因此刚解析完之后，大多数 条目仍处于 `pending` 状态，`product` 为 `null`，直到之后的某一轮合并处理它们。 请轮询 `GET /me/scrapes/{id}`（或直接重新请求这个端点），直到 `status` 变为 `completed`。每日配额只会为真正带有已合并 `product` 的行计费——`pending` 占位记录不消耗配额。