Workflows
Brands
Listing brands and pulling a brand's entire catalog via the brand filter
Finding a brand
GET /brands returns a list of distinct brand names with a product count for each.
Unlike GET /categories, marketplace is optional — a brand name doesn't change
between marketplaces, so a dataset-wide list is meaningful too.
GET /brands and GET /categories don't count against your daily data quota — only the per-minute rate limit. They're lookup endpoints for navigation, not a data export, so call them freely without worrying about your remaining quota.curl -G -H "Authorization: Bearer mn_live_..." \
"https://data.marketninja.ru/v1/brands"{
"data": [
{ "brand": "Nike", "product_count": 892 },
{ "brand": "Adidas", "product_count": 654 }
]
}To scope it to one marketplace, add marketplace:
curl -G -H "Authorization: Bearer mn_live_..." \
"https://data.marketninja.ru/v1/brands" \
--data-urlencode "marketplace=wildberries"Getting a brand's full catalog
Once you know the exact brand name, use it as the brand filter on GET /products to
pull its entire current assortment. The match is exact but case-insensitive — unlike
q, this is not a substring search.
curl -G -H "Authorization: Bearer mn_live_..." \
"https://data.marketninja.ru/v1/products" \
--data-urlencode "brand=Nike" \
--data-urlencode "page_size=100"To scope it to one marketplace, add marketplace:
curl -G -H "Authorization: Bearer mn_live_..." \
"https://data.marketninja.ru/v1/products" \
--data-urlencode "brand=Nike" \
--data-urlencode "marketplace=wildberries" \
--data-urlencode "page_size=100"brand is its own parameter, separate from seller_code (see Finding products): seller_code finds one specific SKU of yours wherever it's resold, while brand finds your entire catalog in the dataset, regardless of SKU.Last updated on