Яндекс.Маркет API: карточки, поиск и фильтры

curl --max-time 180 --fail-with-body -i -X POST "https://bhapi.ru/yamarket/api/v1/item/detail-by-url" \
  -H "Content-Type: application/json" \
  -H "X-API-Token: ВАШ_API_TOKEN" \
  --data '{"url":"https://market.yandex.ru/card/example-product/000100000001"}' 

{
  "status": "ok",
  "data": {
    "item_id": "000100000001",
    "product_url": "https://market.yandex.ru/card/example-product/000100000001",
    "title": "Синтетический чайник",
    "brand": "Пример",
    "desc": "Учебное описание товара",
    "currency": "RUB",
    "price_info": {
      "sale_price": "1200.50",
      "origin_price": "1500"
    },
    "main_imgs": [
      "https://cdn.example.org/kettle.jpg"
    ],
    "main_videos": [
      "https://cdn.example.org/kettle.mp4"
    ],
    "category_path": [
      {
        "id": "category-1",
        "name": "Чайники",
        "url": "https://market.yandex.ru/catalog--kettles/1"
      }
    ],
    "product_props": [
      {
        "group": "Общие",
        "name": "Объём",
        "value": "1.5 л"
      }
    ],
    "shop_info": {
      "shop_name": "Учебный магазин",
      "shop_url": "https://market.yandex.ru/business--example/1"
    },
    "delivery_info": {
      "options": [
        {
          "type": "delivery",
          "day_from": 1,
          "day_to": 3,
          "date": null,
          "price": "0",
          "currency": "RUB",
          "partner_type": "market"
        }
      ],
      "context": "anonymous_session"
    },
    "review_info": {
      "rating_star": 4.5,
      "rating_count": 12,
      "review_count": 8
    },
    "sku_props": [
      {
        "name": "Цвет",
        "values": [
          "Синий",
          "Белый"
        ]
      }
    ],
    "skus": [
      {
        "item_id": "000100000002",
        "offer_id": "offer-variant",
        "product_url": "https://market.yandex.ru/product--example-blue/100000002",
        "properties": {
          "Цвет": "Синий"
        },
        "price": "1250",
        "currency": "RUB",
        "available": true
      }
    ],
    "market": {
      "schema_version": "1.0",
      "ids": {
        "osku_id": "000100000001",
        "catalog_sku_id": "catalog-1",
        "product_id": "product-1",
        "offer_id": "offer-main",
        "business_id": "business-1",
        "shop_id": "shop-1",
        "supplier_id": "supplier-1",
        "vendor_id": "vendor-1",
        "category_id": "category-1",
        "navnode_id": "navnode-1"
      },
      "availability": {
        "in_stock": true,
        "available_count": 7
      },
      "price_context": {
        "anonymous": true,
        "is_personal": true,
        "discount_percent": 19.97
      },
      "seller": {
        "business_id": "business-1",
        "shop_id": "shop-1",
        "rating": 4.8,
        "rating_count": 40,
        "reviews_count": 30,
        "orders_count": 100,
        "subscribers_count": 20,
        "age_text": "2 года",
        "logo_url": "https://cdn.example.org/shop-logo.png",
        "legal_info": [
          {
            "legal_form": "ООО",
            "name": "Учебный продавец",
            "supplier_name": "Учебный поставщик",
            "inn": "synthetic-inn",
            "ogrn": "synthetic-ogrn"
          }
        ]
      },
      "manufacturer": {
        "brand_name": "Пример",
        "legal_name": "Учебный производитель",
        "country": "Россия"
      },
      "reviews": [
        {
          "id": "review-1",
          "rating": 4,
          "date_text": "12 октября 2026",
          "pro": "Учебное достоинство",
          "contra": null,
          "comment": "Синтетический отзыв",
          "votes_agree": 2,
          "votes_reject": 0,
          "media_urls": [
            "https://cdn.example.org/review.jpg"
          ]
        }
      ],
      "rating_distribution": [
        {
          "value": 4,
          "count": 2,
          "percent": 0.25
        }
      ],
      "review_pagination": {
        "loaded_count": 1,
        "reported_review_count": 8,
        "has_more": true,
        "complete": false
      },
      "variants_complete": false,
      "sections": {
        "description": {
          "state": "present",
          "source": "productCardMeta.description"
        },
        "images": {
          "state": "present",
          "source": "gallery.mediaItems"
        },
        "specifications": {
          "state": "present",
          "source": "widgets.AboutFullSpecsListV2"
        },
        "price": {
          "state": "present",
          "source": "price.mainPrice"
        },
        "seller": {
          "state": "present",
          "source": "shopInfo"
        },
        "delivery": {
          "state": "present",
          "source": "offerAnalytics.allDeliveryOptions"
        },
        "rating": {
          "state": "present",
          "source": "reviews.ratingStats"
        },
        "reviews": {
          "state": "present",
          "source": "reviews.reviews"
        },
        "variants": {
          "state": "unverified",
          "source": "options"
        }
      },
      "warnings": [
        "unverified_variants",
        "price_personal"
      ],
      "fetch": {
        "fetched_at": "2026-10-12T09:00:00Z",
        "request_id": "11111111-1111-4111-8111-111111111111",
        "attempts": 1,
        "cache_hit": false
      }
    }
  }
}

{
  "status": "ok",
  "data": {
    "item_id": "000100000001",
    "product_url": "https://market.yandex.ru/card/example-product/000100000001",
    "title": "Синтетический чайник",
    "brand": null,
    "desc": null,
    "currency": null,
    "price_info": {
      "sale_price": null,
      "origin_price": null
    },
    "main_imgs": [
      "https://cdn.example.org/kettle.jpg"
    ],
    "main_videos": [],
    "category_path": [],
    "product_props": [
      {
        "group": "Общие",
        "name": "Объём",
        "value": "1.5 л"
      }
    ],
    "shop_info": {
      "shop_name": null,
      "shop_url": null
    },
    "delivery_info": {
      "options": [],
      "context": "anonymous_session"
    },
    "review_info": {
      "rating_star": null,
      "rating_count": null,
      "review_count": null
    },
    "sku_props": [],
    "skus": [],
    "market": {
      "schema_version": "1.0",
      "ids": {
        "osku_id": "000100000001",
        "catalog_sku_id": null,
        "product_id": null,
        "offer_id": null,
        "business_id": null,
        "shop_id": null,
        "supplier_id": null,
        "vendor_id": null,
        "category_id": null,
        "navnode_id": null
      },
      "availability": {
        "in_stock": null,
        "available_count": null
      },
      "price_context": {
        "anonymous": true,
        "is_personal": null,
        "discount_percent": null
      },
      "seller": {
        "business_id": null,
        "shop_id": null,
        "rating": null,
        "rating_count": null,
        "reviews_count": null,
        "orders_count": null,
        "subscribers_count": null,
        "age_text": null,
        "logo_url": null,
        "legal_info": []
      },
      "manufacturer": {
        "brand_name": null,
        "legal_name": null,
        "country": null
      },
      "reviews": [],
      "rating_distribution": [],
      "review_pagination": {
        "loaded_count": 0,
        "reported_review_count": null,
        "has_more": null,
        "complete": false
      },
      "variants_complete": false,
      "sections": {
        "description": {
          "state": "missing",
          "source": null
        },
        "images": {
          "state": "present",
          "source": "gallery.mediaItems"
        },
        "specifications": {
          "state": "missing",
          "source": null
        },
        "price": {
          "state": "missing",
          "source": null
        },
        "seller": {
          "state": "missing",
          "source": null
        },
        "delivery": {
          "state": "missing",
          "source": null
        },
        "rating": {
          "state": "missing",
          "source": null
        },
        "reviews": {
          "state": "empty",
          "source": "reviews.reviews"
        },
        "variants": {
          "state": "unverified",
          "source": "options"
        }
      },
      "warnings": [
        "section_missing",
        "unverified_variants"
      ],
      "fetch": {
        "fetched_at": "2026-10-12T09:00:00Z",
        "request_id": "11111111-1111-4111-8111-111111111111",
        "attempts": 1,
        "cache_hit": false
      }
    }
  }
}

{
  "status": "ok",
  "data": {
    "query": "coffee",
    "sort": "popular",
    "category_ids": [
      "123"
    ],
    "selected_filters": [],
    "price_from": null,
    "price_to": null,
    "sort_options": "popular",
    "pagination": {
      "page": 1,
      "items_per_page": 8,
      "total": 17,
      "page_count": 2,
      "has_next_page": true
    },
    "items": [
      {
        "item_id": "123",
        "title": "Coffee",
        "product_url": "https://market.yandex.ru/card/test/123?do-waremd5=offer123",
        "price": 1303.0,
        "currency": "RUB",
        "image_url": "https://avatars.mds.yandex.net/get-mpic/123/example/orig",
        "rating": 4.8,
        "price_type": "yandex_pay",
        "shop_name": "Example shop"
      }
    ],
    "filters": [
      {
        "id": "7893318",
        "name": "Brand",
        "type": "enum",
        "unit": null,
        "supported": true,
        "values": [
          {
            "id": "456",
            "label": "Example brand",
            "selected": false,
            "found": null
          }
        ],
        "selected_value_ids": [],
        "lazy": true,
        "loaded": false,
        "complete": false
      },
      {
        "id": "glprice",
        "name": "Price",
        "type": "range",
        "unit": "RUB",
        "supported": true,
        "values": [],
        "selected_value_ids": [],
        "lazy": null,
        "loaded": null,
        "complete": false
      }
    ]
  }
}

{
  "status": "ok",
  "data": {
    "query": "coffee",
    "sort": "popular",
    "category_ids": [
      "123"
    ],
    "selected_filters": [],
    "price_from": null,
    "price_to": null,
    "sort_options": "popular",
    "filters": [
      {
        "id": "7893318",
        "name": "Brand",
        "type": "enum",
        "unit": null,
        "supported": true,
        "values": [
          {
            "id": "456",
            "label": "Example brand",
            "selected": false,
            "found": null
          }
        ],
        "selected_value_ids": []
      },
      {
        "id": "glprice",
        "name": "Price",
        "type": "range",
        "unit": "RUB",
        "supported": true,
        "values": [],
        "selected_value_ids": []
      }
    ]
  }
}

{"detail":{"code":422,"reason":"filter_not_applied","message":"Применение выбранного фильтра или цены не подтверждено."}}

curl --max-time 180 --fail-with-body -i -X POST "https://bhapi.ru/yamarket/api/v1/search" \
  -H "X-API-Token: $BHAPI_TOKEN" -H "Content-Type: application/json" \
  --data '{"query":"кофе","sort":"popular","page":1}'

# Замените category_ids категориями из первого ответа.
curl --max-time 180 --fail-with-body -i -X POST "https://bhapi.ru/yamarket/api/v1/search/filters" \
  -H "X-API-Token: $BHAPI_TOKEN" -H "Content-Type: application/json" \
  --data '{"query":"кофе","sort":"popular","category_ids":["123"]}'

# Замените все ID актуальными; синтетический пример применения enum + цены.
curl --max-time 180 --fail-with-body -i -X POST "https://bhapi.ru/yamarket/api/v1/search" \
  -H "X-API-Token: $BHAPI_TOKEN" -H "Content-Type: application/json" \
  --data '{"query":"кофе","sort":"price_asc","category_ids":["123"],"page":1,"price_from":100,"price_to":2000,"filters":[{"id":"7893318","value_id":"456"}],"include_filters":false}' 

import os
import requests

BASE = "https://bhapi.ru/yamarket/api/v1"
HEADERS = {"X-API-Token": os.environ["BHAPI_TOKEN"]}

def call(method, params):
    response = requests.post(f"{BASE}/{method}", headers=HEADERS,
                             json=params, timeout=180)
    if response.status_code != 200:
        print("HTTP", response.status_code, "Retry-After:",
              response.headers.get("Retry-After"), "X-Request-ID:",
              response.headers.get("X-Request-ID"))
        print(response.json().get("detail"))
        response.raise_for_status()
    result = response.json()
    if result.get("status") != "ok" or not isinstance(result.get("data"), dict):
        raise RuntimeError("Неожиданный формат ответа")
    return result["data"]

context = {"query": "кофе", "sort": "popular"}
first = call("search", {**context, "page": 1})
context["category_ids"] = first["category_ids"]
form = call("search/filters", context)
choices = {}
for descriptor in form["filters"]:
    if (descriptor["supported"] and descriptor["type"] == "enum"
            and descriptor["id"].isascii() and descriptor["id"].isdigit()):
        for value in descriptor["values"]:
            if value["id"].isascii() and value["id"].isdigit():
                choices[(descriptor["id"], value["id"])] = value
                print(descriptor["id"], descriptor["name"],
                      value["id"], value["label"])
if not choices:
    raise RuntimeError("Подходящий enum в этом контексте не опубликован")
filter_id = input("ID нужного фильтра: ").strip()
value_id = input("ID нужного значения: ").strip()
if (filter_id, value_id) not in choices:
    raise ValueError("Выберите опубликованные ID из списка выше")
selection = [{"id": filter_id, "value_id": value_id}]
params = {**context, "filters": selection, "price_from": 100,
          "price_to": 2000, "include_filters": False, "page": 1}
result = call("search", params)
if (result["selected_filters"] != selection or result["price_from"] != 100
        or result["price_to"] != 2000 or result["pagination"]["page"] != 1):
    raise RuntimeError("Условия ответа не совпадают с запросом")
for item in result["items"]:
    print(item["title"], item["price"], item["price_type"], item["product_url"])
# Никакого фиксированного размера страниц и автоматического обхода всего каталога.
if result["pagination"]["has_next_page"] is True:
    second = call("search", {**params, "page": 2})
    print("Вторая страница:", len(second["items"]))

{"detail":{"code":502,"reason":"upstream_invalid_response","message":"Сервис Яндекс.Маркет вернул некорректный ответ."}}

import requests

response = requests.post(
    "https://bhapi.ru/yamarket/api/v1/item/detail-by-url",
    headers={"X-API-Token": "ВАШ_API_TOKEN"},
    json={"url": "https://market.yandex.ru/card/example-product/000100000001"},
    timeout=180,
)
if response.status_code == 429:
    print("Пауза, секунд:", response.headers.get("Retry-After"))
response.raise_for_status()
price = response.json()["data"]["price_info"]["sale_price"]
print("Цена неизвестна" if price is None else price)

const response = await fetch("https://bhapi.ru/yamarket/api/v1/item/detail-by-url", {
  method: "POST",
  headers: {"Content-Type": "application/json", "X-API-Token": "ВАШ_API_TOKEN"},
  body: JSON.stringify({url: "https://market.yandex.ru/card/example-product/000100000001"}),
  signal: AbortSignal.timeout(180000)
});
if (response.status === 429) console.log("Пауза, секунд:", response.headers.get("Retry-After"));
if (!response.ok) throw new Error("Ошибка API: " + response.status);
const price = (await response.json()).data.price_info.sale_price;
console.log(price === null ? "Цена неизвестна" : price);

<?php
$retryAfter = null;
$ch = curl_init("https://bhapi.ru/yamarket/api/v1/item/detail-by-url");
curl_setopt_array($ch, [
    CURLOPT_POST => true,
    CURLOPT_HTTPHEADER => ["Content-Type: application/json", "X-API-Token: ВАШ_API_TOKEN"],
    CURLOPT_POSTFIELDS => json_encode(["url" => "https://market.yandex.ru/card/example-product/000100000001"], JSON_THROW_ON_ERROR),
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 180,
    CURLOPT_HEADERFUNCTION => function ($ch, $line) use (&$retryAfter) {
        if (stripos($line, "Retry-After:") === 0) $retryAfter = trim(substr($line, 12));
        return strlen($line);
    }
]);
$body = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
if ($status === 429) echo "Пауза, секунд: " . ($retryAfter ?? "не указана");
if ($body === false || $status !== 200) throw new RuntimeException("Ошибка API: " . $status);
$data = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
echo $data["data"]["price_info"]["sale_price"] ?? "Цена неизвестна";