Фильтрация по атрибутам
Вы можете фильтровать результаты поиска и получать списки организаций:
- По времени работы.
- По дате открытия.
- По наличию или отсутствию данных: ИНН, торговой лицензии, фотографий, рейтинга, отзывов и сайта.
- По дополнительным атрибутам.
По времени работы
С помощью параметра work_time вы можете получить список организаций, работающих в определённое время (например, по вторникам в 09:00 — work_time=tue,09:00), работающих круглосуточно (work_time=alltime) или открытых сейчас (work_time=now).
Чтобы отфильтровать результаты поиска по времени работы организации, отправьте GET-запрос к /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».location— координаты точки поиска в форматедолгота,широта, напримерlocation=37.630866,55.752256. Вы можете указать геоограничение другим способом: подробнее см. в инструкции Геоограничение поиска.work_time— фильтр по времени работы, напримерwork_time=nowдля получения организаций, работающих на момент отправки запроса.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&location=37.630866,55.752256&work_time=now&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.21263",
"code": 200,
"issue_date": "20260825"
},
"result": {
"items": [
{
"address_name": "улица Варварка, 6 ст3",
"id": "70000001029535674",
"name": "Зарядье, гастрономический центр",
"type": "branch"
},
{
"address_comment": "1 этаж; вход с ул. Забелина",
"address_name": "улица Солянка, 1/2",
"id": "70000001032763462",
"name": "The Black Swan Pub",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001093401978",
"name": "Senti Menti",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Славянская площадь, 2/5",
"id": "4504128908449647",
"name": "True Cost, прожектор",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Славянская площадь, 2/5/4 ст3",
"id": "70000001007260074",
"name": "Либерти, ночной клуб",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Лубянский проезд, 25 ст1",
"id": "4504127908781677",
"name": "Китайский Лётчик Джао Да, кафе-клуб",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001082439498",
"name": "Chang, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Новая площадь, 14",
"id": "70000001109804763",
"name": "Rusty Rat&Pizza",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001047225231",
"name": "Хачапури и вино, кафе грузинской кухни",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1",
"id": "70000001032240412",
"name": "22 сантиметра, пиццерия",
"type": "branch"
}
],
"total": 1190
}
}
По дате открытия
С помощью параметра opened_after_date вы можете получить список организаций, открытых после определённой даты.
Чтобы отфильтровать результаты поиска по дате открытия организации, отправьте GET-запрос к /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».location— координаты точки поиска в форматедолгота,широта, напримерlocation=37.630866,55.752256. Вы можете указать геоограничение другим способом: подробнее см. в инструкции Геоограничение поиска.opened_after_date— фильтр по дате открытия, напримерopened_after_date=2026-06-01для получения организаций, открытых после 1 июня 2026 года.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&location=37.630866,55.752256&opened_after_date=2026-06-01&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260630"
},
"result": {
"items": [
{
"address_comment": "3 этаж",
"address_name": "Большой Спасоглинищевский переулок, 2",
"id": "70000001115242382",
"name": "Про Рёбра, кафе",
"type": "branch"
},
{
"address_name": "Лубянский проезд, 25 ст1",
"id": "70000001115212911",
"name": "Метрамен",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Рождественка, 12/1 ст1",
"id": "70000001115237712",
"name": "Музей советских игровых автоматов, Кафе",
"type": "branch"
}
],
"total": 3
}
}
По наличию ИНН
Чтобы отфильтровать результаты поиска по наличию ИНН у организации, отправьте GET-запрос к /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».location— координаты точки поиска в форматедолгота,широта, напримерlocation=37.630866,55.752256. Вы можете указать геоограничение другим способом: подробнее см. в инструкции Геоограничение поиска.has_itin=true— фильтр по наличию ИНН.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&location=37.630866,55.752256&has_itin=true&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260630"
},
"result": {
"items": [
{
"address_name": "улица Варварка, 6 ст3",
"id": "70000001029535674",
"name": "Зарядье, гастрономический центр",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001032763462",
"name": "The Black Swan Pub",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001093401978",
"name": "Senti Menti",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Славянская площадь, 2/5/4 ст3",
"id": "70000001007260074",
"name": "Либерти, ночной клуб",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Лубянский проезд, 25 ст1",
"id": "4504127908781677",
"name": "Китайский Лётчик Джао Да, кафе-клуб",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001047225231",
"name": "Хачапури и вино, кафе грузинской кухни",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Славянская площадь, 2/5",
"id": "4504128908449647",
"name": "True Cost, прожектор",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001082439498",
"name": "Chang, кафе",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "Лубянский проезд, 25 ст2",
"id": "70000001036209541",
"name": "Старый Сычуань, ресторан азиатской и восточной кухни",
"type": "branch"
},
{
"address_name": "Лубянский проезд, 25 ст2",
"id": "70000001104075510",
"name": "Пио Розелло, бар-ресторан",
"type": "branch"
}
],
"total": 1180
}
}
По наличию торговой лицензии
Чтобы отфильтровать результаты поиска по наличию торговой лицензии у организации, отправьте GET-запрос к /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».location— координаты точки поиска в форматедолгота,широта, напримерlocation=55.250708,25.134877. Вы можете указать геоограничение другим способом: подробнее см. в инструкции Геоограничение поиска.has_trade_license=true— фильтр по наличию торговой лицензии.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&location=55.250708,25.134877&has_trade_license=true&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20949",
"code": 200,
"issue_date": "20260707"
},
"result": {
"items": [
{
"address_comment": "G Floor",
"address_name": "Al Ghurair Industries Labour Camp, 37, 28 street",
"id": "70000001067897394",
"name": "Cook Book, restaurant",
"type": "branch"
},
{
"address_comment": "G Floor",
"address_name": "Arabian Master Of Waste Staff Accommodation, 46, Al Zumorrod Street street",
"id": "70000001067897451",
"name": "Chik Baik, restaurant",
"type": "branch"
},
{
"address_name": "51a, Al Zumorrod Street street",
"id": "70000001036077037",
"name": "Lahori Darbar, restaurant",
"type": "branch"
},
{
"address_name": "Super Bonanza Hypermarket, 68, 22 street",
"building_name": "Super Bonanza Hypermarket",
"full_name": "Dubai, Super Bonanza Hypermarket",
"id": "70000001006476170",
"name": "Super Bonanza, hypermarket",
"purpose_name": "Hypermarket",
"type": "branch"
},
{
"address_comment": "G Floor",
"address_name": "Epsco Staff Accomodation, 25/1, Al Zumorrod Street street",
"id": "70000001060057959",
"name": "Sarab Al Madina, restaurant",
"type": "branch"
},
{
"address_comment": "Ground Floor",
"address_name": "Almarai Emirates Company, 36, Al Zumorrod Street street",
"id": "70000001036075376",
"name": "Chimney Light, restaurant",
"type": "branch"
},
{
"address_comment": "G Floor",
"address_name": "Top Form Restaurant, 31a1, Al Zumorrod Street street",
"building_name": "Top Form Restaurant",
"full_name": "Dubai, Top Form Restaurant",
"id": "70000001047115180",
"name": "Top Form 2, restaurant",
"purpose_name": "Restaurant",
"type": "branch"
},
{
"address_name": "64, Al Zumorrod Street street",
"id": "70000001006449199",
"name": "Green Pepper, restaurant",
"type": "branch"
},
{
"address_comment": "G Floor",
"address_name": "Al Shafar National Contracting Labour Accomodation, 20, 28 street",
"id": "70000001006473665",
"name": "Food Point, restaurant",
"type": "branch"
},
{
"address_comment": "G Floor",
"address_name": "Vikas Building Contracting Labour Accomodation, 50c, 28 street",
"id": "70000001092828231",
"name": "Kana Ram, vegetarian restaurant",
"type": "branch"
}
],
"total": 982
}
}
По наличию фотографий
С помощью параметра has_photos вы можете получить список организаций, в карточку которых добавлены фотографии. Получение самих фотографий недоступно.
Чтобы отфильтровать результаты поиска по наличию фотографий у организации, отправьте GET-запрос к /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».location— координаты точки поиска в форматедолгота,широта, напримерlocation=37.630866,55.752256. Вы можете указать геоограничение другим способом: подробнее см. в инструкции Геоограничение поиска.has_photos=true— фильтр по наличию фотографий.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&location=37.630866,55.752256&has_photos=true&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260630"
},
"result": {
"items": [
{
"address_name": "улица Варварка, 6 ст3",
"id": "70000001029535674",
"name": "Зарядье, гастрономический центр",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001032763462",
"name": "The Black Swan Pub",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001093401978",
"name": "Senti Menti",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Славянская площадь, 2/5/4 ст3",
"id": "70000001007260074",
"name": "Либерти, ночной клуб",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Лубянский проезд, 25 ст1",
"id": "4504127908781677",
"name": "Китайский Лётчик Джао Да, кафе-клуб",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001047225231",
"name": "Хачапури и вино, кафе грузинской кухни",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Новая площадь, 14",
"id": "70000001109804763",
"name": "Rusty Rat&Pizza",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Славянская площадь, 2/5",
"id": "4504128908449647",
"name": "True Cost, прожектор",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001082439498",
"name": "Chang, кафе",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "Лубянский проезд, 25 ст2",
"id": "70000001036209541",
"name": "Старый Сычуань, ресторан азиатской и восточной кухни",
"type": "branch"
}
],
"total": 1251
}
}
По наличию рейтинга
С помощью параметра has_rating вы можете получить список организаций, у которых есть рейтинг на 2gis.ru. Получение значения рейтинга недоступно.
Чтобы отфильтровать результаты поиска по наличию рейтинга у организации, отправьте GET-запрос к /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».location— координаты точки поиска в форматедолгота,широта, напримерlocation=37.630866,55.752256. Вы можете указать геоограничение другим способом: подробнее см. в инструкции Геоограничение поиска.has_rating=true— фильтр по наличию рейтинга.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&location=37.630866,55.752256&has_rating=true&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260630"
},
"result": {
"items": [
{
"address_name": "улица Варварка, 6 ст3",
"id": "70000001029535674",
"name": "Зарядье, гастрономический центр",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001032763462",
"name": "The Black Swan Pub",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Славянская площадь, 2/5/4 ст3",
"id": "70000001007260074",
"name": "Либерти, ночной клуб",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Лубянский проезд, 25 ст1",
"id": "4504127908781677",
"name": "Китайский Лётчик Джао Да, кафе-клуб",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Славянская площадь, 2/5",
"id": "4504128908449647",
"name": "True Cost, прожектор",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1",
"id": "70000001032240412",
"name": "22 сантиметра, пиццерия",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Лубянский проезд, 25 ст2",
"id": "70000001033268818",
"name": "Моя Вивьен, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Большой Спасоглинищевский переулок, 3 ст5",
"id": "70000001046746120",
"name": "Пестики-тычинки, бар",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Лубянский проезд, 15 ст2",
"id": "70000001007210203",
"name": "Casa Leone, итальянское кафе-джелатерия",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Маросейка, 6/8 ст1",
"id": "4504127918793096",
"name": "Бардак, кафе турецкой кухни",
"type": "branch"
}
],
"total": 486
}
}
По наличию отзывов
С помощью параметра has_reviews вы можете получить список организаций, у которых есть отзывы на 2gis.ru. Получение отзывов недоступно.
Чтобы отфильтровать результаты поиска по наличию отзывов у организации, отправьте GET-запрос к /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».location— координаты точки поиска в форматедолгота,широта, напримерlocation=37.630866,55.752256. Вы можете указать геоограничение другим способом: подробнее см. в инструкции Геоограничение поиска.has_reviews=true— фильтр по наличию отзывов.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&location=37.630866,55.752256&has_reviews=true&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260630"
},
"result": {
"items": [
{
"address_name": "улица Варварка, 6 ст3",
"id": "70000001029535674",
"name": "Зарядье, гастрономический центр",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001032763462",
"name": "The Black Swan Pub",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001093401978",
"name": "Senti Menti",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Славянская площадь, 2/5/4 ст3",
"id": "70000001007260074",
"name": "Либерти, ночной клуб",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Лубянский проезд, 25 ст1",
"id": "4504127908781677",
"name": "Китайский Лётчик Джао Да, кафе-клуб",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001047225231",
"name": "Хачапури и вино, кафе грузинской кухни",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Новая площадь, 14",
"id": "70000001109804763",
"name": "Rusty Rat&Pizza",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Славянская площадь, 2/5",
"id": "4504128908449647",
"name": "True Cost, прожектор",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001082439498",
"name": "Chang, кафе",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "Лубянский проезд, 25 ст2",
"id": "70000001036209541",
"name": "Старый Сычуань, ресторан азиатской и восточной кухни",
"type": "branch"
}
],
"total": 1215
}
}
По наличию сайта
Чтобы отфильтровать результаты поиска по наличию сайта у организации, отправьте GET-запрос к /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».location— координаты точки поиска в форматедолгота,широта, напримерlocation=37.630866,55.752256. Вы можете указать геоограничение другим способом: подробнее см. в инструкции Геоограничение поиска.has_site=true— фильтр по наличию сайта.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&location=37.630866,55.752256&has_site=true&key=API_KEY
Пример ответа:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260630"
},
"result": {
"items": [
{
"address_name": "улица Варварка, 6 ст3",
"id": "70000001029535674",
"name": "Зарядье, гастрономический центр",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001032763462",
"name": "The Black Swan Pub",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001093401978",
"name": "Senti Menti",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Славянская площадь, 2/5/4 ст3",
"id": "70000001007260074",
"name": "Либерти, ночной клуб",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Лубянский проезд, 25 ст1",
"id": "4504127908781677",
"name": "Китайский Лётчик Джао Да, кафе-клуб",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001047225231",
"name": "Хачапури и вино, кафе грузинской кухни",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Новая площадь, 14",
"id": "70000001109804763",
"name": "Rusty Rat&Pizza",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Славянская площадь, 2/5",
"id": "4504128908449647",
"name": "True Cost, прожектор",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001082439498",
"name": "Chang, кафе",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "Лубянский проезд, 25 ст2",
"id": "70000001036209541",
"name": "Старый Сычуань, ресторан азиатской и восточной кухни",
"type": "branch"
}
],
"total": 973
}
}
По дополнительным атрибутам
С помощью параметра attr вы можете получить список организаций по дополнительным атрибутам, которые содержат справочную информацию об организациях:
- есть ли Wi-Fi или доставка;
- какой средний чек, ассортимент и виды услуг;
- можно ли взять кофе с собой и т. д.
Список дополнительных атрибутов может меняться и зависит от региона и запроса. Гарантируется только структура ответа, но не его содержимое.
-
Чтобы посмотреть список дополнительных атрибутов, отправьте GET-запрос к /3.0/items со следующими параметрами:
q— текстовый запрос, например «кафе».location— координаты точки поиска в форматедолгота,широта, напримерlocation=37.630866,55.752256. Вы можете указать геоограничение другим способом: подробнее см. в инструкции Геоограничение поиска.fields=filters— включает в ответ список доступных фильтров для поиска.
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&location=37.630866,55.752256&fields=filters&key=API_KEYПример ответа:
response.json{"meta": {"api_version": "3.0.20926","code": 200,"issue_date": "20260630"},"result": {"filters": {"attributes": [{"tag": "rating","type": "sort"},{"tag": "opened_time","type": "sort"},{"tag": "name","type": "sort"},{"tag": "bound","type": "filter"},{"tag": "district"},{"tag": "worktime"},{"tag": "has_site","type": "filter"},{"tag": "subway"},{"tag": "has_photos","type": "filter"},{"tag": "food_service_type_of_breakfast_english_breakfast","label": "Английский завтрак","type": "flag"},{"tag": "food_service_assortment_assortment_cheese_sticks","label": "Сырные палочки","type": "flag"},{"tag": "food_service_assortment_assortment_pyanse","label": "Пянсе","type": "flag"},{"tag": "food_service_bar_type_blinye","label": "Блинные","type": "flag"},{"tag": "food_service_assortment_assortment_soups","label": "Супы","type": "flag"},{"tag": "food_service_assortment_assortment_crumpet","label": "Пышки","type": "flag"},{"tag": "food_service_assortment_assortment_burrito","label": "Буррито","type": "flag"},{"tag": "atmosphere_place_features_healthy_food","label": "Здоровое меню","type": "flag"},{"tag": "food_service_food_korean","label": "Корейская кухня","type": "flag"},{"tag": "food_service_lunch_cost","label": "Стоимость бизнес-ланча","type": "range","range": {"max": 2000.0,"min": 150.0}},...],"rubrics": [{"count": 99,"id": "161","name": "Кафе"},{"count": 47,"id": "159","name": "Бары"},{"count": 46,"id": "1203","name": "Доставка еды"},{"count": 6,"id": "164","name": "Рестораны"},{"count": 4,"id": "51459","name": "Пиццерии"},{"count": 3,"id": "173","name": "Ночные клубы"},{"count": 3,"id": "165","name": "Быстрое питание"},{"count": 2,"id": "363","name": "Кондитерские изделия"},{"count": 2,"id": "162","name": "Кофейни"},{"count": 2,"id": "112670","name": "Интересные здания"},{"count": 2,"id": "21387","name": "Караоке-залы"},{"count": 2,"id": "10803","name": "Банкетные залы"},{"count": 1,"id": "111506","name": "Аренда концертных площадок"},{"count": 1,"id": "16677","name": "Кулинарии"},{"count": 1,"id": "58871","name": "Точки кофе"},{"count": 1,"id": "469","name": "Мороженое"},{"count": 1,"id": "110357","name": "Центры паровых коктейлей"},{"count": 1,"id": "112617","name": "Стендап-клубы"},{"count": 1,"id": "9786","name": "Кейтеринг"},{"count": 1,"id": "360","name": "Алкогольные напитки"},{"count": 1,"id": "166","name": "Столовые"}],"spatial": {"cities": [{"count": 100,"id": "4504222397630173","name": "Москва г. (Москва город фед. значения, Россия)"}],"districts": [{"city_id": "4504222397630173","id": "4504209512726540","name": "Красносельский"},{"city_id": "4504222397630173","id": "4504209512726536","name": "Тверской"},{"city_id": "4504222397630173","id": "4504209512726531","name": "Басманный"},{"city_id": "4504222397630173","id": "4504209512726535","name": "Мещанский"},{"city_id": "4504222397630173","id": "4504209512726538","name": "Таганский"},{"city_id": "4504222397630173","id": "4504209512726532","name": "Замоскворечье"}]}},"items": [{"address_name": "улица Варварка, 6 ст3","id": "70000001029535674","name": "Зарядье, гастрономический центр","type": "branch"},{"address_comment": "1 этаж","address_name": "улица Солянка, 1/2","id": "70000001032763462","name": "The Black Swan Pub","type": "branch"},{"address_comment": "1 этаж","address_name": "улица Солянка, 1/2 ст1","id": "70000001093401978","name": "Senti Menti","type": "branch"},{"address_comment": "цокольный этаж","address_name": "Славянская площадь, 2/5/4 ст3","id": "70000001007260074","name": "Либерти, ночной клуб","type": "branch"},{"address_comment": "цокольный этаж","address_name": "Лубянский проезд, 25 ст1","id": "4504127908781677","name": "Китайский Лётчик Джао Да, кафе-клуб","type": "branch"},{"address_comment": "1 этаж","address_name": "улица Солянка, 1/2","id": "70000001047225231","name": "Хачапури и вино, кафе грузинской кухни","type": "branch"},{"address_comment": "1 этаж","address_name": "Новая площадь, 14","id": "70000001109804763","name": "Rusty Rat&Pizza","type": "branch"},{"address_comment": "1 этаж","address_name": "Славянская площадь, 2/5","id": "4504128908449647","name": "True Cost, прожектор","type": "branch"},{"address_comment": "1 этаж","address_name": "улица Солянка, 1/2 ст1","id": "70000001082439498","name": "Chang, кафе","type": "branch"},{"address_comment": "2 этаж","address_name": "Лубянский проезд, 25 ст2","id": "70000001036209541","name": "Старый Сычуань, ресторан азиатской и восточной кухни","type": "branch"}],"total": 1289}}Дополнительные атрибуты перечислены в поле
result.filters.attributes. -
Чтобы отфильтровать результаты поиска по дополнительным атрибутам, отправьте GET-запрос к /3.0/items со следующими параметрами:
-
q— текстовый запрос, например «кафе». -
location— координаты точки поиска в форматедолгота,широта, напримерlocation=37.630866,55.752256. Вы можете указать геоограничение другим способом: подробнее см. в инструкции Геоограничение поиска. -
attr[<code>]=<value>— фильтр по дополнительному атрибуту. Если вы укажете несколько атрибутов, в ответ попадут только объекты, которые удовлетворяют всем условиям. Для каждого атрибута укажите:-
<code>— код дополнительного атрибута из поляresult.filters.attributes.tag. -
<value>— значение дополнительного атрибута, зависит от типа атрибута из поляresult.filters.attributes.type:Тип атрибута Тип значения Пример flagБулево значение attr[food_service_business_lunch]=truerangeДиапазон из двух чисел, перечисленных через запятую attr[food_service_capacity]=10,30
-
Пример запроса:
https://catalog.api.2gis.com/3.0/items?q=кафе&location=37.630866,55.752256&attr[food_service_food_korean]=true&attr[food_service_lunch_cost]=0,1500&key=API_KEYПример ответа:
response.json{"meta": {"api_version": "3.0.20926","code": 200,"issue_date": "20260630"},"result": {"items": [{"address_comment": "цокольный, 1 этаж","address_name": "Петровский бульвар, 15 ст1","id": "70000001066422742","name": "Kook, бистро корейской кухни","type": "branch"},{"address_comment": "цокольный этаж; правый торец","address_name": "Новослободская улица, 26 ст1","id": "70000001046256911","name": "Korean Grill BBQ Tokpokki, кафе","type": "branch"},{"address_name": "улица Шаболовка, 24 ст1","id": "70000001105112966","name": "Рамен бульон","type": "branch"}],"total": 3}} -