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` 組合。回傳一個陣列——不保證只有一筆結果，因為同一個法人主體可能以同一個稅號在 多個電商平台上經營。