Catalog / 2GIS Companies

2GIS Companies API

2gis.ru

Read-only live access to public 2GIS company search and profiles. City names are resolved through 2GIS geocoding, and company data comes from the public structured catalog API. Profile descriptions are null when the structured source does not provide that field; no HTML is parsed.

  • Business
  • 2gis
  • companies
  • business search
  • Russia
2 endpointsDocs updated

Endpoint health

Loading verification…

Connect your agent

Connect through MCP so your agent can find this API, read its docs, and call its endpoints.

Setup guide

Add the server from your terminal.

Claude Code · terminal
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcp

In Claude Code, run /mcp, select agent-data, then Authenticate. Sign in to your agent-data account in the browser.

Then ask your agent to use the 2GIS Companies API for your task.

Call it over HTTP

Get an API key

Sign up free, generate an API key, and set it as AGENT_DATA_API_KEY in your environment. Your first 100 calls each month are free.

Resolve the Russian city through 2GIS, then search public company branches near its returned city point.

Russian city name, for example Москва.

Company name, category, or keyword.

Optional parameters 1

1-based result page.

View call pricing
cURL · Companies search
curl --request GET --get 'https://3kpkg0jfvk.execute-api.us-east-2.amazonaws.com/prod/4f576248-b2ed-40f2-b288-19e441c8276c/v1/companies/search' \
  --header "Authorization: Bearer $AGENT_DATA_API_KEY" \
  --data-urlencode 'city=Москва' \
  --data-urlencode 'query=кофейня'

Endpoints

Inputs and response fields for every endpoint in this API.

GETCompanies by company id/v1/companies/{company_id}

Fetch a public 2GIS profile by an identifier returned from search_companies.

Input

company_idRequiredPath · string

2GIS company identifier from search_companies.

Example: 70000001091668370

Response

idstring
namestring
email?string | null
phones?string[]
rating?number | null
addressstring
website?string | null
category?string | null
description?string | null
working_hours?object | null

Fields marked ? are optional.

Don’t see the endpoint you need?

Ask agent-data to add an endpoint or return more fields. Extensions are free and keep existing endpoints working.