vkusvill.ru APIvkusvill.ru ↗
Access VkusVill grocery data via API: product catalog, search, offers, reviews, and full nutritional details across all store categories.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/b9ba7d60-a502-4207-a42e-b468f034570f/get_catalog_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Retrieves all top-level product categories from the VkusVill catalog. Returns category names, slugs, and URLs.
No input parameters required.
{
"type": "object",
"fields": {
"categories": "array of category objects, each with name, url, and slug"
},
"sample": {
"data": {
"categories": [
{
"url": "https://vkusvill.ru/goods/sladosti-i-deserty/",
"name": "Сладости, десерты",
"slug": "sladosti-i-deserty"
},
{
"url": "https://vkusvill.ru/goods/gotovaya-eda/",
"name": "Готовая еда",
"slug": "gotovaya-eda"
}
]
},
"status": "success"
}
}About the vkusvill.ru API
The VkusVill API covers 6 endpoints for accessing product catalog data from VkusVill, a Russian grocery retailer. Use search_products to query items by name and receive fields like price, weight, rating, and labels, or call get_product_detail to retrieve full ingredient lists, nutritional information (белки, жиры, углеводы, ккал), and review counts for any individual product.
Product Search and Catalog
The search_products endpoint accepts a required query string in Russian (e.g. молоко) and an optional page integer for pagination. Each result includes the product's id, name, price, weight, rating, labels, and url. The get_catalog_categories endpoint returns all top-level store categories, each with a name, url, and slug — the slug feeds directly into other endpoints.
Offers and Discounts
get_all_offers returns the full set of currently active discounted products across every category, using the same product card shape as search results. If you want to narrow results, get_offers_by_category accepts a category_slug parameter (e.g. morozhenoe or molochnye-produkty-yaytso) sourced from get_catalog_categories. Both offer endpoints return id, name, price, weight, rating, labels, and url.
Product Detail and Reviews
get_product_detail takes a product_slug (e.g. moloko-3-2-1-l-173.html) and returns the full product record: name, price, weight, rating, description, ingredients, reviews_count, and a nutritional_info object with protein, fat, carbohydrate, and calorie values. get_product_reviews accepts a numeric product_id and optional page, returning up to 10 reviews per page with author, rating, date, and text fields.
- Track price changes on specific VkusVill products by polling
search_productsorget_product_detailover time. - Build a discount alert tool using
get_all_offersto monitor active promotions across all categories. - Filter current offers by grocery category using
get_offers_by_categorywith slugs fromget_catalog_categories. - Aggregate nutritional data (calories, protein, fat, carbs) from
get_product_detailfor dietary analysis. - Analyze customer sentiment by collecting review text and ratings via
get_product_reviewsacross multiple product IDs. - Populate a product comparison tool with ingredient lists and nutritional info from
get_product_detail. - Index the full VkusVill category tree using
get_catalog_categoriesto build navigation or category-level reporting.
| 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 VkusVill have an official developer API?+
What does get_product_detail return beyond basic product info?+
get_product_detail returns the full product record including a description, an ingredients string, reviews_count, and a nutritional_info object containing белки (protein), жиры (fat), углеводы (carbohydrates), and ккал (calories). It requires a product_slug formatted like moloko-3-2-1-l-173.html, which you can obtain from search_products or offer listing results.How many reviews does get_product_reviews return per call?+
page parameter to paginate through additional reviews. The count field in the response reflects how many reviews were returned on that specific page, not the total review count for the product.Does the API support filtering products by category or price range?+
get_offers_by_category. General product search through search_products does not support category or price-range filters — it returns results matching the text query across all categories. You can fork this API on Parse and revise it to add a category-filtered product browsing endpoint.