# Yandex Market API (yandex.market)

- Canonical page: https://everyinfra.com/en/yandex-api/market
- Endpoint: POST https://api.everyinfra.com/api/v1/social with {"platform": "yandex", "action": "market", "params": {...}}
- Price: $0.02239 per call ($22.39 per 1,000 requests); failed calls and empty results are not charged
- Returns: list, default 20, max 100 per call
- Mode: sync; add "mode": "async" for slow tasks

## Health

- Live health (24h percent, hourly and daily trends): https://api.everyinfra.com/api/v1/social/availability?platform=yandex&action=market

## Parameters

| name | type | required | default | description |
|---|---|---|---|---|
| keyword | not declared | yes | not declared | Specifies search terms for Yandex actions, targeting local places in search and e-commerce items in market. Map listings and product catalogs query separate underlying datasets. |
| city | enum: chelyabinsk / kazan / krasnodar / krasnoyarsk / moscow / nizhny_novgorod / novosibirsk / omsk / perm / rostov_on_don / saint_petersburg / samara / ufa / volgograd / voronezh / yekaterinburg | no | not declared | Specifies the target city slug (e.g., moscow, saint_petersburg) for the Yandex market action. Must match an allowed enum value and cannot be substituted for location on map searches. |
| max_price | not declared | no | not declared | Sets the upper price boundary for the targeted Yandex action when used in conjunction with min_price. It does not filter by maximum user rating. Filtering uses whole numbers: decimals round up (145.98 becomes 146). |
| min_price | not declared | no | not declared | Sets the lower price limit for Yandex actions, representing product price on market and local place price tier on search. These values reflect target-platform price points rather than API usage fees. Filtering uses whole numbers: decimals round down (39.81 becomes 39). |
| region | not declared | no | not declared | Accepts a numeric city region code for the Yandex market action, defaulting to 213 (Moscow). This is an internal region identifier, not an RU country code. Providing an explicit city parameter overrides this setting. |
| sort | enum: popular / top_rated | no | not declared | Controls sorting order per Yandex action. Accepts relevance or distance for search; popular or top_rated for market; and newest (default), relevance, top_rated, or lowest_rated for reviews. Values cannot be used across different actions. |
| limit | integer (1–100) | no | 20 | The most rows to return in this call, an integer from 1 to 100. The default applies when you leave it out, and a call can return fewer rows. Larger values return 422 before any charge. |

## Response fields (items in `results`)

| field | meaning |
|---|---|
| id | The record's unique ID on the platform. Unique only within one platform; IDs can repeat across platforms. |
| url | Link to the record on the platform. |
| title | Title. null when the platform has no titles (for example text-only posts). |
| price | Price as a number without a currency symbol; see currency. |
| currency | Currency code of the price (for example CNY, USD). If price is present but currency is null, do not assume a currency. |
| rating | Rating. **The scale varies by platform**: rating_scale on the same row gives the maximum (usually 5; Booking, Douban, iQIYI and NAVER use 10). Convert with rating_scale before comparing across platforms, or the comparison can come out backwards. |
| rating_scale | Maximum of rating in the same row: 5 for five-star scales, 10 for ten-point scales. Present only when the row has a rating. |
| rating_count | Number of people who rated. null means not disclosed, not 0. |
| review_count | Number of reviews, for product and business capabilities. null means not disclosed, not 0. |
| purchase_count | platform-native meaning |
| category | Category name in the platform's own taxonomy, not normalized across platforms. |
| shop_name | platform-native meaning |
| shop_rating | platform-native meaning |
| stock | platform-native meaning |
| is_available | platform-native meaning |
| image_url | Image link. Capabilities with several images may return an image_urls array. |
| platform | Source platform identifier, the same as platform in the request (for example xiaohongshu, tiktok). |

## Example

```bash
curl -X POST 'https://api.everyinfra.com/api/v1/social' \
  -H "Authorization: Bearer $EVERYINFRA_API_KEY" \
  -H 'Content-Type: application/json' \
  --data-raw '{
  "platform": "yandex",
  "action": "market",
  "params": {
    "keyword": "ноутбук"
  }
}'
```

```python
import os
import requests

response = requests.post(
    "https://api.everyinfra.com/api/v1/social",
    headers={"Authorization": f"Bearer {os.environ['EVERYINFRA_API_KEY']}"},
    json={
        "platform": "yandex",
        "action": "market",
        "params": {
            "keyword": "ноутбук",
        },
    },
    timeout=120,
)
print(response.status_code)
print(response.json())
```

## Response example

Real response to the example request above, captured 2026-10-24T18:28:34Z. `results` and `count` are real with personal information (names, handles, avatars, profile links, contact details) removed; the list keeps the first 2 of 20. `id`, `billing` and `quota` differ on every call, so only their shape is shown.

```text
{
  "id": "req_…",
  "platform": "yandex",
  "action": "market",
  "results": [
    {
      "id": "•••",
      "url": "https://market.yandex.ru/card/156-noutbuk-lunnen-ground-15-2025-amd-ryzen-5-7430u-ram-16-gb-ssd-512-gb-ips-full-hd-1920x1080-windows-11-home-tsvet-silver-sea-ll5fawl03/4625706033?sku=4607478433",
      "title": "15.6\" Ноутбук LUNNEN Ground 15 (2025), AMD Ryzen 5 7430U, RAM 16 ГБ, SSD 512 ГБ, IPS Full HD 1920x1080, Windows 11 Home, цвет Silver Sea, LL5FAWL03",
      "price": 73897,
      "currency": "RUR",
      "rating": 4.8,
      "rating_count": 1826,
      "review_count": 705,
      "category": "Ноутбуки персональные LUNNEN",
      "shop_name": "Яндекс Фабрика",
      "shop_rating": 4.8,
      "stock": 39,
      "is_available": true,
      "image_url": "https://avatars.mds.yandex.net/get-mpic/18753496/pic79f0e899ffc11c4c1cbf9724429d2f5a/orig",
      "platform": "yandex",
      "rating_scale": 5
    },
    {
      "id": "•••",
      "url": "https://market.yandex.ru/card/noutbuk-lunnen-ground-16-ll6fawg07/4347177021?sku=5729303927",
      "title": "16\" Ноутбук LUNNEN Ground 16, AMD Ryzen 7 7730U, RAM 16 ГБ, SSD 512 ГБ, 1920x1200, Windows 11, Light Grey, LL6FAWG07",
      "price": 87211,
      "currency": "RUR",
      "rating": 4.6,
      "rating_count": 1885,
      "review_count": 698,
      "category": "Ноутбуки персональные LUNNEN",
      "shop_name": "Яндекс Фабрика",
      "shop_rating": 4.8,
      "stock": 25,
      "is_available": true,
      "image_url": "https://avatars.mds.yandex.net/get-mpic/19298711/2a0000019dfd0f14196878604346140157e0/orig",
      "platform": "yandex",
      "rating_scale": 5
    }
  ],
  "count": 20,
  "billing": {
    "charged": …,
    "charged_usd": …,
    "balance_after_usd": …,
    …
  },
  "quota": { … }
}
```

## Also

- Capability catalog (no key): https://api.everyinfra.com/api/v1/social/catalog?platform=yandex
- OpenAPI: https://everyinfra.com/openapi.json · Agents guide: https://everyinfra.com/agents.md