# searchCatalog

Source: <https://telegafirst.com/docs/api-op-searchcatalog>
Locale: ru
releaseGitSha: fc570c76ffc9cb87e2462d45b14f5c1b52fbaf0d
sourceContentDigest: 0591f367ccf481dbc7a8e5429bdb22ebee19d560aae0f9f98c8ed4b81b7afcf1
Version: 2

# searchCatalog

`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](https://telegafirst.com/docs/schema-5fddca17fd910d3d6f16011817114f88224aa826a2667d118a49fe09c620b138) |
| 1.in | "query" |
| 1.name | "currency" |
| 1.required | false |
| 1.schema | [1.schema](https://telegafirst.com/docs/schema-9035aaa9f3ad4d62716cf3b783cdae1302fed9b7b20ae6477e03c7383841a9fc) |
| 2.in | "query" |
| 2.name | "price\_min" |
| 2.required | false |
| 2.schema | [2.schema](https://telegafirst.com/docs/schema-1743fbef7dc833da271cb8206a6f497a6f01833daee012682ee4f85221c8d462) |
| 3.in | "query" |
| 3.name | "price\_max" |
| 3.required | false |
| 3.schema | [3.schema](https://telegafirst.com/docs/schema-1743fbef7dc833da271cb8206a6f497a6f01833daee012682ee4f85221c8d462) |
| 4.in | "query" |
| 4.name | "availability" |
| 4.required | false |
| 4.schema | [4.schema](https://telegafirst.com/docs/schema-7de93d6c4cc54172c0b220a317955bd8ab1e4cd4de07815bc32b50c66fcc4bd1) |
| 5.in | "query" |
| 5.name | "sort" |
| 5.required | false |
| 5.schema | [5.schema](https://telegafirst.com/docs/schema-1079f43058c3c31ed7cb1c666dc05d437c2e8faa778961a47e9b93637fbefe2c) |
| 6.in | "query" |
| 6.name | "cursor" |
| 6.required | false |
| 6.schema | [6.schema](https://telegafirst.com/docs/schema-94da78e27bd69687bf187ce450527d7e8d5eb291bbb995a920c441f5ff83388e) |
| 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](https://telegafirst.com/docs/schema-deeff6fef312df126fee8e67def4e7fcb2a875950df4d99bed7353b5f7b14a20) |
| 8.in | "query" |
| 8.name | "limit" |
| 8.required | false |
| 8.schema | [8.schema](https://telegafirst.com/docs/schema-9354d5a3a3d49aa65597ce003cc70a9f3ea8ed386f9132093d7874ae5d0dce44) |

## Тело запроса

| Поле | Значение |
| - | - |
| Тело запроса | null |

## Ответы

| Поле | Значение |
| - | - |
| 200.content.application/json.schema | [CatalogSearchPage](https://telegafirst.com/docs/schema-6d0b6d818cd9821848920bd8ee4d3aa2bc437bdea7f5ff54214ecac095f453c4) |
| 200.description | "One page of matching products with their availability, prices and unavailable combinations" |

## Ошибки

| Поле | Значение |
| - | - |
| 400.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-cb940dbba4894d830b2ff33a2fbf4d6382de295156cd5a9ab88564d4c14aa2ab) |
| 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](https://telegafirst.com/docs/schema-cb940dbba4894d830b2ff33a2fbf4d6382de295156cd5a9ab88564d4c14aa2ab) |
| 401.description | "Missing or invalid authentication" |
| 403.content.application/problem+json.schema | [ProblemDetails](https://telegafirst.com/docs/schema-cb940dbba4894d830b2ff33a2fbf4d6382de295156cd5a9ab88564d4c14aa2ab) |
| 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" |