Search for places. /3.0/items

Additional fields to be displayed in the response should be separated by commas. The list of field containing information on geometry and address of the place: <ul> <li>`items.point` — object coordinates, specified in the WGS84 in the lon, lat format;</li> <li>`items.address` — address where the object is located;</li> <li>`items.adm_div` — belonging to an administrative territory;</li> <li>`items.full_address_name` — objects address with indication of a city;</li> <li>`items.geometry.centroid` — visual center of object geometry;</li> <li>`items.geometry.hover` — geometry of the area used to determine whether the cursor is in the object zone;</li> <li>`items.geometry.selection` — geometry for object selection;</li> </ul> The list of fields with additional information on the place: <ul> <li>`items.rubrics` — categories of the company;</li> <li>`items.org` — a company to which the branch belongs;</li> <li>`items.contact_groups` — the company's contact details;</li> <li>`items.schedule` — opening hours of the company;</li> <li>`items.access_comment` — localized name for the type of access;</li> <li>`items.access_name` — localized name of the type of access;</li> <li>`items.access` — access type for a parking lot;</li> <li>`items.attraction` — attraction description;</li> <li>`items.capacity` — parking lot capacity;</li> <li>`items.description` — map object description;</li> <li>`items.external_content` — additional data of the company, such as promotional materials and photos;</li> <li>`items.flags` — a list of object attributes;</li> <li>`items.floors` — the number of floors;</li> <li>`items.is_paid` — whether the parking facility is chargeable or not;</li> <li>`items.level_count` — the number of parking facility levels;</li> <li>`items.links` — linked objects;</li> <li>`items.name_ex` — components of the object name;</li> <li>`items.photos` — photos related to the company;</li> <li>`items.reviews` — reviews about the object;</li> <li>`items.statistics` — map object summary;</li> </ul> The list of command boxes: <ul> <li>`cb` — context banner;</li> <li>`context_rubrics` — an array of contextual categories;</li> <li>`dym` — the "Did you mean" section;</li> <li>`filters` — filters for additional search;</li> <li>`hash` — basic hash;</li> <li>`items.address.is_conditional` — "conditional address" flag;</li> <li>`items.ads.options` — advertising options;</li> <li>`items.attribute_groups` — additional attributes of the company;</li> <li>`items.context` — dynamic information;</li> <li>`items.dates.deleted_at` — the date when the company data was last deleted in the ISO 8601 format;</li> <li>`items.dates.updated_at` — the date when the company data was last updated in the ISO 8601 format;</li> <li>`items.dates` — the time when the information on the company was added to the database;</li> <li>`items.geometry.style` — style ID for display;</li> <li>`items.group` — objects gathered in one linked card;</li> <li>`items.delivery` — delivery is available</li> <li>`items.covid_safety` — a sign covid safety;</li> <li>`items.has_goods` — the list of the company's products was uploaded</li> <li>`items.has_payments` — online payment for the company's services is available</li> <li>`items.has_pinned_goods` — the company has turned on the "Pinned goods" section</li> <li>`items.has_realty` — there is property on sale</li> <li>`items.has_discount` — there are discounts</li> <li>`items.is_main_in_group` — an attribute meaning that it is the main object in the group of the hybrid objects.</li> <li>`items.is_promoted` — the company participates in a special offer from the Check</li> <li>`items.routes` — transport routes passing through the station or public transport stop;</li> <li>`items.is_routing_available` — a flag showing whether it is possible to create a route to the object or not;</li> <li>`items.locale` — current locale for the region;</li> <li>`items.reg_bc_url` — URL for registration of the business connection of the profile view;</li> <li>`items.region_id` — unique identifier of the project;</li> <li>`items.stat` — data for generating statistics messages;</li> <li>`items.stop_factors` — a set of blocking attributes that match the query;</li> <li>`request_type` — search query type;</li> <li>`search_attributes` — information about the performed search;</li> <li>`widgets` — widgets;</li> <li>`broadcast` — information for sending broadcast messages to the company.</li> </ul>

fields

Filter by availability of the individual taxpayer identification number. It takes the true or false values.

has_itin

Filter by availability of photos. Takes the true or false values.

has_photos

Filter by availability of rating on flamp.ru. Takes the true or false values.

has_rating

Filter by availability of reviews on flamp.ru. Takes the true or false values.

has_reviews

Filter by availability of website. Takes the true or false values.

has_site

Filter by availability of the trading license. Takes the true or false values.

has_trade_license

Filters companies which have the opening date later than the passed parameter. Accepts values in the YYYY-MM-DD format.

opened_after_date

Filter by the ID of the organization that the company belongs to.

org_id

The ID of the category. You need to pass the option `region_id`. you can also pass a list of IDs of categories separated by commas, in this case, all the headings should be from the same region.

rubric_id

Opening hours of the company. Format: [day],[time] or now (current day and time). Examples: <ul> <li>Monday, 17:00 — `mon,17:00`</li> <li>Thursday, 9:00 — `thu,09:00`</li> <li>Today, 9:00 — `today,09:00`</li> <li>Friday, all day — `fri,alltime`</li> <li>Now `now`</li> </ul>

work_time

The IDs of the buildings, separated by commas. They are used to filter objects in a building. The maximum number is 50.

building_id

The IDs of the cities separated by commas. They are used to filter objects by cities. The maximum number is 50.

city_id

The IDs of the districts, separated by commas. They are used to filter objects by district. The maximum number is 50.

district_id

Latitude of the point — center of the search area. Should be used together with the `lon` parameter. Allowed range of values: from -90 to 90 Can be used together with the `radius` parameter to filter the results in circumference.

Longitude of the point - center of the search area. Should be used together with the `lat` parameter. Allowed range of values: from -180 to 180 Can be used together with the `radius` parameter to filter the results in circumference.

A center of the search area (point coordinates in the `lon, lat` format). It is used to filter results in circumference.

point

The coordinates of the upper left vertex of a rectangular area limiting the search results in the `lon, lat` format. It is used to filter results in a rectangular area. Allowed difference of the `point1` and `point2` coordinates is not more than 0.06 for lon, and 0.04 (approximately 6.6 x 4.4 km) for lat. If the parameter `q` has been passed — the limitations are not imposed.

point1

The coordinates of the lower right vertex of a rectangular area limiting the search results in the `lon, lat` format. It is used to filter results in a rectangular area. Allowed difference of the `point1` and `point2` coordinates is not more than 0.06 for lon, and 0.04 (approximately 6.6 x 4.4 km) for lat. If the parameter `q` has been passed — the limitations are not imposed.

point2

Polygon in WKT format. It is used to filter the results in an arbitrary area.

polygon

Search radius in meters. Limit: from 0 to 40000 - if there is a search query (q), from 0 to 2000 — if there is no search query. default Value: 250 - combined with `point`, 0 - combined with `lon`/`lat`. Used for filtering results in a circle.

radius

Region identifier. It is required if a geographical limit of search has not been specified.


region_id

The coordinates of the upper left vertex of a rectangular visibility scope, in the `lon, lat` format. 

viewpoint1

The coordinates of the lower right vertex of a rectangular visibility scope, in the `lon, lat` format.

viewpoint2

Specifying the method for entering the query text to the search engine:
 - `default` - the input method is unknown or not specified
 -` hardware_qwerty_keyboard` - physical QWERTY keyboard
 - ʻother` - other input types


search_input_method

Specifying to the search engine that the request is complete (the user has pressed the completion button).

search_is_query_text_complete

Specifying the search engine to use search mode near the user.

search_nearby

Specifying the search engine to take results from scope only.

search_only_within_view

Type of search. Valid values: <ul> <li>`discovery` — the widest possible search with the possibility to open the linked objects (categories, corresponding to the request, will be opened before the branches that belong to them);</li> <li>`one_branch` — identical to discovery, but only one branch will be shown for a company;</li> <li>`indoor` — the configuration for high-quality search for branches in the building;</li> <li>`ads` — identical to discovery, but it will display only objects with advertising. In addition, only one branch, which if the first in the ranking, will be shown for a company;</li> <li>`discovery_partial_searcher` — identical to discovery, but it involves more options of intersection of links;</li> <li>`discovery_partial_searcher_strict` — identical to discovery_partial_searcher, but the prefix search will be disabled.</li> </ul>

search_type

Sorting of results. Valid values: <ul> <li>` distance ` by ascending order of the distance. Distance is calculated up to the center of the areal map objects (cities, districts, etc.) and by the shortest distance to the line (street). If the `sort_point` parameter has been passed, the distance is calculated up to this point;</li> <li>`relevance` — by descending order of the relevance. The search involves the company name and categories, to which the company belongs;</li> <li>`rating` — by descending order of the rating;</li> <li>`flamp_rating` — by descending rating on Flamp;</li> <li>`general_rating` — by descending rating (alias rating);</li> <li>`distance_without_ads` by ascending distances same as distance, but without considering advertising weight;</li> <li>`creation_time` — by descending order of the date of the establishment of the company branch;</li> <li>`opened_time` — by descending order of the opening date.</li> </ul>

sort

The coordinates of the point from which you are sorting (the coordinates of the point in the `lon, lat` format).

sort_point

The types of objects among which the search is performed. When passing several types, less relevant results of some types may be crowded out by more relevant other types. Types should be comma separated. The adm_div value is an alias for all `adm_div.* types` at one and the same time. The list of available types: <ul> <li>`branch` — company branch;</li> <li>`building` — building;</li> <li>`street` — street;</li> <li>`parking` — parking lot;</li> <li>`station` — stop;</li> <li>`station.metro` — metro station;</li> <li>`station_entrance` — the entrance to the station;</li> <li>`station_platform` — stopping platform;</li> <li>`attraction` — attraction;</li> <li>`crossroad` — crossing;</li> <li>`gate` — passage/thoroughfare;</li> <li>`road` — road;</li> <li>`route` — route;</li> <li>`adm_div` — administrative unit;</li> <li>`adm_div.country` — country;</li> <li>`adm_div.region` — region (region/province/republic, etc.);</li> <li>`adm_div.city` — city;</li> <li>`adm_div.district` — district;</li> <li>`adm_div.district_area` — district area;</li> <li>`adm_div.division` — area;</li> <li>`adm_div.living_area` — residential community, neighborhood;</li> <li>`adm_div.place` — place;</li> <li>`adm_div.settlement` — settlement;</li> <li>`coordinates` — global coordinate.</li> </ul>

type

The types of geo-objects among which the search is performed. When passing several types, less relevant results of some types may be crowded out by more relevant other types. Types should be comma separated.

The adm_div value is an alias for all `adm_div.* types` at one and the same time.

The list of available types:

* `adm_div` — administrative unit;
* `adm_div.city` — city;
* `adm_div.country` — country;
* `adm_div.region` — region (region/province/republic, etc.);
* `adm_div.district` — district;
* `adm_div.district_area` — district area;
* `adm_div.division` — area;
* `adm_div.living_area` — residential community, neighborhood;
* `adm_div.place` — place;
* `adm_div.settlement` — settlement;
* `attraction` — attraction;
* `building` — building;
`crossroad` — crossing;
* `gate` — passage/thoroughfare;
* `parking` — parking lot;
* `road` — road;
* `street` — street;
* `station_entrance`;
* `station_platform`;
* `coordinates` — global coordinate.


Filters objects which have been deleted later than the specified parameter. Accepts values in the YYYY-MM-DD format.

date

The IDs of categories, in which the deleted object could have been located, separated by commas.


rubrics

The identifier of the object. May also contain a unique hash in id_hash format. It is used to generate the statistics. You can also pass multiple IDs separated by commas, but not more than 100. IDs should not be duplicated. Advertising will be chosen, if there is only one identifier in the request.

An example of a single record hasham statistics

page

Number of search results displayed on one page.

page_size

Phone number, which is used for the search.

phone

site

The time when the advertising weights were generated in the TIMESTAMP format

Available, if you can use color coding, for example for metro stations.

Route type. 

Possible values:

 * `bus`;
 * `trolleybus`;
 * `tram`;
 * `shuttle_bus`;
 * `metro`;
 * `suburban_train`;
 * `funicular_railway`;
 * `monorail`;
 * `river_transport`;
 * `cable_car`;
 * `light_rail`;
 * `premetro`;
 * `light_metro`;
 * `aeroexpress.

Station type. 

Possible values:

 * `stop` — ground transportation stop;
 * `railway` — railway station;
 * `metro`;
 * `river_transport`;
 * `trolleybus`;
 * `tram`;
 * `funicular_railway`;
 * `monorail`;
 * `cable_car`;
 * `light_rail`;
 * `premetro`;
 * `light_metro`.

Map object of the administrative unit type.

Belonging to the administrative territory of a higher level.

Territory name (to use it for the "share" functionality, for final points of the route, etc.).

The time when the information on the branch was added to the database.

If true, it is possible to travel toward the object, if false or unavailable, then it is not.

Linked objects.

Possible values:

 * `entrances` — entry points;
 * `database_entrances` — entry points;
 * `branches` — companies;
 * `servicing` — service providers;
 * `providers`;
 * `airports`;
 * `parking` — parking lots;
 * `nearest_parking`;
 * `nearest_stations`;
 * `railway_terminals` — railway stations;
 * `bus_terminals` — bus stations;
 * `hotels`;
 * `river_ports` — river ports;
 * `seaports` — sea ports;
 * `attractions` — attractions;
 * `landmarks` — reference points.

The coordinates of the search point specified in the WGS84 coordinate system in the lon, lat format.

A suggest corresponding to the request. The field is available only in autocomplete methods.

The ID of the object data source. If absent, the data source is 2GIS.

Summary information about the administrative unit.

Subtype of administrative unit.

Possible values:

 * `city`;
 * `settlement`;
 * `division`;
 * `district`;
 * `living_area` — neighborhood, residential community;
 * `place`;
 * `district_area` — district area;
 * `region` - region (region/province/republic, etc.).

Localized name of the type of settlement (only for subtype = settlement).

Type of object. 

Possible values:

 * `adm_div` — administrative unit.

adm_div

Belonging to the administrative territory.

Attraction name (to use it for the "share" functionality, for final points of the route, etc.).

External content. Additional data such as data about pictures.

Parameters of the search result. It is only returned in search methods of the version 3.0.

Localized name of the type of attraction.

Type of object. 

Possible values:

 * `attraction`.

attraction

Address where a company branch is located.

Clarification on the branch location at the specified address.

Presentation of the address field as a single string.

Number of employees in the company. This field is available only for commercial API. 

Available options:

 * no data
 * up to 15
 * 16-100
 * 101-250
 * 251-1000
 * more than 1000

Representation of the address as a single line with the city.

Indicates whether there is information about apartments in the building

Individual taxpayer identification number. This field is available only for commercial API.

Full proper name of the branch or a company name.

Description of the purpose of the building.

A set of blocking attributes that match the query.

The data on the number of apartments and the material the building is made of. This field is available only for commercial API.

Timezone offset in minutes with respect to UTC0.

The license of the branch. This field is available only for commercial API.

Type of object. 

Possible values:

 * `branch` — company branch.

branch

Number of companies in the building for which you can write reviews on flamp.ru

Building name (to use it for the "share" functionality, for final points of the route, etc.).

Information about floors of the building.

Type of object. 

Possible values:

 * `building`.

building

Type of object. 

Possible values:

 * `coordinates` — global coordinate.

coordinates

Crossing name (to use it for the "share" functionality, for final points of the route, etc.).

Type of object. 

Possible values:

 * `crossroad` — crossing.

crossroad

Map object of the passage/thoroughfare type.

Accessibility. 

Possible values:

 * `public`;
 * `paid`;
 * `restricted` — for official use only.

Comment about availability. For example, there may be specified a cost for the paid passage.

Type of enclosure. 

Possible values:

 * `gate`;
 * `gate_barrier` — lifting gate;
 * `turnstile` — turnstile;
 * `wicket` — small gate.

Full name of the passage or thoroughfare.

Description of the passage or thoroughfare.

Type of passage or thoroughfare. 

Possible values:

 * `main`;
 * `additional`;
 * `service`.

Type of object. 

Possible values:

 * `gate` — passage/thoroughfare.

gate

Short caption for the icon to be displayed in the UI.

A search string that is put in a search string and that is passed to the query to generate the search results.

The ID of a metacategory the branches of which it is necessary to find.

Type of access. 

Possible values:

 * `public`;
 * `handicapped_only` — only for persons with disabilities;
 * `customers_only` — only for clients;
 * residents_only — only for residents.

Comment about payment, additional restrictions, etc.

Address of the building where the parking lot is located.

Parking lot name (to use it for the "share" functionality, for final points of the route, etc.).

Comment. The field is meant for specifying any additional information about the parking lot.

Purpose of parking lot. 

Possible values:

 * `car` — for cars;
 * `bike` — for bicycles;
 * `motorbike` — for motorcycles/mopeds.

Type of parking lot. 

Possible values:

 * `ground` — surface;
 * `underground`;
 * `multilevel`.

The time zone of the object in POSIX format.

Type of object. 

Possible values:

 * `parking`.

parking

Type of object. 

Possible values:

 * `project`.

project

Road name (to use it for the "share" functionality, for final points of the route, etc.).

Object type.

\Possible values:

 * `road`.

road

Object name (to use it for the "share" functionality, for final points of the route, etc.).

Route color, if any. For example, for metro lines. Format: "#rrggbb

The name of the starting point of the route.

Object type.

Possible values:

 * `route`.

route

An attribute indicating that the query requires the closest objects.

A sign that the most relevant result was found by a partial match.

An attribute indicating that the query requires objects not sensitive to the distance. For example, delivery.

Stopping point name (to use it for the "share" functionality, for final points of the route, etc.).

Linked objects. 

Possible values:

 * `entrances` — the entrances to the station;
 * `database_entrances` — entry points;
 * `nearest_stations` — stops nearby, including the connections to other metro stations, apart from the station linked to the entrance.

Transport routes passing through the station or stop.

Object type.

Possible values:

 * `station`.

station

Presents the address field as a single string ready to be displayed to a user.

Name of the entrance to the stop (to use it for the "share" functionality, for final points of the route, etc.).

Public transport routes passing through the stopping point.

The unique identifier of the station to which the entrance is linked.

Information about the material the building is made of. This field is available only for commercial API.

Type of object. 

Possible values:

 * `station_entrance` — the entrance to the station.

station_entrance

Stopping platform name (to use it for the "share" functionality, for final points of the route, etc.).

Unique identifier of the stopping platform.

The unique identifier of the stop to which this stopping platform is linked.

Type of object. 

Possible values:

 * `station_platform` — stopping platform.

station_platform

Street name (to use it for the "share" functionality, for final points of the route, etc.).

Type of object. 

Possible values:

 * `street`.

street

GTA banners.

The unique identifier of the building to which this address is linked.

Building name (in the address for branches).

An array of address components. 

Possible values:

 * `street_number` — typical address;
 * `number` — only building number;
 * `location` — generic description.

A verbal description of the structure location.

location

Building number, including fractions and letters. It may be a proper name, if it is used like this.

number

Building number, including fractions and letters.

street_number

The ID of the administrative unit object.

Is filled in only for type=city and takes a single true value if the city is the main city of the current project (e.g. Novosibirsk).

The ID of the administrative unit object. 

Possible values:

 * `city`;
 * `settlement`;
 * `division`;
 * `district`;
 * `living_area` — neighborhood, residential community;
 * `place`;
 * `district_area`;
 * `region` – region/province/republic, etc.

A list of actions for external advertising resources.

Advertising materials for donors of APP ("Advertisement in Partners' Profiles").

Advertising materials for the owner of the owned category.

Unique identifier of the object of attraction.

A list of additional attributes in this group.

A sign that is there is an intersection between the context categories and the categories of additional attributes of this group.

A sign that is there is an intersection between the primary categories of the branch and the categories of additional attributes of this group.