Filtering by attributes
You can filter search results and obtain lists of organizations:
- by working hours
- by opening date
- by the availability or absence of data: individual taxpayer identification number, trade license, photos, rating, reviews, and website
- by additional attributes
By working hours
Using the work_time parameter, you can obtain a list of organizations that are open at a particular time, for example, only branches that are open 24/7.
To filter search results by organization working hours, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".location- search point coordinates in thelongitude,latitudeformat, for examplelocation=37.630866,55.752256. You can specify georestriction in another way: for more information, see the Search georestriction instruction.work_time- filter by working hours, for examplework_time=today,09:00to obtain organizations that are open today at 09:00.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&location=37.630866,55.752256&work_time=today,09:00&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260630"
},
"result": {
"items": [
{
"address_name": "Лубянский проезд, 25 ст2",
"id": "70000001104075510",
"name": "Пио Розелло, бар-ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Лубянский проезд, 25 ст2",
"id": "70000001033268818",
"name": "Моя Вивьен, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Большой Спасоглинищевский переулок, 9/1 ст16",
"id": "70000001026155685",
"name": "Шоколадница, кофейня",
"type": "branch"
},
{
"address_comment": "-2 этаж; Средний уровень",
"address_name": "Манежная площадь, 1 ст2",
"id": "70000001007179642",
"name": "Му-Му, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Маросейка, 3/13 ст1",
"id": "4504127908427099",
"name": "Шоколадница, кофейня",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Садовническая улица, 8",
"id": "70000001038242964",
"name": "Coffee inn, кафе",
"type": "branch"
},
{
"address_comment": "-1 этаж",
"address_name": "Никольская улица, 10",
"id": "70000001063453523",
"name": "Beverly hills diner, семейный ресторан",
"type": "branch"
},
{
"address_comment": "3 этаж",
"address_name": "улица Маросейка, 2/15 ст1",
"id": "70000001067561966",
"name": "2/15, кафе-бар",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "улица Покровка, 2",
"id": "4504127908550760",
"name": "Золотая вобла, народный бар",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Петровка, 12 ст1",
"id": "70000001082567555",
"name": "Miss you cafe, кафе",
"type": "branch"
}
],
"total": 406
}
}
By opening date
Using the opened_after_date parameter, you can obtain a list of organizations that opened after a particular date.
To filter search results by organization opening date, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".location- search point coordinates in thelongitude,latitudeformat, for examplelocation=37.630866,55.752256. You can specify georestriction in another way: for more information, see the Search georestriction instruction.opened_after_date- filter by opening date, for exampleopened_after_date=2026-06-01to obtain organizations that opened after June 1, 2026.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&location=37.630866,55.752256&opened_after_date=2026-06-01&key=API_KEY
Response example:
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
}
}
By ITIN availability
To filter search results by availability of the individual taxpayer identification number for an organization, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".location- search point coordinates in thelongitude,latitudeformat, for examplelocation=37.630866,55.752256. You can specify georestriction in another way: for more information, see the Search georestriction instruction.has_itin=true- filter by availability of the individual taxpayer identification number.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&location=37.630866,55.752256&has_itin=true&key=API_KEY
Response example:
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
}
}
By trade license availability
To filter search results by trade license availability for an organization, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".location- search point coordinates in thelongitude,latitudeformat, for examplelocation=55.250708,25.134877. You can specify georestriction in another way: for more information, see the Search georestriction instruction.has_trade_license=true- filter by trade license availability.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&location=55.250708,25.134877&has_trade_license=true&key=API_KEY
Response example:
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
}
}
By photo availability
Using the has_photos parameter, you can obtain a list of organizations that have photos added to their profile. Obtaining the photos is not supported.
To filter search results by photo availability for an organization, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".location- search point coordinates in thelongitude,latitudeformat, for examplelocation=37.630866,55.752256. You can specify georestriction in another way: for more information, see the Search georestriction instruction.has_photos=true- filter by photo availability.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&location=37.630866,55.752256&has_photos=true&key=API_KEY
Response example:
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
}
}
By rating availability
Using the has_rating parameter, you can obtain a list of organizations that have a rating on 2gis.ru. Obtaining the rating value is not supported.
To filter search results by rating availability for an organization, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".location- search point coordinates in thelongitude,latitudeformat, for examplelocation=37.630866,55.752256. You can specify georestriction in another way: for more information, see the Search georestriction instruction.has_rating=true- filter by rating availability.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&location=37.630866,55.752256&has_rating=true&key=API_KEY
Response example:
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
}
}
By reviews availability
Using the has_reviews parameter, you can obtain a list of organizations that have reviews on 2gis.ru. Obtaining the reviews is not supported.
To filter search results by reviews availability for an organization, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".location- search point coordinates in thelongitude,latitudeformat, for examplelocation=37.630866,55.752256. You can specify georestriction in another way: for more information, see the Search georestriction instruction.has_reviews=true- filter by review availability.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&location=37.630866,55.752256&has_reviews=true&key=API_KEY
Response example:
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
}
}
By website availability
To filter search results by website availability for an organization, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".location- search point coordinates in thelongitude,latitudeformat, for examplelocation=37.630866,55.752256. You can specify georestriction in another way: for more information, see the Search georestriction instruction.has_site=true- filter by website availability.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&location=37.630866,55.752256&has_site=true&key=API_KEY
Response example:
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
}
}
By additional attributes
Using the attr parameter, you can obtain a list of organizations by additional attributes that contain reference information about organizations:
- whether they have Wi-Fi or delivery
- what is the average check, assortment, and types of services
- whether you can get coffee to go, etc.
warning
The list of additional attributes may vary depending on the region and request. Only the response structure is guaranteed, not its content.
-
To view the list of additional attributes, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".location- search point coordinates in thelongitude,latitudeformat, for examplelocation=37.630866,55.752256. You can specify georestriction in another way: for more information, see the Search georestriction instruction.fields=filters- includes the list of available filters in the response.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&location=37.630866,55.752256&fields=filters&key=API_KEYResponse example:
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
}
}Additional attributes are listed in the
result.filters.attributesfield. -
To filter search results by additional attributes, send a GET request to /3.0/items with the following parameters:
-
q- text query, for example "cafe". -
location- search point coordinates in thelongitude,latitudeformat, for examplelocation=37.630866,55.752256. You can specify georestriction in another way: for more information, see the Search georestriction instruction. -
attr[<code>]=<value>- filter by additional attribute. If you specify multiple attributes, only objects that satisfy all conditions will be included in the response. For each attribute, specify the following:-
<code>- additional attribute code from theresult.filters.attributes.tagfield. -
<value>- additional attribute value, depends on the attribute type from theresult.filters.attributes.typefield:Attribute type Value type Example flagBoolean value attr[food_service_business_lunch]=truerangeRange of two numbers separated by a comma attr[food_service_capacity]=10,30
-
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&location=37.630866,55.752256&attr[food_service_food_korean]=true&attr[food_service_lunch_cost]=0,1500&key=API_KEYResponse example:
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
}
} -