Yandex Market Category Products — Catalog Listings by ID
Send a catalog category ID or URL and this source returns the offers in that category as data: title, URL, image, price, old price, discount, availability, delivery text and seller, with sort, price, condition, payment method, rating and brand filters.
{
"session_id": "11111111-1111-1111-1111-111111111111",
"kind": "yandexmarket_categories_products",
"category": "26992150",
"category_id": "26992150",
"max_items": 2,
"start_page": 1,
"partial": false,
"human": "# Yandex Market category products\n\n- **Category:** 26992150\n- **Starting page:** 1\n- **Max items:** 2\n- **Records returned:** 2\n- **Proxy traffic:** 2.66 MB",
"machine": {
"total_items": 2,
"first_item": {
"product_id": "6213951594",
"sku_id": "6242322529",
"model_id": "6213951593",
"offer_id": "RRYyMboy7E0SMyivDjI6pA",
"business_id": "216674363",
"title": "Беспроводные наушники Apple AirPods 5 с беспроводным зарядным кейсом",
"url": "https://market.yandex.ru/card/besprovodnyye-naushniki-apple-airpods-5-s-besprovodnym-zaryadnym-keysom/6213951594",
"image": "https://avatars.mds.yandex.net/get-mpic/20907538/pica2ef6e0e0be38fbb167b305d4c09b18f/orig",
"alias": "besprovodnyye-naushniki-apple-airpods-5-s-besprovodnym-zaryadnym-keysom",
"currency": "RUB",
"rating": null,
"rating_count": null,
"purchase_count": null,
"vendor_id": 153043,
"category_ids": [
"90555"
],
"specs_highlights": [],
"price_with_card": 29017,
"old_price": 40179,
"discount_percent": 28,
"condition": "new",
"available_count": 300,
"delivery_text": "6 окт, ПВЗПо клику",
"seller_name": "ID Stoгe",
"is_sponsored": false,
"is_cross_border": true
},
"items": [
{
"product_id": "6213951594",
"sku_id": "6242322529",
"model_id": "6213951593",
"offer_id": "RRYyMboy7E0SMyivDjI6pA",
"business_id": "216674363",
"title": "Беспроводные наушники Apple AirPods 5 с беспроводным зарядным кейсом",
"url": "https://market.yandex.ru/card/besprovodnyye-naushniki-apple-airpods-5-s-besprovodnym-zaryadnym-keysom/6213951594",
"image": "https://avatars.mds.yandex.net/get-mpic/20907538/pica2ef6e0e0be38fbb167b305d4c09b18f/orig",
"alias": "besprovodnyye-naushniki-apple-airpods-5-s-besprovodnym-zaryadnym-keysom",
"currency": "RUB",
"rating": null,
"rating_count": null,
"purchase_count": null,
"vendor_id": 153043,
"category_ids": [
"90555"
],
"specs_highlights": [],
"price_with_card": 29017,
"old_price": 40179,
"discount_percent": 28,
"condition": "new",
"available_count": 300,
"delivery_text": "6 окт, ПВЗПо клику",
"seller_name": "ID Stoгe",
"is_sponsored": false,
"is_cross_border": true
},
{
"product_id": "6213951594",
"sku_id": "6242322529",
"model_id": "6213951593",
"offer_id": "RRYyMboy7E0SMyivDjI6pA",
"business_id": "216674363",
"title": "",
"url": "https://market.yandex.ru/card/besprovodnyye-naushniki-apple-airpods-5-s-besprovodnym-zaryadnym-keysom/6213951594",
"image": "https://avatars.mds.yandex.net/get-mpic/20900195/picc7aa2a43819ceea87f8647346c3d0c59/orig",
"alias": "besprovodnyye-naushniki-apple-airpods-5-s-besprovodnym-zaryadnym-keysom",
"currency": "RUB",
"rating": null,
"rating_count": null,
"purchase_count": null,
"vendor_id": 153043,
"category_ids": [
"90555"
],
"specs_highlights": [],
"price_with_card": 29914,
"old_price": 40179,
"discount_percent": 26,
"condition": "new",
"available_count": 300,
"delivery_text": null,
"seller_name": null,
"is_sponsored": false,
"is_cross_border": true
}
],
"total_found": 1980,
"page_count": 30,
"blocked": false,
"proxy_traffic_bytes": 2785871
},
"total_points": 2
}- You send
- A Yandex Market category ID or URL, with optional sort and filters
- You get back
- Offers in the category with title, URL, image, price, old price, discount, availability, delivery text and seller
- Coverage
- Offers listed in Yandex Market's public catalog categories.
- Price
- 1 point per returned result, up to 250 per request — $1 per 1,000
- Billed per record actually returned, capped by max_items. A category that returns nothing costs nothing.
Ways to get this data
Three approaches teams use today, and where each one runs into trouble.
| Approach | What it takes | Cost | Trade-off |
|---|---|---|---|
| Checking the site by hand | Open the category, scroll and copy | Free, and slow | Impractical beyond a page or two |
| Building a scraper | Write it, host it, and repair it when Yandex Market changes the listing page | Engineering time | A maintenance commitment for something that isn't your product |
| NeuralVerge | One request, category and filters as parameters | $1 per 1,000, misses not billed | Large categories are large result sets — cap max_items deliberately |
What you get back
Every field in the response shown above.
| Field | Type | Description |
|---|---|---|
total_items | number | How many products were returned in this batch (capped by max_items). |
first_item | object | A copy of the first record, for quick access. |
total_found | number | How many matches the page reported in total, beyond the batch returned. |
page_count | number | Number of result pages reported. |
blocked | boolean | Whether the request was blocked; false when results came back normally. |
product_id | string | Yandex Market product ID. |
sku_id | string | SKU ID of the offer. |
model_id | string | Model ID the offer is grouped under. |
offer_id | string | Offer ID. |
business_id | string | Seller (business) ID. |
title | string | Listing title. Can be an empty string on some records. |
url | string | Direct link to the product card. |
image | string | Primary product image URL. |
alias | string | URL slug of the product card. |
currency | string | ISO currency code (RUB in the sample). |
rating | number | Average rating; null when the listing has none. |
rating_count | number | Number of ratings; null when none. |
purchase_count | number | Purchase count; null when not shown. |
vendor_id | number | Brand (vendor) ID. |
category_ids | array | IDs of the categories the offer sits in. |
specs_highlights | array | Short spec highlights; empty when the listing has none. |
price_with_card | number | Listed price (price_with_card), in the response currency. |
old_price | number | Previous price shown for the offer. |
discount_percent | number | Discount against old_price, as a percentage. |
condition | string | Item condition, e.g. new. |
available_count | number | Units reported as available. |
delivery_text | string | Delivery estimate text as shown (Russian); null when absent. |
seller_name | string | Seller name; null when the record does not carry one. |
is_sponsored | boolean | Whether the result is a sponsored placement. |
is_cross_border | boolean | Whether the offer is flagged as cross-border. |
How to run it
The same lookup works from the app, the API, or as a tool an agent can call mid-task.
category is the only required field. max_items caps the result count (up to 250, defaults to 25) and sets what you are billed for; start_page continues a previous pull.
curl -X POST https://api.neuralverge.ai/functions/v1/run-yandexmarket-categories-products \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{ "category": "26992150", "max_items": 25, "sort": "dpop" }'What teams use it for
Where this field shows up in an actual workflow.
Compare price and discount across a category's most popular offers.
Filter by vendor_id to see how much of a category a brand holds.
Sort by discount_p and track which offers are marked down.
Collect product IDs to run through Yandex Market product.
Coverage, freshness and limits
What this source covers, how fresh it is, and where it stops.
Offers listed in Yandex Market's public catalog categories.
Read at request time.
This source returns publicly visible information, stamped with the input it was read from and a session id you can trace.
- —A large category returns a large result set — set max_items before you run it.
- —The same product card can appear more than once, once per offer.
- —Some records come back with an empty title or no seller name.
Questions, answered
From the category URL on market.yandex.ru, where it appears as a number.
Related sources
Try yandex market category products on your own data
One request format across every source in the catalog.