Appearance
List and search products
GET
/store/products
Публичный каталог товаров с полнотекстовым поиском, фильтрацией и курсорной пагинацией.
Когда передан параметр q, выполняется FTS-поиск с сортировкой по релевантности (по умолчанию).
Без q — обычный листинг с сортировкой по дате.
Параметры city_ids и region_id взаимоисключающие — одновременная передача вернёт ошибку валидации.
Parameters
Query Parameters
q
Full-text search query (optional)
Type
string
category_id
Filter by category (includes descendants)
Type
integer
condition
Filter by condition category ID
Type
integer
make_id
Filter by car make
Type
integer
model_id
Filter by car model
Type
integer
generation_id
Filter by car generation
Type
integer
modification_id
Filter by car modification
Type
integer
region_id
Filter by region (mutually exclusive with city_ids)
Type
integer
city_ids
Comma-separated city IDs (mutually exclusive with region_id)
Type
string
district_id
Filter by district
Type
integer
metro_station_id
Filter by metro station
Type
integer
price_min
Minimum price
Type
number
price_max
Maximum price
Type
number
steering
Filter by steering type
Type
string
Valid values
"left""right""both""universal"is_available
Filter by availability
Type
string
Valid values
"true""1""false""0"sort
Sort order. relevance is only allowed when q is present (default sort when q is set)
Type
string
Valid values
"date_desc""price_asc""price_desc""relevance"Default
"date_desc"cursor
Opaque cursor for pagination
Type
string
limit
Number of items per page
Type
integer
Minimum
1Maximum
100Default
20Responses
List of products
application/json
JSON "data": [ { "id": 0, "title": "string", "price": 2500, "steering": "string", "city_id": 0, "region_id": 0, "district_id": 0, "metro_station_id": 0, "metro_distance_m": 0, "address_id": "string", "images": [ { "id": 0, "thumbnail_webp": "string", "thumbnail_jpeg": "string", "medium_webp": "string", "medium_jpeg": "string", "large_webp": "string", "large_jpeg": "string", "status": "string", "is_primary": true, "sort_order": 0 } ], "seller": { "id": 5, "display_name": "BMW Parts Store", "avatar_url": "https://s3.partizap.ru/avatars/5.webp", "city_id": 0, "rating": "4.85", "reviews_count": 127, "products_count": 342, "created_at": "string" }, "published_at": "string" } ], "meta": { "has_more": true, "next_cursor": "abc123xyz" }
{
}