nvNeuralVerge
E-commerce & Marketplaces

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.

Example response
{
  "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.
Comparison

Ways to get this data

Three approaches teams use today, and where each one runs into trouble.

ApproachWhat it takesCostTrade-off
Checking the site by handOpen the category, scroll and copyFree, and slowImpractical beyond a page or two
Building a scraperWrite it, host it, and repair it when Yandex Market changes the listing pageEngineering timeA maintenance commitment for something that isn't your product
NeuralVergeOne request, category and filters as parameters$1 per 1,000, misses not billedLarge categories are large result sets — cap max_items deliberately
Response

What you get back

Every field in the response shown above.

FieldTypeDescription
total_itemsnumberHow many products were returned in this batch (capped by max_items).
first_itemobjectA copy of the first record, for quick access.
total_foundnumberHow many matches the page reported in total, beyond the batch returned.
page_countnumberNumber of result pages reported.
blockedbooleanWhether the request was blocked; false when results came back normally.
product_idstringYandex Market product ID.
sku_idstringSKU ID of the offer.
model_idstringModel ID the offer is grouped under.
offer_idstringOffer ID.
business_idstringSeller (business) ID.
titlestringListing title. Can be an empty string on some records.
urlstringDirect link to the product card.
imagestringPrimary product image URL.
aliasstringURL slug of the product card.
currencystringISO currency code (RUB in the sample).
ratingnumberAverage rating; null when the listing has none.
rating_countnumberNumber of ratings; null when none.
purchase_countnumberPurchase count; null when not shown.
vendor_idnumberBrand (vendor) ID.
category_idsarrayIDs of the categories the offer sits in.
specs_highlightsarrayShort spec highlights; empty when the listing has none.
price_with_cardnumberListed price (price_with_card), in the response currency.
old_pricenumberPrevious price shown for the offer.
discount_percentnumberDiscount against old_price, as a percentage.
conditionstringItem condition, e.g. new.
available_countnumberUnits reported as available.
delivery_textstringDelivery estimate text as shown (Russian); null when absent.
seller_namestringSeller name; null when the record does not carry one.
is_sponsoredbooleanWhether the result is a sponsored placement.
is_cross_borderbooleanWhether the offer is flagged as cross-border.
Integration

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" }'
Use cases

What teams use it for

Where this field shows up in an actual workflow.

Category benchmarking

Compare price and discount across a category's most popular offers.

Brand share checks

Filter by vendor_id to see how much of a category a brand holds.

Discount scans

Sort by discount_p and track which offers are marked down.

Feeding product lookups

Collect product IDs to run through Yandex Market product.

Coverage & limits

Coverage, freshness and limits

What this source covers, how fresh it is, and where it stops.

Coverage

Offers listed in Yandex Market's public catalog categories.

Freshness

Read at request time.

Handling

This source returns publicly visible information, stamped with the input it was read from and a session id you can trace.

What it will not do
  • —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.
FAQ

Questions, answered

From the category URL on market.yandex.ru, where it appears as a number.

Related

Related sources

Try yandex market category products on your own data

One request format across every source in the catalog.

Get started