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` 是根據底層提交記錄 即時計算的，而不是快取值，因此它們一律反映背景合併流程的目前狀態。