Market NinjaMarket Ninja
方法

获取某个解析会话的商品

GET
/me/scrapes/{id}/products

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

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Path Parameters

id*string
Formatuuid

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

application/json

curl -X GET "https://example.com/me/scrapes/b1f8b6b0-2f7d-4a1a-9a3c-2f6d8e9a1234/products"
{  "data": [    {      "submission_status": "merged",      "product": {        "id": "e86bee19-9cc9-4a83-b9cc-6b61f1209d90",        "marketplace": "wildberries",        "external_id": "231151629",        "url": "https://www.wildberries.ru/catalog/231151629/detail.aspx",        "name": "Air Rift Breathe White Pure Platinum Women's",        "brand": "Nike",        "category_path": [          "Обувь",          "Женская",          "Туфли и лоферы"        ],        "attributes": {          "color": "желтый",          "season": "демисезон",          "is_authentic": true        },        "image_cover": "https://basket-15.wbbasket.ru/vol2311/part231151/231151629/images/big/1.webp",        "image_gallery": [          "https://basket-15.wbbasket.ru/vol2311/part231151/231151629/images/big/1.webp"        ],        "video_cover": null,        "video_gallery": [],        "seller": {          "id": "3994154",          "name": "POIZON(ДЭВУ)",          "code": "2604540"        },        "trust_status": "unverified",        "price_flagged": false,        "prices": [          {            "country_code": "ru",            "region_code": null,            "user_auth_status": "anonymous",            "price": 7093,            "old_price": 8651,            "currency": "RUB",            "stock_status": null,            "stock_quantity": null,            "recorded_at": "2026-08-02T23:21:53.185302+00:00"          }        ],        "special_price": [          {            "country_code": "ru",            "region_code": "",            "user_auth_status": "anonymous",            "min": 6783,            "max": 6880          }        ],        "stats": null,        "first_seen_language": "ru",        "default_language": "ru",        "translations": [          {            "language": "ru",            "name": "Air Rift Breathe White Pure Platinum Women's",            "category_path": [              "Обувь",              "Женская",              "Туфли и лоферы"            ],            "attributes": {              "color": "желтый",              "season": "демисезон",              "is_authentic": true            },            "updated_at": "2026-08-02T23:21:53.081+00:00"          }        ],        "first_seen_at": "2026-08-01T01:03:17.913664+00:00",        "last_seen_at": "2026-08-02T23:21:53.081+00:00"      }    },    {      "submission_status": "pending",      "product": null    }  ],  "meta": {    "total": 40,    "page": 1,    "page_size": 100  }}

获取某个解析会话的状态 GET

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

列出您的解析会话 GET

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