perekrestok.ru APIperekrestok.ru ↗
Access Perekrestok.ru product catalog, category tree, prices, and reviews via 5 endpoints. Search products, browse categories, and fetch product details.
curl -X GET 'https://api.parse.bot/scraper/7d6d56d1-a073-4e76-ad76-60c258b724a0/get_categories' \ -H 'X-API-Key: $PARSE_API_KEY'
Get full category tree or children of a specific category
| Param | Type | Description |
|---|---|---|
| parent_id | integer | Parent category ID (optional) |
{
"type": "object",
"fields": {
"content": "object"
},
"sample": {
"content": {
"items": [
{
"category": {
"id": 114,
"title": "Milk"
},
"products": []
}
],
"category": {
"id": 113,
"title": "Milk, Cheese, Eggs"
}
}
}
}About the perekrestok.ru API
The Perekrestok.ru API provides structured access to one of Russia's major supermarket chains across 5 endpoints, covering category navigation, product listings, product details, keyword search, and customer reviews. The get_product_details endpoint returns full product metadata including pricing for a given PLU code, while get_product_reviews exposes paginated shopper feedback for any product on the platform.
Category and Product Browsing
The get_categories endpoint returns the full category tree or, when a parent_id integer is supplied, only the direct children of that node. This lets you build a hierarchical menu or drill into a specific section of the catalog without fetching the entire tree every time. Once you have a category ID, get_category_products accepts that category_id (required) along with page and per_page parameters to retrieve a paginated product list for that category.
Product Details and Search
get_product_details takes a PLU code or product ID string and returns full details for that item — pricing, descriptions, and product attributes as exposed by the catalog. search_products accepts a query string and an optional page parameter, returning matching products across the catalog with the same structure as category-level listings. Both endpoints operate across the full product range available on perekrestok.ru.
Customer Reviews
get_product_reviews retrieves user-submitted reviews for a specific product, identified by its PLU code. Pagination is supported via page and per_page parameters, making it practical to fetch large review sets incrementally. The response content object contains reviewer feedback as recorded on the product page.
- Build a grocery price tracker that monitors price changes on specific PLU codes over time using
get_product_details. - Aggregate product assortment data by category using
get_categoriesandget_category_productsfor competitive analysis. - Index the full Perekrestok catalog for a grocery comparison site by iterating paginated results from
get_category_products. - Analyze customer sentiment on grocery products by scraping review text via
get_product_reviewswith pagination. - Power a product search feature in a meal-planning or shopping app using the
search_productsendpoint. - Map Perekrestok's category hierarchy for catalog normalization projects using
get_categorieswithparent_idtraversal. - Monitor new product introductions within a category by polling
get_category_productsand diffing results.
| 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 Perekrestok.ru offer an official public developer API?+
What does `get_product_details` return, and how is a product identified?+
plu parameter, which is the product's PLU code or numeric ID as used in the Perekrestok catalog. It returns a content object containing the product's full details — pricing, description, and product attributes. You can find a product's PLU from category listings or search results.Does the API return store-level availability or stock status by location?+
How does pagination work across the product and review endpoints?+
get_category_products and get_product_reviews both accept page and per_page integer parameters. search_products accepts a page parameter but does not expose a per_page override. If per_page is omitted on category or review endpoints, the API uses a default page size determined by the source.