megamarket.ru APImegamarket.ru ↗
Search products, retrieve specs, read reviews, and browse catalog categories on MegaMarket.ru (Sber's Russian marketplace) via a structured JSON API.
curl -X GET 'https://api.parse.bot/scraper/c32d9ff8-1dc2-4c8d-920b-a69bb80b66f7/search_products?limit=5&query=iphone' \ -H 'X-API-Key: $PARSE_API_KEY'
Search products by text query with pagination and sorting
| Param | Type | Description |
|---|---|---|
| limit | integer | Number of results per page (max 44) |
| queryrequired | string | Search text query |
| offset | integer | Pagination offset |
| sorting | integer | Sort order: 0=relevance, 1=price_asc, 2=price_desc, 3=rating, 4=discount |
| location_id | string | Region ID (50=Moscow) |
{
"type": "object",
"fields": {
"items": "array",
"limit": "integer",
"total": "integer",
"offset": "integer"
},
"sample": {
"items": [
{
"brand": "Apple",
"price": 147990,
"title": "Смартфон Apple iPhone Air 512Gb White",
"rating": 5,
"web_url": "https://megamarket.ru/catalog/details/...",
"goods_id": "700001132179_254730",
"final_price": 122831,
"is_available": true,
"review_count": 4,
"merchant_name": "Mega Trade DBS"
}
],
"limit": 20,
"total": 1902,
"offset": 0
}
}About the megamarket.ru API
The MegaMarket.ru API gives access to Sber's Russian marketplace through 5 endpoints covering product search, detailed specs, customer reviews, catalog navigation, and autocomplete suggestions. The search_products endpoint accepts free-text queries with pagination, region filtering, and four sort modes, returning arrays of matching items alongside total counts. Response fields include titles, prices, attributes, images, and grouped specification data.
Product Search and Details
The search_products endpoint accepts a required query string and supports offset/limit pagination (up to 44 results per page), a location_id for region-specific pricing (e.g. 50 for Moscow), and a sorting integer that maps to relevance, price ascending, price descending, rating, or discount order. Results come back as an items array with a total count for building paginated workflows.
The get_product_details endpoint takes a goods_id such as 700001132179_254730 — the underscore-delimited format encodes both the product ID and merchant ID, and the API extracts the merchant automatically when present. The response includes brand, title, description, images, raw attributes, and attributes_grouped for structured spec comparison across categories.
Reviews and Catalog
get_product_reviews retrieves paginated customer reviews for a given goods_id. It supports up to 50 reviews per page, and results can be sorted by HELPFULNESS or DATE in either ASC or DESC direction. The response shape exposes a reviews array plus total for pagination math.
The get_catalog_menu endpoint returns the category tree as a categories array. You can request from a specific parent_id (pass 0 for the root), control tree depth with depth_level, and set a starting depth via depth_level_from. The search_suggest endpoint completes the discovery workflow by returning a suggests array of autocomplete terms for a partial query, optionally scoped to a region via location_id.
Regional Coverage Note
All endpoints accept an optional location_id parameter. MegaMarket.ru is a Russia-focused marketplace; access requires a Russian proxy, and region IDs like 50 (Moscow) affect pricing and availability in responses. Endpoints do not expose seller delivery terms or logistics details beyond what appears in product attributes.
- Price monitoring across MegaMarket.ru categories using
search_productssorted by price ascending or descending - Building product comparison tools by pulling
attributes_groupedfromget_product_detailsfor multiple goods IDs - Populating a review aggregation dashboard using
get_product_reviewssorted by DATE or HELPFULNESS - Constructing a localized category browser from the
get_catalog_menucategory tree hierarchy - Implementing autocomplete in a product search UI with the
search_suggestendpoint'ssuggestsarray - Tracking brand presence on MegaMarket.ru by filtering
brandfields from product detail responses - Regional price analysis by running the same query across different
location_idvalues insearch_products
| 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 MegaMarket.ru offer an official developer API?+
What does `get_product_details` return and how is the goods_id formatted?+
brand, title, description, images, attributes, and attributes_grouped for a single product. The goods_id uses an underscore-delimited format like 700001132179_254730, where the segment after the underscore is the merchant ID. When that format is present, the API extracts the merchant ID automatically, so you don't need to supply merchant_id separately.Are seller storefronts or merchant-level product listings available?+
goods_id, but there is no dedicated endpoint for browsing a merchant's full storefront or fetching seller profile details. You can fork this API on Parse and revise it to add a merchant-listing endpoint.What are the pagination limits across endpoints?+
search_products returns a maximum of 44 items per request; use offset alongside total to page through results. get_product_reviews allows up to 50 reviews per page with its own offset and total fields. get_catalog_menu uses depth parameters rather than offset-based pagination.