Market NinjaMarket Ninja
Endpoints

List your scrape sessions

GET
/me/scrapes

Every call to the extension's scraper — a single page or a bulk run — becomes one scrape session, scoped automatically to your own API key; there's no way to see another account's sessions, and no filter parameters exist because none are needed. Most recent first. status/stats are computed live from the underlying submissions, not cached, so they always reflect the current state of the background merge process.

Authorization

bearerAuth
AuthorizationBearer <token>

Bearer token — see API Overview for how to get one and use it.

In: header

Query Parameters

page?integer

Invalid or missing values are silently clamped to the default rather than rejected with a 400.

Range1 <= value
Default1
page_size?integer

500 max — deliberately generous relative to a typical UI-facing API, sized for bulk pulls.

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 a scrape session's products GET

The actual scraped data — "give me what I just scraped." Returns every submission in the session, not only merged ones: the background merge step runs on a schedule, so right after a scrape most items are still `pending`, with `product: null` until a later pass merges them. Poll `GET /me/scrapes/{id}` (or just re-request this endpoint) until `status` is `completed`. Billed against your daily quota only for rows that actually carry a merged `product` — a `pending` placeholder costs nothing.

List sellers GET

At least one identifying parameter is required: `tin`, `psrn`, `url`, or `marketplace`+`seller_id` together. Returns an array — not guaranteed to be a single result, since the same legal entity can sell under one TIN on more than one marketplace.