toolzerhub API Docs

Get organisation details

Returns 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.

1 credit / requestBilled only on success
GET
/v1/2gis/place

Authorization

ApiKeyAuth
x-api-key<token>

In: header

Query Parameters

id*string

A 2GIS branch id — exactly the id every /v1/2gis/search row publishes, which is how these endpoints compose. A full place URL or the decorated search_context_id are both accepted and reduce to the same value.

Lengthlength <= 500
locale?string

One of the city's own locales, e.g. ru_RU or en_AE. Defaults to the city's default. Not a translation layer: a locale the region does not offer is rejected by 2GIS outright — Dubai serves en_AE and refuses en_US. /v1/2gis/cities lists each city's set.

Match^[a-z]{2}_[A-Z]{2}$
Lengthlength <= 10
curl -X GET "https://example.com/v1/2gis/place?id=70000001007179642" \  -H "x-api-key: YOUR_API_KEY"
{  "data": {    "id": "70000001007179642",    "search_context_id": "70000001007179642_ku4dspBmdBdB9A82AJ7H…",    "name": "Му-Му, кафе",    "type": "branch",    "url": "https://2gis.ru/moscow/firm/70000001007179642",    "address": {      "street_address": "Манежная площадь, 1 ст2",      "address_comment": "-2 этаж; Средний уровень",      "building_name": "Охотный ряд",      "postcode": "125009",      "country": "Россия",      "region": "Москва",      "city": "Москва",      "district": "Тверской",      "settlement": null    },    "latitude": 55.755301,    "longitude": 37.614586,    "region_id": "32",    "city_alias": "moscow",    "rubrics": [      {        "id": "161",        "name": "Кафе",        "alias": "kafe",        "kind": "primary"      }    ],    "primary_rubric": "Кафе",    "schedule": {      "property1": null,      "property2": null    },    "contacts": {      "phones": [        {          "value": "+74957818781",          "text": "+7 (495) 781‒87‒81",          "comment": "служба доставки",          "tracking_url": "http://link.2gis.ru/1.2/97BA0CE6/…"        }      ],      "websites": [        {          "value": "+74957818781",          "text": "+7 (495) 781‒87‒81",          "comment": "служба доставки",          "tracking_url": "http://link.2gis.ru/1.2/97BA0CE6/…"        }      ],      "emails": [        {          "value": "+74957818781",          "text": "+7 (495) 781‒87‒81",          "comment": "служба доставки",          "tracking_url": "http://link.2gis.ru/1.2/97BA0CE6/…"        }      ]    },    "attribute_groups": [      null    ],    "organization": {      "id": "4504136498368318",      "name": "Му-Му, кафе",      "branch_count": 18    },    "rating": 4.8,    "review_count": 1090,    "org_rating": 4.3,    "org_review_count": 7817,    "is_reviewable": true,    "is_advertisement": false,    "relevance": 1137.25,    "requested_id": "70000001007179642",    "usage_note": "This is the same organisation a /v1/2gis/search row describes, plus the fields search cannot carry: phones, websites, emails and the full attribute groups. Every contacts.*[].value is the real value — the dialable number, the actual website, the mailbox. 2GIS itself puts its click-tracking redirector in that position for websites; it is moved to tracking_url so value means one thing across all three kinds."  }}