5ka.ru API5ka.ru ↗
Access Pyaterochka's product catalog, real-time pricing, nutritional info, special offers, and store locations via the 5ka.ru API.
No input parameters required.
curl -X GET 'https://api.parse.bot/scraper/aae3e5f6-fa2a-444d-9fb9-c4bbdf7aced1/get_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Fetch all top-level product categories.
No input parameters required.
{
"type": "object",
"fields": {
"next": "string (nullable)",
"count": "integer",
"results": "array of objects (id, parent_group, name, image_url)",
"previous": "string (nullable)"
},
"sample": {
"next": null,
"count": 100,
"results": [
{
"id": 1,
"name": "Milk & Eggs",
"image_url": "https://...",
"parent_group": null
}
],
"previous": null
}
}About the 5ka.ru API
The 5ka.ru API covers Pyaterochka's grocery catalog across 5 endpoints, giving you access to product listings, category trees, per-product nutritional values, active promotions, and physical store locations. The get_products endpoint accepts keyword search, category filtering, price sorting, and store-scoped queries, while get_product_detail returns per-100g macronutrient breakdowns including proteins, fats, carbohydrates, and calories.
Product Catalog and Search
The get_products endpoint returns a paginated list of Pyaterochka products. You can filter by category_code, pass a free-text query for keyword search, sort with order_by (e.g. price or -price), and scope results to a specific store using its SAP code via store_id. Responses include product id, name, price, and a nutritional_value object. Pagination is handled through page and limit parameters, with next and previous cursor URLs returned alongside a total count.
Product Detail and Nutrition
get_product_detail accepts a single product_id (PLU code) and returns the full record for that item: id, name, price, and a structured nutritional_value object containing proteins, fats, carbohydrates, and calories. This makes it suitable for building nutrition-tracking applications or enriching a product database with macro data at scale.
Categories, Promotions, and Stores
get_categories returns the full top-level category tree, where each entry includes an id, optional parent_group, name, and image_url. The category_code returned here maps directly to the filter parameter on get_products. get_special_offers exposes products currently under promotion, returning both the regular price and a promo_price for each item; results can be filtered by store_id and paginated. get_stores returns a list of Pyaterochka locations with each store's id, address, city, and geographic coordinates (lat, lon).
- Build a grocery price tracker that monitors Pyaterochka product prices and flags drops using
get_productswithorder_by=price. - Power a nutrition calculator app by pulling per-product macronutrient data (proteins, fats, carbohydrates, calories) from
get_product_detail. - Aggregate active promotional deals across stores using
get_special_offersfiltered bystore_idto compare promo prices. - Populate a store-locator feature with Pyaterochka branch addresses and GPS coordinates from
get_stores. - Synchronize a category-browse interface by mapping
get_categoriesresults to product listings via thecategory_codefilter onget_products. - Alert users to weekly promotions by diffing
get_special_offersresponses over time and surfacing newpromo_priceentries. - Research grocery assortment by querying
get_productswith a keyword and paginating through results to collect SKU-level data.
| 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 5ka.ru have an official public developer API?+
What does `get_special_offers` return, and can I filter it by region?+
get_special_offers returns products currently on promotion, including both the regular price and the discounted promo_price for each item. You can filter results to a specific store by passing its SAP code as store_id, which effectively gives you store-scoped deal data. Pagination is available via page and limit.Does the API expose product reviews, ratings, or user-generated content?+
Can I look up stores by city or geographic bounding box?+
get_stores returns all store locations at once with lat and lon fields for each record, but it does not accept filter parameters for city or geographic bounds. Client-side filtering by city name or proximity math against the coordinates is needed. You can fork the API on Parse and revise to add server-side geo filtering if needed.How fresh is the pricing and promotional data?+
get_special_offers regularly is advisable if you need timely deal data.