Wildberries APIwildberries.by ↗
Search and retrieve product data from wildberries.by. Get prices in BYN, stock availability, brand, ratings, and images via two simple endpoints.
What is the Wildberries API?
The Wildberries.by API gives developers access to product and search data from Belarus's localized Wildberries storefront via 2 endpoints. get_product returns a full product card — name, brand, size variants with stock flags, all gallery images, and pricing in BYN — for any article ID. search_products returns a ranked page of results matching Russian-language keywords, with price filtering, category and color facets, and per-product review counts.
curl -X GET 'https://api.parse.bot/scraper/3043bd63-e885-4f46-8d10-f7ae6c6ecb5e/get_product?product_id=164105063' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns the product card for one wildberries.by article: name, brand, the displayed price in Belarusian rubles (formatted as shown on the site, e.g. one shape is "198,69 ƃ", and as a number), the crossed-out list price when present, the main product image URL (246x328 thumbnail) plus the full list of large image URLs, rating and review count, colors, the per-size list with stock availability and per-size price, and total quantity in stock. Prices are the Minsk-region delivery-inclusive prices and are taken from the first listed size. One upstream round trip for the card plus one for the image host routing table. A numeric article the site does not know yields a stale_input (input_not_found) error; a non-numeric value yields stale_input (input_format_invalid).
| Param | Type | Description |
|---|---|---|
| product_idrequired | string | Numeric Wildberries article (nomenclature id) as it appears in the product URL /catalog/<product_id>/detail.aspx. |
{
"type": "object",
"fields": {
"name": "product title as shown on the site",
"brand": "brand name",
"price": "displayed current price formatted like the site, with a non-breaking space and the ƃ currency symbol",
"sizes": "array of size variants: name (RU size label), orig_name (seller size label), option_id (integer variant id), in_stock (boolean), price_value (delivery-inclusive BYN price for that size)",
"colors": "array of color names",
"images": "array of URLs of all product photos in large size, in gallery order",
"rating": "average review rating (number)",
"currency": "ISO currency code of the prices (BYN)",
"supplier": "seller name",
"image_url": "URL of the main product image (246x328 webp); null when the card has no photos",
"old_price": "crossed-out list price formatted like the site; null when there is none",
"product_id": "string article, same form as the input",
"price_value": "current price as a decimal number of BYN",
"product_url": "canonical product page URL on wildberries.by",
"total_quantity": "total units in stock across sizes",
"feedbacks_count": "number of reviews",
"old_price_value": "list price as a decimal number of BYN; null when there is none"
},
"sample": {
"data": {
"name": "Косуха кожаная куртка укороченная",
"brand": "LOOKBALANCE",
"price": "198,69 ƃ",
"sizes": [
{
"name": "40-42",
"in_stock": true,
"option_id": 273421247,
"orig_name": "S",
"price_value": 198.69
}
],
"colors": [
"черный"
],
"images": [
"https://basket-11.wbbasket.ru/vol1641/part164105/164105063/images/big/1.webp",
"https://basket-11.wbbasket.ru/vol1641/part164105/164105063/images/big/2.webp"
],
"rating": 4.9,
"currency": "BYN",
"supplier": "LOOKBALANCE",
"image_url": "https://basket-11.wbbasket.ru/vol1641/part164105/164105063/images/c246x328/1.webp",
"old_price": "359,54 ƃ",
"product_id": "164105063",
"price_value": 198.69,
"product_url": "https://www.wildberries.by/catalog/164105063/detail.aspx",
"total_quantity": 43,
"feedbacks_count": 2742,
"old_price_value": 359.54
},
"status": "success"
}
}About the Wildberries API
What the API Covers
Both endpoints return data scoped to the Belarusian version of Wildberries (wildberries.by), with prices denominated in Belarusian rubles (BYN). Delivery pricing is calculated for Mozyr, Belarus, so price_value and price in search_products reflect delivery-inclusive costs as shown to local shoppers. The currency field in get_product always returns BYN.
get_product
Pass a numeric product_id — the article ID from a wildberries.by catalog URL (/catalog/<product_id>/detail.aspx) — and get back the product's name, brand, supplier, formatted price (e.g. "198,69 ƃ"), a sizes array with each variant's Russian and seller size labels plus an in_stock boolean, a colors array, all gallery images in large format, and the rating. The image_url field returns the 246×328 webp thumbnail or null when no photos are present.
search_products
search_products accepts a query string in Russian (e.g. "кардиган лаванда"), optional page and limit (1–100) for pagination, and optional sort, min_price_byn, max_price_byn, color, and category filters. The response includes a total count of results before local filters, total_pages, a has_more flag, and a sort_applied boolean that indicates whether the site honored the requested sort or fell back to a fixed keyword ranking. available_colors and available_categories are populated only when a color or category filter is provided, reflecting the facet values the site publishes for that query.
Pagination and Filtering Notes
The total field counts results in the site's ranked stream before Belarus availability and client-side filters are applied, so the number of products actually returned across all pages may be lower. Color and category filtering is matched case-insensitively against the site's own vocabulary; passing an unrecognized value will return no matches rather than an error.
The Wildberries API is a managed, monitored endpoint for wildberries.by — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when wildberries.by changes and a check fails, the API is automatically queued for repair and re-verified. It is built to keep working as the site underneath it changes.
This isn't an official wildberries.by API — it's an independent, maintained REST wrapper over public data. Where the source has no official API (or only a limited one), Parse gives you a stable contract over a source that never promised one, and keeps it current. Need a new endpoint or field? You can revise it yourself in plain English and the agent rebuilds it against the live site in minutes — contributing the change back to the shared API is free.
Will this API break when the source site changes?+
Is this an official API from the source site?+
Can I fix or extend this API myself if I need a new endpoint or field?+
What happens if I call an endpoint that has an issue?+
- Track BYN price changes and crossed-out list prices for specific Wildberries.by articles using get_product.
- Build a product search feed for a Belarus-focused price comparison tool using search_products with min_price_byn and max_price_byn filters.
- Monitor stock availability across size variants (in_stock per size) for apparel products on wildberries.by.
- Aggregate brand and supplier data from search result pages to analyze seller presence on the Belarusian marketplace.
- Pull gallery images and ratings from get_product to populate a product catalog or affiliate listing.
- Filter search results by category and color to surface relevant products for niche Belarusian retail verticals.
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 200 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 100 req/min |
| Team | $300/mo | 20,000 | 300 req/min |
| Company | $1,000/mo | 100,000 | 500 req/min |
Each endpoint has a fixed posted price per successful call — most fall between 1 and 10 credits — shown on this API's page before you run it. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Wildberries have an official developer API?+
What does the sizes array in get_product actually contain?+
name (the Russian size label shown to buyers), orig_name (the seller's own size label), an integer option_id identifying the variant, and an in_stock boolean. This lets you determine which specific sizes are currently available without checking each variant separately.Does search_products return seller review counts or review text?+
review_count per product card alongside the rating. Full review text and individual reviewer data are not returned by either endpoint. You can fork this API on Parse and revise it to add a review-fetching endpoint if that data is needed.Are available_colors and available_categories always populated in search results?+
color or category parameter is included in the request. A plain keyword search without those filters returns empty arrays for both fields. To discover valid filter vocabulary for a given query, make one request with a color or category value and read the available options from the response.