2GIS API
Search businesses across supported 2GIS cities, then retrieve organisation details and reviews.
4 endpoints
Endpoints
Each endpoint links to its request parameters, response schema, and code examples.
- Get organisation detailsReturns one organisation branch with the fields search cannot carry: phone numbers, websites, email addresses and 2GIS's full structured attributes, alongside address, coordinates, hours and ratings. Requires id — the exact value every /v1/2gis/search row publishes.
/v1/2gis/place1 crGET - List covered citiesReturns every city 2GIS covers with the slug /v1/2gis/search takes, its internal region id, country code and the locales it accepts. Takes no parameters.
/v1/2gis/cities1 crGET - List organisation reviewsReturns one page of written reviews for a branch — text, rating, author, photo count, the business's reply and which source each review came from. Requires id.
/v1/2gis/reviews1 crGET - Search businessesReturns organisations matching a query in one 2GIS city — name, address, coordinates, categories, opening hours and ratings. Requires query and city.
/v1/2gis/search1 crGET
What you can build
- Find local businesses and places.
- Add place details and reviews to a location directory.
Make your first request
Replace the placeholders with your input values. The endpoint reference explains each input and the returned fields.
curl -X GET "https://api.toolzerhub.com/v1/2gis/search?query=<query>&city=<city>" -H "x-api-key: $TOOLZERHUB_API_KEY"Need a key? Create an account, then review credits and responses and errors.