API Endpoints
Every Market Ninja API method: products, price history, sellers, categories, brands, your scrape sessions, and webhooks.
Every method of the Market Ninja API. The base URL is https://data.marketninja.ru/v1, and
every request needs an Authorization: Bearer mn_live_... header (see the
API Overview). Each method's page lists its parameters, an example
response, and a form for sending a test request.
| Method | Path | Description |
|---|---|---|
| GET | /products | List products |
| GET | /products/{id} | Get a product by ID |
| GET | /products/{id}/price-history | Get product price history |
| GET | /sellers | List sellers |
| GET | /categories | List categories |
| GET | /brands | List brands |
| GET | /me/scrapes | List your scrape sessions |
| GET | /me/scrapes/{id} | Get one scrape session's status |
| GET | /me/scrapes/{id}/products | Get a scrape session's products |
| Webhook | scrapeSessionCompleted | Session completion webhook |
Last updated on
Webhooks
Asynchronous notifications when a scrape session finishes, instead of polling the API — subscribing, verifying delivery, and an n8n integration example.
List brands GET
`marketplace` is optional here, unlike `GET /categories` — a brand is the same real-world entity across marketplaces, so an unscoped list (a brand's total footprint across every site) is meaningful, unlike an unscoped category list, which would mix unrelated per-site taxonomies together. This endpoint doesn't count against your daily data quota — only the per-minute rate limit. It's a lookup endpoint for navigation, not a data export, so it can never return `quota_exceeded`. This is a precomputed daily snapshot, not a live query — expect it to lag same-day scrapes by up to 24 hours.