Every Wildberries product with every size's price and stock, in eight countries
The Wildberries API turns wildberries.ru, Russia's largest marketplace, into clean JSON in eight actions: search, category/products, categories, product/detail, product/reviews, seller/detail, seller/products and suggest.
8 active endpoints. Every call is 1 credit.
- POST/wildberries/v1/search
- POST/wildberries/v1/category/products
- POST/wildberries/v1/categories
- POST/wildberries/v1/product/detail
- POST/wildberries/v1/product/reviews
- POST/wildberries/v1/seller/detail
- POST/wildberries/v1/seller/products
- +1 more
What Wildberries endpoints does ReefAPI ship?
8 live read endpoints. Read-only data API: no writes, no account actions, no dashboard access on the target site.
Wildberries API
3 of 8 endpoints, ready to run
100 Wildberries products for a keyword in one country: article number, title, brand, seller, image, the price you pay, struck price and discount, stock, rating, review count and delivery time.
{ "ok": true, "meta": { "api": "wildberries", "endpoint": "search", "mode": "live", "latency_ms": 4691, "record_count": 89, "cache_hit": false }, "data": { "results": [ { "position": 1, "product_id": 1284404426, "root_id": 299389022, "title": "Кроссовки SPEEDCROSS 3 походные и трейловый бег", "brand": "SALOMON", "brand_id": 1707, "seller": { "id": 1199062, "name": "Hit Shoes", "rating": 4.6 }, "url": "https://www.wildberries.ru/catalog/1284404426/detail.aspx", "image": "https://basket-45.wbbasket.ru/vol12844/part1284404/1284404426/images/big/1.webp", "image_count": 5, "price": 34510, "was_price": 51470, "discount_percent": 34, "price_max": 34660, "currency": "KZT", "price_before_logistics": 33540, "logistics_fee": 970, "available": true, "stock_quantity": 2, "size_count": 2, "colours": [ "черный" ], "rating": 5, "rating_scale": 5, "review_count": 1, "category_id": 105, "parent_category_id": 2, "delivery_hours": 110, "is_new": false, "review_reward_points": null, "price_source": "live" }, { "position": 2, "product_id": 1007158002, "root_id": 1877095409, "title": "Кроссовки Найк SB Dunk Low 46-49 универсал", "brand": "Nike", "brand_id": 671, "seller": { "id": 250127326, "name": "CCDFE.LKOP", "rating": 4.7 }, "url": "https://www.wildberries.ru/catalog/1007158002/detail.aspx", "image": "https://basket-41.wbbasket.ru/vol10071/part1007158/1007158002/images/big/1.webp", "image_count": 11, "price": 24490, "was_price": 186630, "discount_percent": 87, "price_max": 24510, "currency": "KZT", "price_before_logistics": 23930, "logistics_fee": 560, "available": true, "stock_quantity": 38, "size_count": 4, "colours": [ "коричневый" ], "rating": 5, "rating_scale": 5, "review_count": 1, "category_id": 105, "parent_category_id": 2, "delivery_hours": 166, "is_new": false, "review_reward_points": null, "price_source": "live" }, { "position": 3, "product_id": 1195886004, "root_id": 26366486, "title": "Демисезонные кроссовки повседневные", "brand": "X-Plode", "brand_id": 28826, "seller": { "id": 49080, "name": "X-plode, Shuzzi", "rating": 4.9 }, "url": "https://www.wildberries.ru/catalog/1195886004/detail.aspx", "image": "https://basket-44.wbbasket.ru/vol11958/part1195886/1195886004/images/big/1.webp", "image_count": 11, "price": 21890, "was_price": 63480, "discount_percent": 66, "price_max": 22110, "currency": "KZT", "price_before_logistics": 21030, "logistics_fee": 860, "available": true, "stock_quantity": 24, "size_count": 9, "colours": [ "черный" ], "rating": 5, "rating_scale": 5, "review_count": 1, "category_id": 105, "parent_category_id": 2, "delivery_hours": 153, "is_new": true, "review_reward_points": null, "price_source": "live" } ], "count": 89, "page": 1, "page_size": 100, "total_results": null, "total_pages": null, "has_more": true, "query": "кроссовки", "query_corrected_to": null, "ranking_source": "ru_index", "unavailable_in_country_dropped": 11, "index_only_rows": 0, "sort_applied": "popular", "ignored_params": [], "applied_filters": { "price_min": null, "price_max": null, "brand_ids": [], "seller_ids": [] }, "available_filters": null, "fallback_results_dropped": 0, "fallback_results": [], "sponsored_dropped": 0, "duplicate_rows_dropped": 0, "page_notice": null, "country": { "code": "kz", "name": "Kazakhstan", "currency": "KZT", "delivery_city": "Almaty", "delivery_zone": 234 } } }
How the Wildberries API works
Wildberries is a normal ReefAPI surface — the same four rules that hold for every other engine on the key.
No OAuth app, no request signing, no per-site account. One key covers all 256 engines.
Every route is a POST with a JSON body. Parameters are validated against the published schema before anything is charged.
Credits, not seats. Failed and blocked calls are never charged, and cache hits cost nothing.
One envelope everywhere. meta carries latency_ms, record_count and the endpoint that answered.
Find a product, then read every size's price and stock in Kazakhstan
A row gives the cheapest size. The second call returns each size and colour with its own price and stock for the country you pass.
{"query": "кроссовки", "country": "kz", "brand_ids": "671", "sort": "price_asc"}100 Nike rows in tenge, cheapest first. Take results[].product_id; price already includes the delivery surcharge.
{"product_id": "<results[0].product_id>", "country": "kz"}sizes[] with price, was_price, logistics_fee and stock_quantity each; variants[] with the other colours and their prices; sold_in_country says whether any size can be bought there.
Size-level prices and stock for one country in two calls, with the delivery surcharge and the struck price kept apart from what you pay.
curl -X POST https://api.reefapi.com/wildberries/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"кроссовки"}'{
"ok": true,
"data": { … },
"meta": {
"api": "wildberries",
"endpoint": "search",
"mode": "live",
"latency_ms": …,
"record_count": …
},
"error": null
}Which Wildberries price is the one you pay
A Wildberries offer has a struck price, a sale price and, outside Russia on most offers, a delivery surcharge that is part of the price. price is the total you pay; price_before_logistics and logistics_fee show the split; was_price and discount_percent are the struck price as the seller shows it.
| Product | Country | price | struck / split |
|---|---|---|---|
| Glass electric kettle 1.8 l (159500775) | Russia | 916 RUB | was 2,770 · −67% |
| Evening dress (1332433075) | Belarus | 238.59 BYN | includes 22.87 BYN logistics |
| Evening dress (1332433075) | Georgia | 187.78 GEL | includes 1.94 GEL logistics |
| Initiator sneakers (1345767714) | Kazakhstan | 20,500 KZT | was 68,780 · includes 730 KZT logistics |
| Kettle with whistle (419643767) | Armenia | 9,590 AMD | was 24,180 · includes 1,270 AMD logistics |
Wildberries' own price sorting follows the total including logistics in every country checked, so that is what price means here. A price that a signed-in buyer sees after a WB Wallet discount is not published to anonymous visitors and has no field.
Which markets, which price, how deep, and what Wildberries leaves out
Measured on 2026-09-16 across 37 searches, 18 category listings, 30 product records in 8 countries and 7 products compared against Wildberries' own product data. Some of these lines go against us.
country takes ru, kz, by, am, kg, uz, tj or ge. Offers, stock and prices are those for delivery to the capital, in RUB, KZT, BYN, AMD, KGS, UZS, TJS or GEL. What is on sale differs: 19 of 100 Russian sneaker results were not offered in Kazakhstan. Azerbaijan is not available.
Outside Russia most offers include a delivery surcharge; price includes it, price_before_logistics and logistics_fee show the split, and Wildberries' own price sorting follows the same total. was_price and discount_percent are the seller's struck price. On 7 products compared, price, stock, rating and review count matched 7 of 7.
Each size has its own price and stock. A row's price is the cheapest size and price_max the dearest; product/detail lists them all, and variants lists the other colours with their prices.
For broad keywords in Kazakhstan, Belarus, Armenia and Georgia, results are ranked from Wildberries' Russian search and priced for your country, with products not sold there removed (18 to 28 of 100 in our run); ranking_source says so and total_results is null. Specific keywords and brand- or seller-filtered searches use the country's own order.
Wildberries serves 3 pages of 100 for a keyword; the API stops there rather than repeat page 1. On broad keywords it applies sort and price only with a brand or seller filter, and the API reports ignored_params instead of pretending. Category and seller listings apply every sort and filter, to page 50.
When Wildberries answers a query it cannot match with unrelated products, the API returns an empty result and counts them in fallback_results_dropped; include_fallback_results returns them separately. Keyboard-layout and typo fixes are kept and reported in query_corrected_to (ghbdtn became привет).
Wildberries publishes no GTIN, caps its stock figures, and shows the WB Wallet price and order counts only to signed-in buyers, so those are not here. Reviews: full star counts, but only the latest ~1,000 texts (1,045 of 51,166 for one kettle). Price history is weekly and in roubles.
What people build with Wildberries
The jobs this data is most often used for.
endpoints
credit per call
Brands and distributors track their products' price, discount and stock on Wildberries in Russia and the neighbouring markets.
Sellers watch competing listings, their size-by-size stock and their review scores.
Market researchers pull category listings with Wildberries' sorts and price filters in eight currencies.
Pricing teams read the weekly price history and the struck-price discounts sellers publish.
What Wildberries data costs
The cheapest call here is 1 credit, so $15/mo (Pro) buys 10,000 of them — $1.50 per 1,000 credits. Credits roll over and never expire, and failed or blocked calls are not charged.
Full pricing →- 1,000 free credits on signup, no card
- One key, all 256 APIs, one credit pool
- Failed and blocked calls are never charged
- Credits roll over and never expire
Call it in two lines
Sign up, get 1,000 credits and one key that works on every engine. Then this is the whole protocol.
curl -X POST https://api.reefapi.com/wildberries/v1/search \
-H "x-api-key: $REEF_KEY" \
-H "content-type: application/json" \
-d '{"query":"кроссовки"}'import requests
r = requests.post(
"https://api.reefapi.com/wildberries/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"query": "кроссовки"
},
)
print(r.json()["data"])Have a question? We got answers.
The questions people actually ask before wiring up Wildberries.
Get a free key →Which countries are covered, and does the country change more than the currency?▾
Russia, Kazakhstan, Belarus, Armenia, Kyrgyzstan, Uzbekistan, Tajikistan and Georgia. The country changes what is on sale, not only the currency: the same iPhone listed in Russia was not sold to Kazakhstan, and in a sneaker search 19 of the 100 Russian results were not offered in Kazakhstan. Prices come back in KZT, BYN, AMD, KGS, UZS, TJS or GEL, and sellers can price a country differently. Azerbaijan is not available.
Is the order of search results the same in every country?▾
In Russia, Kyrgyzstan, Uzbekistan and Tajikistan you get Wildberries' own result order for that country. For broad keywords in Kazakhstan, Belarus, Armenia and Georgia the answer is ranked from Wildberries' Russian results and priced for your country, with the products not sold there left out; ranking_source says which one you got. Brand- or seller-filtered searches and specific keywords return the country's own order everywhere.
Why can't I sort a keyword search by price?▾
Wildberries itself applies a sort to broad keywords only when a brand or seller filter is set. Without one the API tells you in ignored_params instead of re-sorting a page. With brand_ids set, price_asc came back with 0 order errors; category/products and seller/products apply all six sorts and the price filter directly.
How many results can I page through?▾
A keyword search gives 3 pages of 100 products, which is what Wildberries serves; later pages repeat the first one, so page is limited to 3. Category and seller listings go to page 50. On 2026-09-16 the three pages of a dress search had no product in common.
Are stock numbers exact?▾
They are what Wildberries publishes, and Wildberries caps them: large stocks come back as a ceiling such as 43, so treat a high number as plenty rather than a count. Each size has its own stock figure next to its own price.
How many reviews do I get?▾
The full star breakdown and counts for every product, and the latest reviews Wildberries publishes, about 1,000 per product: 1,045 of 51,166 for a popular kettle. Reviews are shared across a product's colour variants; each carries its product_id and this_variant_only keeps one. Reviewer names are never returned.
What does Wildberries not publish?▾
No barcodes, no exact stock, no WB Wallet price, no order counts and no sponsored-placement flag on the data it serves to anonymous visitors, so there are no such fields. Price history is weekly and in roubles only. Individual entrepreneurs' registered addresses are left out.
What is the Wildberries API?▾
Wildberries API is a ReefAPI endpoint group for russia's largest marketplace plus 7 neighbouring markets: products, every size's price and stock, reviews. It returns live JSON through POST requests under /wildberries/v1.
Is the Wildberries API free to try?▾
Yes. ReefAPI starts with 1,000 free credits, no card required. Wildberries calls use the same shared credit balance as every other ReefAPI engine.
Do I need a Wildberries login or account?▾
No login to Wildberries is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.
How fresh is the Wildberries data?▾
The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.
How many credits does the Wildberries API use?▾
Wildberries actions currently cost 1 credit per successful call. Failed or blocked calls are free. All APIs draw from one credit pool.
Can I call Wildberries from an AI assistant or MCP client?▾
Yes. Connect ReefAPI once through MCP and your assistant can call wildberries actions with the same key, credit pool and JSON envelope used by normal REST requests.
Is the Wildberries API a Wildberries scraper?▾
It is the managed alternative to a DIY Wildberries scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same russia's largest marketplace plus 7 neighbouring markets: products, every size's price and stock, reviews back as clean JSON.
94 E-commerce & Marketplaces APIs on the same key
One key, one credit pool, one response envelope. If you are pulling Wildberries, you are one call away from the rest of the category — no second contract, no second integration.
Need something this API does not do?
Name the endpoint, the field, or a source we do not carry yet. We ship new APIs every week and you would be first to get the key. Real people read every message and reply the same day.
Try it on your own data before you pay anything
The call above is the real endpoint, not a recording. A free key gives you 1,000 credits, the other 255 APIs, and the same envelope everywhere.
Endpoints, parameters and credit costs on this page are read from the live catalog and cannot drift from what the API accepts. Field notes were captured on 2026-09-16.