Market NinjaMarket Ninja
Endpoints

List sellers

GET
/sellers

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.

Authorization

bearerAuth
AuthorizationBearer <token>

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

In: header

Query Parameters

tin?string

The seller's tax identification number (ИНН).

psrn?string

The seller's state registration number (ОГРН/ОГРНИП).

url?string

The seller's storefront URL. Query parameters (UTM tags, etc.) are stripped automatically, same as GET /products.

Formaturi
marketplace?string

Value in

  • "ozon"
  • "wildberries"
  • "yandex_market"
  • "lamoda"
seller_id?string

The seller's id on the marketplace. Used paired with marketplace.

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/sellers?tin=7722774359&url=https%3A%2F%2Fwww.wildberries.ru%2Fseller%2F2557&marketplace=wildberries"
{  "data": [    {      "marketplace": "wildberries",      "seller_id": "2557",      "name": "Sport Point",      "tin": "7722774359",      "psrn": "1127746307754",      "address": "117638, город Москва, вн.тер. г. муниципальный округ Зюзино, ул. Одесская, д. 2, помещ. 5/16",      "url": "https://www.wildberries.ru/seller/2557",      "stats": {        "rating": 4.7,        "reg_date": "2012-08-02",        "items_sold": 1347240,        "reviews_count": 282699      },      "product_count": 478,      "first_seen_at": "2026-08-01T00:57:26.975+00:00",      "last_seen_at": "2026-08-02T23:22:19.47+00:00"    }  ]}

List your scrape sessions GET

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.

Session completion webhook Webhook

We send this once a scrape session's status flips to `completed` — no polling needed. The payload is a pointer, not the merged data itself: fetch `url` (a normal `GET /me/scrapes/{id}/products` call, same Bearer auth, same daily quota) to actually retrieve it. Subscriptions are created from the extension's options page, not this API — see the [Webhooks guide](/en/docs/api/webhooks) for subscribing, signature verification, and retry behavior.