2GIS API: List organisation reviews

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

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

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

limit?integer

How many reviews per page, at most 50.

Range1 <= value <= 50

Default20

offset?|

Where to start. This surface walks by offset, not by cursor, and it walks to the end — a branch stating 1,039 reviews served all of them and answered an empty list past that, so nothing here expires or is session-bound. Walk up to total.

Range0 <= value <= 100000

Default0

sort?string

2GIS's own allowed set, quoted from the 400 body it returns for anything else. friends and trust are its social and trust-weighted orderings.

Default"date_created"

Value in

"date_created"
"date_edited"
"friends"
"trust"

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/reviews?id=70000001007179642" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "requested_id": "70000001007179642",    "results": [      {        "id": "271440829",        "rating": 5,        "text": "Отлично!)))",        "date_created": "2026-08-23T03:46:23.263816+07:00",        "date_edited": null,        "likes_count": 0,        "comments_count": 0,        "photo_count": 2,        "provider": "2gis",        "author": {          "id": "54832258",          "name": "Марианна Винокурова",          "public_id": "b5702370dd1141b080fb8693fe2991fc",          "reviews_count": 2        },        "official_answer": {          "text": "string",          "date_created": "string"        }      }    ],    "count": 20,    "total": 1039,    "branch_rating": 4.8,    "branch_review_count": 1091,    "providers": [      "flamp",      "2gis"    ],    "limit": 20,    "offset": 0,    "sort": "date_created",    "available_sorts": [      "date_created",      "date_edited",      "friends",      "trust"    ],    "usage_note": "total is how many reviews this endpoint will actually serve, and it is smaller than branch_review_count — 2GIS counts star-only ratings in the second and returns only written reviews here. Walk by offset up to total; past it the list is empty rather than an error."  }}

List organisation reviews

Authorization

Query Parameters