krasnoeibeloe.ru APIkrasnoeibeloe.ru ↗
Access Krasnoe & Beloe store data: search products, find shops by city, check stock availability, and retrieve product details via 5 structured endpoints.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/84697562-2fbd-4625-a235-9d637cc0be38/get_cities' \ -H 'X-API-Key: $PARSE_API_KEY'
Returns all cities served by Krasnoe & Beloe stores, including their IDs and region associations. Use city IDs from this endpoint as input to get_shops.
No input parameters required.
{
"type": "object",
"fields": {
"cities": "array of city objects with id, name, and regionId"
},
"sample": {
"data": {
"cities": [
{
"id": 778,
"name": "Белгород",
"regionId": 777
},
{
"id": 784,
"name": "Брянск",
"regionId": 783
}
]
},
"status": "success"
}
}About the krasnoeibeloe.ru API
The Krasnoe & Beloe API exposes 5 endpoints covering the full shopping workflow for Russia's largest alcohol retail chain: search products by keyword, retrieve city and shop locations, and check per-store stock availability. The search_products endpoint returns XML IDs, prices, and discount flags, which feed directly into get_product_details and get_product_stock for deeper lookups.
Product Search and Details
The search_products endpoint accepts a Russian-language keyword (e.g. вино, виски, пиво) and returns an array of product objects containing xml_id, product_id, price, amount, and an is_yellow flag that indicates whether the item is on a yellow-tag discount. The xml_id field is the key linking field across multiple endpoints. get_product_details accepts a /catalog/... URL slug and resolves the full product URL, its xml_id, the detected city_id, and a total_amount aggregating stock across all stores.
Store Locations
get_cities returns every city served by Krasnoe & Beloe, with each city object carrying an id, human-readable name, and regionId. These city IDs are the required input for get_shops, which returns store-level detail: id, shop number (num), address, cityId, latitude (lat), longitude (lng), general working hours (workTime), and alcohol sale hours (alcTime) — a legally mandated window that varies by Russian region.
Stock Availability
get_product_stock takes an xml_id (from either search_products or get_product_details) and an optional city_id to return per-shop availability for a product. Note that this endpoint is frequently blocked by Yandex SmartCaptcha on the source site, which can result in empty or restricted responses. Plan for retry logic or fallback behavior when consuming this endpoint at scale.
Connecting the Endpoints
A typical workflow: call get_cities to resolve a city ID, call get_shops to enumerate stores in that city, run search_products to find a product's xml_id, then pass both to get_product_stock to determine which specific shops carry the item.
- Find which Krasnoe & Beloe shops in a given city carry a specific wine or whisky using
get_product_stockwith a city ID. - Build a price-monitoring tool for discounted items by filtering
is_yellowresults fromsearch_products. - Map all store locations in a region by combining
get_citiesandget_shopswith the returnedlat/lngcoordinates. - Determine alcohol sale hours for a specific store using the
alcTimefield fromget_shopsbefore planning a visit. - Resolve a product's canonical URL and aggregate stock figure using
get_product_detailsfrom a catalog slug. - Automate stock alerts for a product across multiple cities by iterating city IDs into
get_product_stock.
| 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 Krasnoe & Beloe have an official public developer API?+
What does `get_shops` return beyond an address?+
get_shops returns a shop object with id, shop number (num), address, cityId, latitude (lat), longitude (lng), general working hours (workTime), and alcTime — the alcohol sale window required by Russian retail law. The city_id parameter is optional; omitting it may return shops across all cities.How reliable is `get_product_stock`?+
xml_id from search_products or get_product_details and pairing it with a specific city_id gives the best chance of a complete response.Does the API return product reviews, ratings, or historical price data?+
price, amount, is_yellow), stock availability, and store location data. You can fork this API on Parse and revise it to add an endpoint targeting product review or price history pages if that data is present on the site.Can I retrieve products for a specific city directly from `search_products`?+
search_products does not accept a city_id filter — it returns results without city scoping. To narrow results to a city, pass the xml_id from search results into get_product_stock along with a city_id from get_cities. You can fork the API on Parse and revise search_products to add city filtering if the source surface supports it.