Market NinjaMarket Ninja
方法

列出您的解析会话

GET
/me/scrapes

每次调用扩展程序的解析功能——无论是单页还是批量运行——都会生成一个解析会话， 自动归属于您自己的 API 密钥；没有任何方式能看到其他账户的会话，也没有任何筛选 参数，因为根本不需要。按最新优先排序。status/stats 是根据底层提交记录实时 计算的，而不是缓存值，因此它们始终反映后台合并流程的当前状态。

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Query Parameters

page?integer

无效或缺失的值会被静默限制为默认值，而不会以 400 错误拒绝。

Range1 <= value
Default1
page_size?integer

最大值为 500——相比典型的面向 UI 的 API，这个值刻意设置得更宽松，专为批量拉取场景设计。

Range1 <= value <= 500
Default100

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/me/scrapes"
{  "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"    }  ],  "meta": {    "total": 1,    "page": 1,    "page_size": 100  }}

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

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

列出卖家 GET

至少需要一个识别性参数：`tin`、`psrn`、`url`，或 `marketplace`+`seller_id` 组合。返回一个数组——不保证只有一条结果，因为同一个法人主体可能以同一个税号在 多个市场平台上经营。