Search georestriction
To improve the accuracy of searching for objects when using the /3.0/items endpoint, specify a georestriction in the form of:
- text query
- search point coordinates
- radius around a point
- rectangular area
- arbitrary area
- viewport
- region
- city
- district
- place
- metro station near which to search
- building
You cannot simultaneously specify georestrictions by radius, rectangular, and arbitrary area (the point, point1/point2, and polygon parameters).
When using other endpoints, you can omit the georestriction.
Text query
You can specify a georestriction in the q parameter: name of a region, city, district, street, metro station, etc.
You can specify both the object and georestriction in the q parameter simultaneously, for example cafe in Tverskoy district Moscow. Only one q parameter can be specified in a request. For more information about searching for objects, see the Searching for objects instruction.
To specify a georestriction as text, send a GET request to /3.0/items with the q parameter - a text query containing the georestriction, for example "cafe pyatnitskaya street moscow".
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe pyatnitskaya street moscow&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.20949",
"code": 200,
"issue_date": "20260716"
},
"result": {
"items": [
{
"address_comment": "1 этаж",
"address_name": "Пятницкая улица, 3/4 ст1",
"id": "70000001059479230",
"name": "Хачапури и вино, кафе грузинской кухни",
"type": "branch"
},
{
"address_comment": "-1, 1 этаж",
"address_name": "Пятницкая улица, 54 ст2",
"id": "70000001048389948",
"name": "Nicepricecafe, кафе",
"type": "branch"
},
{
"address_comment": "3 этаж",
"address_name": "Пятницкая улица, 29",
"id": "70000001089085648",
"name": "True Cost, рестобар",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Пятницкая улица, 6/1 ст1",
"id": "70000001084006818",
"name": "J`pan, японское кафе",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "Пятницкая улица, 29",
"id": "4504128908766878",
"name": "Козловица, чешская пивная",
"type": "branch"
},
{
"address_name": "Большая Серпуховская улица, 8/7 ст2",
"id": "70000001096198692",
"name": "Чико, кафе корейского стритфуда",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Пятницкий переулок, 4 ст1",
"id": "70000001077266426",
"name": "Старик Хинкалыч, хинкальная",
"type": "branch"
},
{
"address_name": "Пятницкая улица, 45",
"full_name": "Москва, Пятницкая улица, 45",
"id": "70000001077023503",
"name": "Ra`men, рамен-бар",
"purpose_name": "Кафе, бар",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Пятницкая улица, 25 ст1д",
"id": "70000001041362439",
"name": "Хатико, бар",
"type": "branch"
},
{
"address_name": "Пятницкая улица, 9/28 ст1",
"id": "70000001104445620",
"name": "Бардак, кафе турецкой кухни",
"type": "branch"
}
],
"total": 79
}
}
Point coordinates
Using the location parameter, you can restrict the search by point coordinates. The closest objects to the point will be listed first in the response.
To specify a point as the search area, 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.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&location=37.630866,55.752256&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260701"
},
"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": 1290
}
}
Radius around a point
Using the radius parameter, you can find all objects within a radius around a point. The point can be specified using the point parameter or a pair of lon and lat parameters.
The maximum radius is 50,000 m. If the object is not specified in the request as a text query (q parameter) or in another form (for example, as the org_id organization ID), the maximum radius is 2,000 m. It is recommended to specify the object in the request to obtain more accurate search results: see the request example.
To specify a search radius, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".point- coordinates of the search center point in thelongitude,latitudeformat, for examplepoint=37.630866,55.752256.radius- search radius in meters, for exampleradius=500.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&point=37.630866,55.752256&radius=500&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260702"
},
"result": {
"items": [
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001032763462",
"name": "The Black Swan Pub",
"type": "branch"
},
{
"address_name": "улица Варварка, 6 ст3",
"id": "70000001029535674",
"name": "Зарядье, гастрономический центр",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001093401978",
"name": "Senti Menti",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001047225231",
"name": "Хачапури и вино, кафе грузинской кухни",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2 ст1",
"id": "70000001082439498",
"name": "Chang, кафе",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Лубянский проезд, 25 ст1",
"id": "4504127908781677",
"name": "Китайский Лётчик Джао Да, кафе-клуб",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1",
"id": "70000001032240412",
"name": "22 сантиметра, пиццерия",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Славянская площадь, 2/5/4 ст3",
"id": "70000001007260074",
"name": "Либерти, ночной клуб",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Славянская площадь, 2/5",
"id": "4504128908449647",
"name": "True Cost, прожектор",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Лубянский проезд, 15 ст2",
"id": "70000001007210203",
"name": "Casa Leone, итальянское кафе-джелатерия",
"type": "branch"
}
],
"total": 26
}
}
Rectangular area
Using the point1 and point2 parameters, you can limit search results to a rectangular area by specifying the coordinates of the top-left and bottom-right area corners. The maximum distance between points is two kilometers.
To specify a rectangular search area, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".point1- coordinates of the top-left corner of the rectangular area in thelongitude,latitudeformat, for example37.609194,55.773293.point2- coordinates of the bottom-right corner of the rectangular area in thelongitude,latitudeformat, for example37.621403,55.767303.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&point1=37.609194,55.773293&point2=37.621403,55.767303&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260701"
},
"result": {
"items": [
{
"address_comment": "1 этаж",
"address_name": "Садовая-Самотечная улица, 20 ст1",
"id": "70000001069631787",
"name": "from Berlin, винный ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Петровка, 30/7",
"id": "70000001090847868",
"name": "Nothing Fancy, кафе",
"type": "branch"
},
{
"address_name": "Цветной бульвар, 11 ст3",
"full_name": "Москва, Цветной бульвар, 11 ст3",
"id": "70000001110827038",
"name": "Евгенич, бар",
"purpose_name": "Ресторан",
"type": "branch"
},
{
"address_comment": "цокольный, 1 этаж",
"address_name": "Петровский бульвар, 15 ст1",
"id": "70000001066422742",
"name": "Kook, бистро корейской кухни",
"type": "branch"
},
{
"address_name": "улица Петровка, 34 ст1",
"id": "70000001103813228",
"name": "Санто Джованни, ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Цветной бульвар, 21 ст7",
"id": "70000001037519913",
"name": "Ra`men, рамен-бар",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Цветной бульвар, 21 ст2",
"id": "70000001035056426",
"name": "Майкл Коллинз, ирландский паб",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Садовая-Каретная улица, 20 ст2",
"id": "4504127913846311",
"name": "Delicatessen, бар",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Садовая-Самотечная улица, 18 ст1",
"id": "70000001066596627",
"name": "Практика by Darvin, винный бар",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Цветной бульвар, 25 ст1",
"id": "70000001006156339",
"name": "Пипл&Паста, паста-бар",
"type": "branch"
}
],
"total": 23
}
}
Arbitrary area
To specify an arbitrary search area (polygon), send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".polygon- coordinates of the polygon vertices in WKT format.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&polygon=POLYGON((37.6146002 55.761322, 37.6175267 55.7628083, 37.6184916 55.7615712, 37.6152171 55.7605209, 37.6146002 55.761322))&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.20949",
"code": 200,
"issue_date": "20260707"
},
"result": {
"items": [
{
"address_comment": "1 этаж",
"address_name": "улица Большая Дмитровка, 10/2 ст4",
"id": "70000001094146856",
"name": "J`pan, японское кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Большая Дмитровка, 12/1",
"id": "70000001100859771",
"name": "Хачапури и вино, кафе грузинской кухни",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Большая Дмитровка, 7/5 ст5",
"id": "4504128908372099",
"name": "Moloko, кафе",
"type": "branch"
}
],
"total": 3
}
}
Viewport
Using the viewpoint1 and viewpoint2 parameters, you can limit search results by viewport (a rectangular map area). Unlike the rectangular area georestriction, the viewport affects the ranking of results, but does not strictly limit the search to the specified boundaries.
To specify a viewport, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".viewpoint1- coordinates of the top-left corner of the rectangular area in thelongitude,latitudeformat, for example37.609194,55.773293.viewpoint2- coordinates of the bottom-right corner of the rectangular area in thelongitude,latitudeformat, for example37.621403,55.767303.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&viewpoint1=37.609194,55.773293&viewpoint2=37.621403,55.767303&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260701"
},
"result": {
"items": [
{
"address_comment": "1 этаж",
"address_name": "улица Петровка, 30/7",
"id": "70000001090847868",
"name": "Nothing Fancy, кафе",
"type": "branch"
},
{
"address_name": "улица Петровка, 34 ст1",
"id": "70000001103813228",
"name": "Санто Джованни, ресторан",
"type": "branch"
},
{
"address_comment": "цокольный, 1 этаж",
"address_name": "Петровский бульвар, 15 ст1",
"id": "70000001066422742",
"name": "Kook, бистро корейской кухни",
"type": "branch"
},
{
"address_name": "Страстной бульвар, 12 ст5",
"id": "70000001038478346",
"name": "Салют, велокафе",
"type": "branch"
},
{
"address_name": "Цветной бульвар, 11 ст3",
"full_name": "Москва, Цветной бульвар, 11 ст3",
"id": "70000001110827038",
"name": "Евгенич, бар",
"purpose_name": "Ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Садовая-Самотечная улица, 20 ст1",
"id": "70000001069631787",
"name": "from Berlin, винный ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Цветной бульвар, 21 ст7",
"id": "70000001037519913",
"name": "Ra`men, рамен-бар",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Цветной бульвар, 21 ст2",
"id": "70000001035056426",
"name": "Майкл Коллинз, ирландский паб",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Страстной бульвар, 8а",
"id": "70000001051182296",
"name": "Моремания, кафе-магазин",
"type": "branch"
},
{
"address_comment": "цокольный этаж",
"address_name": "Садовая-Каретная улица, 20 ст2",
"id": "4504127913846311",
"name": "Delicatessen, бар",
"type": "branch"
}
],
"total": 2721
}
}
Region
Using the region_id parameter, you can limit search results to a region by specifying its identifier. The maximum number of regions in a request is 50.
To specify a region as the search area, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".region_id- region ID, for exampleregion_id=32. For more information on obtaining an ID, see the Region ID section.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe®ion_id=32&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260701"
},
"result": {
"items": [
{
"address_comment": "1, 2 этаж",
"address_name": "2-я Останкинская улица, 3",
"id": "70000001096768454",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001032763462",
"name": "The Black Swan Pub",
"type": "branch"
},
{
"address_comment": "4 этаж",
"address_name": "улица Земляной Вал, 33",
"id": "70000001098878843",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "-2 этаж; Средний уровень",
"address_name": "Манежная площадь, 1 ст2",
"id": "70000001007179642",
"name": "Му-Му, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Новослободская улица, 16",
"id": "70000001062465220",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Душинская улица, 14",
"id": "70000001037319561",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "Большая Тульская улица, 13",
"id": "70000001068109619",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Новая площадь, 14",
"id": "70000001109804763",
"name": "Rusty Rat&Pizza",
"type": "branch"
},
{
"address_comment": "1-2 этаж",
"address_name": "Новинский бульвар, 31",
"id": "70000001077241148",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_name": "улица Варварка, 6 ст3",
"id": "70000001029535674",
"name": "Зарядье, гастрономический центр",
"type": "branch"
}
],
"total": 8742
}
}
City
Using the city_id parameter, you can limit search results to a city by specifying its identifier. The maximum number of cities in a request is 50.
To specify a city as the search area, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".city_id- city ID, for examplecity_id=4504222397630173. You can use multiple IDs separated by commas, for examplecity_id=4504222397630173,4504222397630174. For more information on obtaining an ID, see the City ID section.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&city_id=4504222397630173&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.20949",
"code": 200,
"issue_date": "20260716"
},
"result": {
"items": [
{
"address_comment": "1, 2 этаж",
"address_name": "2-я Останкинская улица, 3",
"id": "70000001096768454",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Солянка, 1/2",
"id": "70000001032763462",
"name": "The Black Swan Pub",
"type": "branch"
},
{
"address_comment": "-2 этаж; Средний уровень",
"address_name": "Манежная площадь, 1 ст2",
"id": "70000001007179642",
"name": "Му-Му, кафе",
"type": "branch"
},
{
"address_comment": "4 этаж",
"address_name": "улица Земляной Вал, 33",
"id": "70000001098878843",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Душинская улица, 14",
"id": "70000001037319561",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Новослободская улица, 16",
"id": "70000001062465220",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Новая площадь, 14",
"id": "70000001109804763",
"name": "Rusty Rat&Pizza",
"type": "branch"
},
{
"address_comment": "3 этаж",
"address_name": "Можайское шоссе, 45Б",
"id": "70000001063551091",
"name": "Руки Вверх!, бар",
"type": "branch"
},
{
"address_name": "улица Варварка, 6 ст3",
"id": "70000001029535674",
"name": "Зарядье, гастрономический центр",
"type": "branch"
},
{
"address_name": "Сущёвская улица, 21 ст8",
"full_name": "Москва, Сущёвская улица, 21 ст8",
"id": "70000001021629955",
"name": "Молодежь, ночной клуб-рестобар",
"purpose_name": "Кафе, бар",
"type": "branch"
}
],
"total": 5039
}
}
District
Using the district_id parameter, you can limit search results to a district by specifying its identifier. The maximum number of districts in a request is 50.
When using the district_id parameter, only objects with the "branch" type ("type": "branch") will be returned in the response.
To specify a district as the search area, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".district_id- district ID, for exampledistrict_id=4504209512726534. You can use multiple IDs separated by commas, for exampledistrict_id=4504209512726534,4504209512726539. For more information on obtaining an ID, see the District ID section.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&district_id=4504209512726534&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.20949",
"code": 200,
"issue_date": "20260715"
},
"result": {
"items": [
{
"address_comment": "2 этаж",
"id": "70000001112717191",
"name": "Substance, кафе с бильярдом",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Калужская площадь, 1 к1",
"id": "70000001110471401",
"name": "Kono, раменная из Азии",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Большая Полянка, 1/3",
"id": "4504128908478282",
"name": "Чайхона №1, ресторан",
"type": "branch"
},
{
"address_name": "Крымская набережная, 10 ст2",
"full_name": "Москва, Крымская набережная, 10 ст2",
"id": "70000001113359188",
"name": "Здрасте, кофейня",
"purpose_name": "Кафе, бар",
"type": "branch"
},
{
"address_name": "улица Шаболовка, 19",
"id": "70000001066388017",
"name": "Dizengof/99, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Крымский Вал, 9 ст32",
"id": "70000001006712029",
"name": "Гараж, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "улица Большая Полянка, 26 ст2",
"id": "70000001017909556",
"name": "Шоколадница, кофейня",
"type": "branch"
},
{
"address_name": "улица Крымский Вал, 9 ст21",
"full_name": "Москва, улица Крымский Вал, 9 ст21",
"id": "4504128908795031",
"name": "8 Oz, ресторан",
"purpose_name": "Ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Берсеневская набережная, 6 ст2",
"id": "70000001026770391",
"name": "Dictatura estetica, коктейльный бар",
"type": "branch"
},
{
"address_comment": "1-2 этаж",
"address_name": "улица Малая Якиманка, 24",
"id": "4504127908503148",
"name": "Квартира 44, кафе-бар",
"type": "branch"
}
],
"total": 65
}
}
Place
Using the place_id parameter, you can limit search results to a place by specifying its identifier. Places are area objects: parks, beaches, resort areas, lakes, and other locations. The maximum number of places in a request is 50.
To specify a place as the search area, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".place_id- place ID, for exampleplace_id=4504286822138302. You can use multiple IDs separated by commas, for exampleplace_id=4504286822138302,4504127908543952. For more information on obtaining an ID, see the Place ID section.location- search point coordinates in thelongitude,latitudeformat, for examplelocation=37.637635,55.826241.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&place_id=4504286822138302&location=37.637635,55.826241&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.20949",
"code": 200,
"issue_date": "20260716"
},
"result": {
"items": [
{
"address_comment": "1, 2 этаж",
"address_name": "2-я Останкинская улица, 3",
"id": "70000001096768454",
"name": "The Бык, демократичный мясной ресторан",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "проспект Мира, 119 ст521",
"full_name": "Москва, проспект Мира, 119 ст521",
"id": "70000001023459254",
"name": "Вареничная №1, кафе",
"purpose_name": "Кафе, бар",
"type": "branch"
},
{
"address_name": "проспект Мира, 119 ст523",
"full_name": "Москва, проспект Мира, 119 ст523",
"id": "70000001113876226",
"name": "Джонджоли, грузинский ресторан",
"purpose_name": "Ресторан",
"type": "branch"
},
{
"address_name": "2-я Останкинская улица, 3",
"id": "70000001069037911",
"name": "HookahPlace VDNH, лаундж-бар",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "1-я Останкинская улица, 57",
"id": "70000001080100038",
"name": "Фо Ши Мин, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "проспект Мира, 119 ст164",
"id": "70000001062580779",
"name": "Урожай, кафе-столовая",
"type": "branch"
},
{
"address_name": "проспект Мира, 119 ст337",
"full_name": "Москва, проспект Мира, 119 ст337",
"id": "70000001077390769",
"name": "Дача, кафе",
"purpose_name": "Кафе, бар",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "1-я Останкинская улица, 53",
"id": "4504127908370247",
"name": "Mezzo Forte, кафе-клуб",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "1-я Останкинская улица, 53",
"id": "4504127908705664",
"name": "Шашлычный двор, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "2-я Останкинская улица, 3",
"id": "70000001064053312",
"name": "Шоколадница, кофейня",
"type": "branch"
}
],
"total": 50
}
}
Metro station
Using the subway parameter, you can restrict the search by metro station. The maximum number of stations in a request is 50.
To specify a metro station near which to search, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".subway- metro station ID, for examplesubway=4504385606390686. You can use multiple IDs separated by commas, for examplesubway=4504385606388294,4504385606390686. For more information on obtaining an ID, see the Metro station ID section.location- search point coordinates in thelongitude,latitudeformat, for examplelocation=37.630866,55.752256.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&subway=4504385606390686&location=37.630866,55.752256&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.20926",
"code": 200,
"issue_date": "20260701"
},
"result": {
"items": [
{
"address_comment": "1 этаж",
"address_name": "Ломоносовский проспект, 25 к5",
"id": "70000001038965056",
"name": "Тянутая лапша Ланьчжоу, кафе",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "Вернадского проспект, вл6 ст3",
"id": "70000001090652654",
"name": "Рынок и общепит",
"type": "branch"
},
{
"address_name": "Ломоносовский проспект, 25 к5",
"id": "70000001087005251",
"name": "Китайский Самовар, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Ломоносовский проспект, 25 к5",
"id": "70000001069504590",
"name": "Hi Малатан, китайское кафе",
"type": "branch"
},
{
"address_name": "Ленинский проспект, 73/8",
"id": "70000001049547646",
"name": "Ниппон, кафе",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Ломоносовский проспект, 25 к1",
"id": "4504128908407264",
"name": "Шоколадница, кофейня",
"type": "branch"
},
{
"address_comment": "1 этаж",
"address_name": "Ленинский проспект, 68/10",
"id": "4504127908533690",
"name": "Якитория, японский ресторан",
"type": "branch"
},
{
"address_comment": "2 этаж",
"address_name": "площадь Джавахарлала Неру, 1",
"id": "70000001076978648",
"name": "Left & Right, кафе китайской кухни",
"type": "branch"
},
{
"address_name": "Ленинский проспект, 72/2",
"id": "70000001103161874",
"name": "1872, кафе",
"type": "branch"
},
{
"address_name": "Ломоносовский проспект, 25 к5",
"id": "70000001104314538",
"name": "Рисарт, кафе китайской кухни",
"type": "branch"
}
],
"total": 32
}
}
Building
Using the building_id parameter, you can limit search results to a building by specifying its identifier. The maximum number of buildings in a request is 50.
To specify a building as the search area, send a GET request to /3.0/items with the following parameters:
q- text query, for example "cafe".building_id- building ID, for examplebuilding_id=4504235299048514. You can use multiple IDs separated by commas, for examplebuilding_id=4504235299048514,4504235282736775. For more information on obtaining an ID, see the Building ID section.
Request example:
https://catalog.api.2gis.com/3.0/items?q=cafe&building_id=4504235299048514&key=API_KEY
Response example:
response.json
{
"meta": {
"api_version": "3.0.21070",
"code": 200,
"issue_date": "20260730"
},
"result": {
"items": [
{
"address_comment": "3 этаж",
"address_name": "Кадашёвская набережная, 12",
"id": "70000001114871525",
"name": "Видовое кафе",
"type": "branch"
}
],
"total": 1
}
}