online.metro-cc.ru APIonline.metro-cc.ru ↗
Search products, browse categories, and fetch product details from METRO Cash & Carry Russia. Get prices, brands, SKUs, and availability in structured JSON.
curl -X GET 'https://api.parse.bot/scraper/ba9addab-532a-49fd-b208-eb610b8ff6c0/search_products?limit=5&query=%D0%BA%D0%BE%D1%84%D0%B5' \ -H 'X-API-Key: $PARSE_API_KEY'
Search for products by keyword and return detailed information including price, brand, country of origin, and product type. Only returns products whose names contain the query. Paginates internally up to 5 pages to fill the requested limit.
| Param | Type | Description |
|---|---|---|
| limit | integer | Maximum number of products to return |
| queryrequired | string | Search keyword in Russian (e.g. 'молоко', 'кофе') |
{
"type": "object",
"fields": {
"query": "string - the search query echoed back",
"products": "array of product objects with sku, name, brand, country, product_type, unit, price, availability, url",
"total_found": "integer - total matching products on the site"
},
"sample": {
"data": {
"query": "кофе",
"products": [
{
"sku": "287768",
"url": "https://online.metro-cc.ru/products/rioba-v-zernah-naturalnyj-zharenyj-100-arabika-espresso-1kg",
"name": "RIOBA Кофе в зернах натуральный жареный 100% арабика Espresso, 1кг",
"unit": "шт",
"brand": "RIOBA",
"price": 2349,
"country": "Италия",
"availability": true,
"product_type": "Кофе"
}
],
"total_found": 0
},
"status": "success"
}
}About the online.metro-cc.ru API
This API exposes 3 endpoints for querying the METRO Cash & Carry Russia online store, returning structured product data across search, category browsing, and individual product lookup. The search_products endpoint alone surfaces up to 9 fields per product — including SKU, brand, country of origin, price in rubles, and availability — for any Russian-language keyword query across the full catalog.
Endpoints Overview
The API covers three operations against the METRO Cash & Carry Russia catalog. search_products accepts a required query parameter in Russian (e.g. молоко, кофе) and an optional limit integer, then returns a products array alongside a total_found count. Each product object includes sku, name, brand, country, product_type, unit, price, availability, and a direct url. The endpoint paginates internally across up to 5 pages to satisfy the requested limit.
Category Tree
get_categories takes no inputs and returns the full hierarchical category tree up to 3 levels deep. Each node carries an id, name, slug, parent_id, and a nested children array. This is useful for mapping the catalog structure before running targeted searches or building category-aware navigation.
Product Detail Lookup
get_product_details fetches a single product by its URL slug (e.g. moloko-prostokvashino-bezlaktoznoye-ultrapasterizovannoye-1-5-970ml-84771). The response returns the same core attribute set: sku, name, unit, brand, price, country, and product_type. Slugs can be obtained from the url field returned by search_products or by browsing the category tree.
- Track price changes for specific SKUs in the METRO Russia food catalog over time using
get_product_details. - Build a country-of-origin filter for imported goods by extracting the
countryfield fromsearch_productsresults. - Map the full METRO product taxonomy for catalog analysis using the 3-level hierarchy from
get_categories. - Compare brand availability across product categories by combining
get_categoriesslugs withsearch_productsqueries. - Monitor stock availability for wholesale procurement by polling the
availabilityfield on key product SKUs. - Aggregate product type distributions across a keyword set using the
product_typefield from bulk search results. - Resolve product slugs to full attribute records for enriching an existing product database via
get_product_details.
| 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 METRO Cash & Carry Russia offer an official developer API for online.metro-cc.ru?+
What does `search_products` return, and does it filter by category or price range?+
search_products returns products whose names contain the query string, with fields including sku, name, brand, country, product_type, unit, price, availability, and url. It accepts a query string and an optional limit. Filtering by category or price range is not currently supported — the endpoint searches across the full catalog. You can fork this API on Parse and revise it to add category-scoped or price-range filtering.Are customer reviews or ratings available through this API?+
How fresh is the pricing data, and does it reflect member or bulk pricing?+
price field reflects the listed price in rubles at the time of the request. METRO stores typically display prices to registered members, and the API returns the price visible on the product page. Whether this reflects member-exclusive or bulk-tier pricing depends on how the product page presents it — the API does not expose separate price tiers or membership-specific rates.Can I retrieve a product using its SKU directly rather than its URL slug?+
get_product_details requires a URL slug as input (e.g. moloko-prostokvashino-bezlaktoznoye-ultrapasterizovannoye-1-5-970ml-84771). Direct lookup by SKU is not currently supported. The sku field is returned in both search_products and get_product_details responses, but you need to obtain the slug first — typically from the url field in a search_products result. You can fork this API on Parse and revise it to add SKU-based resolution.