wildberries.ru APIwildberries.ru ↗
Search Wildberries products, retrieve pricing, specifications, reviews, and autocomplete suggestions via 5 structured JSON endpoints.
curl -X GET 'https://api.parse.bot/scraper/d8958dae-43df-4c7c-91a5-a228966c5315/search_products?page=1&query=samsung' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products on Wildberries by keyword. Returns a paginated list of products with basic metadata and pricing. Results are returned 100 per page.
| Param | Type | Description |
|---|---|---|
| page | integer | Page number for pagination |
| sort | string | Sort order: popular, priceup, pricedown, rate, newly |
| queryrequired | string | Search keyword (e.g. 'iphone', 'samsung', 'платье') |
{
"type": "object",
"fields": {
"page": "integer current page number",
"total": "integer total number of matching products",
"products": "array of product objects with product_id, imt_id, name, brand, brand_id, rating, review_count, current_price, original_price, discount_percent, supplier, supplier_id"
},
"sample": {
"data": {
"page": 1,
"total": 30642,
"products": [
{
"name": "iPhone 16 128GB",
"brand": "Apple",
"imt_id": 485487229,
"rating": 5,
"brand_id": 6049,
"supplier": "Wildberries",
"product_id": 482257005,
"supplier_id": 4600133,
"review_count": 246,
"current_price": 54595,
"original_price": 129990,
"discount_percent": 58
}
]
},
"status": "success"
}
}About the wildberries.ru API
The Wildberries API provides 5 endpoints to query Russia's largest e-commerce marketplace — covering product search, detailed product cards, technical specifications, customer reviews, and autocomplete suggestions. The search_products endpoint returns up to 100 results per page with pricing, brand, rating, and review count. The get_product_reviews endpoint surfaces per-review data including date, rating, comment text, and photo count.
Product Search and Pricing
The search_products endpoint accepts a required query string (supports both Latin and Cyrillic, e.g. 'платье' or 'iphone') and returns a paginated list with up to 100 products per page. Each product object includes product_id, imt_id, name, brand, brand_id, current_price, original_price, disc (discount), rating, and review_count. The optional sort parameter accepts popular, priceup, pricedown, rate, or newly, and page controls pagination. Prices are only exposed through this endpoint — not through the product card endpoint.
Product Details and Specifications
get_product_details accepts a product_id (the article number) and returns the full product card: name, brand, description, subj_name (category), rating, review_count, and the imt_id needed to query reviews. Note that current_price and original_price are null from this endpoint — cross-reference search_products if pricing is required. get_product_specifications uses the same product_id input and returns grouped spec data as an array of objects, each containing a group_name and an options array of name/value pairs — useful for attribute extraction and comparison.
Reviews and Suggestions
get_product_reviews requires an imt_id, which is the root product ID returned by both search_products and get_product_details. The response includes a reviews array where each entry carries user_name, date, rating, comment, and photos_count, plus a total_count integer. The get_search_suggestions endpoint accepts a partial or complete keyword and returns a suggests array with type and name fields — types include direct suggestions, brand matches, and tag suggestions — making it useful for building search-assist features or keyword research tools.
- Monitor price drops and discount percentages (
discfield) across keyword searches on Wildberries - Build a product comparison tool using specifications from
get_product_specificationsgrouped options - Aggregate customer sentiment by pulling review
ratingandcommentfields viaget_product_reviews - Track brand presence and rating distribution across category searches using
search_productswithsort=rate - Extract product category (
subj_name) and description data for catalog enrichment viaget_product_details - Implement autocomplete or keyword suggestion features using
get_search_suggestionstype-ahead responses - Count review photo attachments (
photos_count) as a proxy for review depth across product listings
| Tier | Price | Credits/month | Rate limit |
|---|---|---|---|
| Free | $0/mo | 100 | 5 req/min |
| Hobby | $30/mo | 1,000 | 20 req/min |
| Developer | $100/mo | 5,000 | 250 req/min |
One credit = one API call regardless of which marketplace API you call. Exceeding the rate limit returns a 429 response. Authenticate with the X-API-Key header.
Does Wildberries have an official public developer API?+
Why is pricing unavailable from `get_product_details`?+
current_price or original_price — those fields return null. To retrieve pricing and discount data for a known product, run search_products with the product name or brand as the query and match on product_id.How do I connect reviews to a specific product?+
get_product_reviews uses imt_id, not product_id. The imt_id is the root grouping ID and appears in both the search_products product objects and the get_product_details response. A single imt_id may aggregate reviews across product variants.Does the API cover seller profiles or seller-level metrics?+
Is there a way to retrieve all reviews, or only the first page?+
get_product_reviews returns a total_count integer alongside the reviews array, but the endpoint does not currently expose pagination parameters for fetching subsequent pages of reviews. You can fork this API on Parse and revise it to add page-based or offset pagination for the reviews endpoint.