2GIS Companies API
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.
Endpoint health
Loading verification…
Connect your agent
Connect through MCP so your agent can find this API, read its docs, and call its endpoints.
Add the server from your terminal.
claude mcp add --transport http agent-data https://agent-data.motie.dev/mcpIn 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 keySign 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.
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 search/v1/companies/search
Resolve the Russian city through 2GIS, then search public company branches near its returned city point.
Input
cityRequiredQuery · stringRussian city name, for example Москва.
Example: Москва
queryRequiredQuery · stringCompany name, category, or keyword.
Example: кофейня
pageOptionalQuery · integer, min: 1, default: 11-based result page.
Example: 1
Response
pageintegeritemsobject[]items[].idstringitems[].namestringitems[].rating?number | nullitems[].addressstringitems[].category?string | nullitems[].contacts?object[]items[].contacts[].typestringitems[].contacts[].valuestringtotalintegerFields marked ? are optional.
GETCompanies by company id/v1/companies/{company_id}
Fetch a public 2GIS profile by an identifier returned from search_companies.
Input
company_idRequiredPath · string2GIS company identifier from search_companies.
Example: 70000001091668370
Response
idstringnamestringemail?string | nullphones?string[]rating?number | nulladdressstringwebsite?string | nullcategory?string | nulldescription?string | nullworking_hours?object | nullFields 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.
An account is required to submit an extension. Prepare your request, then sign in to build.