Документация / Как начать / Работа с MCP / Идентификаторы и страницы результатов / REST: catalog / searchCatalog Для AI-агентов: markdown этой страницы — /docs/api-op-searchcatalog.md · индекс документации — /llms.txt
searchCatalog Обновлено 1 ноября 2026 г.
GET /api/v1/catalog/search
searchCatalog
# Авторизация и праваScopes: ALL. Auth alternatives: OR; scopes внутри альтернативы: ALL.
Поле Значение security.0.hubApiKey [] security.1.hubBearer [] securitySchemes.hubApiKey.in "header" securitySchemes.hubApiKey.name "X-Api-Key" securitySchemes.hubApiKey.type "apiKey" securitySchemes.hubBearer.scheme "bearer" securitySchemes.hubBearer.type "http" x-required-scopes ["catalog:read"]
# Параметры запросаПоле Значение 0.in "query" 0.name "q" 0.required false 0.schema 0.schema 1.in "query" 1.name "currency" 1.required false 1.schema 1.schema 2.in "query" 2.name "price_min" 2.required false 2.schema 2.schema 3.in "query" 3.name "price_max" 3.required false 3.schema 3.schema 4.in "query" 4.name "availability" 4.required false 4.schema 4.schema 5.in "query" 5.name "sort" 5.required false 5.schema 5.schema 6.in "query" 6.name "cursor" 6.required false 6.schema 6.schema 7.description "Category ids, comma-separated (at most 20); a product in any of them matches" 7.in "query" 7.name "group_ids" 7.required false 7.schema 7.schema 8.in "query" 8.name "limit" 8.required false 8.schema 8.schema
# Тело запросаПоле Значение Тело запроса null
# ОтветыПоле Значение 200.content.application/json.schema CatalogSearchPage 200.description "One page of matching products with their availability, prices and unavailable combinations"
# ОшибкиПоле Значение 400.content.application/problem+json.schema ProblemDetails 400.description "The search does not match the request schema (VALIDATION_ERROR) or the cursor belongs to another query (INVALID_CURSOR)" 401.content.application/problem+json.schema ProblemDetails 401.description "Missing or invalid authentication" 403.content.application/problem+json.schema ProblemDetails 403.description "Catalog read scope or resource policy refused the request"
# Дополнительные условияПоле Значение description "Structured search over what a buyer can see (switched on, listed, showcase scope): words in the title or description, categories, a price range in one currency, availability, five sorts. One page per call; follow next_cursor. A page filtered by availability can be empty while has_more is true." operationId "searchCatalog" tags ["catalog"] x-idempotency "none"