Krasnoeibeloe APIkrasnoeibeloe.ru ↗
Access Krasnoe & Beloe store data: search products, check stock levels, find shops by city with addresses and hours, and retrieve product XML IDs.
What is the Krasnoeibeloe API?
The Krasnoe & Beloe API covers 4 endpoints for querying Russia's largest alcohol retail chain, returning product search results, shop locations, and stock data. The search_products endpoint accepts keyword queries like 'вино' or 'виски' and returns product names, prices, and XML IDs. The get_shops endpoint delivers store addresses, GPS coordinates, and operating hours—including alcohol sale windows—for any city in the network.
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 numeric IDs and region associations. City IDs are used as input to get_shops. The full list is returned in a single response with no pagination.
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
},
{
"id": 1433,
"name": "Челябинск",
"regionId": 1430
}
]
},
"status": "success"
}
}About the Krasnoeibeloe API
Cities and Shops
The get_cities endpoint returns the complete list of cities served by Krasnoe & Beloe stores in a single, unpaginated response. Each city object includes a numeric id, a name, and a regionId that groups cities by region. City IDs feed directly into get_shops, which accepts an optional city_id parameter (defaulting to city 1433, Челябинск) and returns every store in that city. Shop records include id, num, address, cityId, lat, lng, and two time fields: workTime for general hours and alcTime for the hours during which alcohol can be sold—a legally required distinction in Russia.
Product Search
The search_products endpoint accepts a required query string—product names, categories, or keywords in Russian—and returns one page of matching products. Each product object carries an xml_id and product_id, name, price, amount, and an is_yellow flag that indicates whether the product is currently on promotion. The xml_id is the key link to get_product_details.
Product Details and Stock
The get_product_details endpoint takes a URL slug starting with /catalog/ (for example /catalog/vino/) and returns the full resolved url, the product's xml_id, the city_id detected from the page context, and a total_amount integer representing current stock. This is the endpoint to use when you need confirmed stock counts for a specific product rather than the summary figures returned by search.
The Krasnoeibeloe API is a managed, monitored endpoint for krasnoeibeloe.ru — not a raw scraper you maintain. Every endpoint is automatically health-checked on a schedule, and when krasnoeibeloe.ru 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 krasnoeibeloe.ru 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?+
- Build a stock checker that queries
search_productsby keyword and flags items whereamountdrops below a threshold - Map all Krasnoe & Beloe stores in a city using
latandlngfromget_shopsfor delivery-radius calculations - Filter stores by
alcTimeto find locations where alcohol can still be purchased at a given hour - Cross-reference
xml_idfrom search results withget_product_detailsto get confirmedtotal_amountbefore dispatching a purchase order - Enumerate all served cities via
get_citiesand aggregate store counts perregionIdfor regional coverage analysis - Track the
is_yellowflag on products over time to detect promotional pricing cycles
| 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 Krasnoe & Beloe have an official public developer API?+
What does `get_shops` return, and what happens if I omit `city_id`?+
city_id is omitted, the endpoint defaults to city 1433 (Челябинск) and returns all stores in that city. Each store object includes id, num, address, geographic coordinates (lat, lng), general working hours (workTime), and alcohol sale hours (alcTime). To query a different city, pass a numeric city ID obtained from get_cities.Does `search_products` return results across multiple pages?+
page or offset parameter available in the current API. You can fork this API on Parse and revise it to add pagination support if your use case requires deeper result sets.Can I look up which specific stores in a city have a product in stock?+
get_product_details returns a total_amount for the product and a city_id, but does not break stock down by individual store. get_shops lists stores but does not include per-product inventory. You can fork this API on Parse and revise it to add a store-level stock endpoint.What is the `is_yellow` field in search results?+
is_yellow is a boolean flag that indicates whether a product is currently marked as a promotional or discounted item on the Krasnoe & Beloe site. It can be used to filter search results to promotions only.