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` 佔位記錄不消耗配額。