Yandex API: List map place reviews

Returns one page of an organization's Yandex Maps reviews — rating, text, author, reactions and photos — with Yandex's own review and page totals. Requires place. Sort by newest, highest or lowest rated.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

place*string

A Yandex Maps organization URL or its numeric id, e.g. https://yandex.com/maps/org/pushkin/1018907821/. Every /v1/yandex/maps/search row publishes both, as id and as url, which is how the endpoints compose.

Lengthlength <= 500

page?integer

One-based page. The response's own total_pages says how many there are for the page_size you asked for.

Range1 <= value

Default1

page_size?integer

Reviews per page, up to 50. Asking for 100 returns a body with neither reviews nor totals in it.

Range1 <= value <= 50

Default50

sort?string

Review ordering. Yandex answers an ordering it does not recognise with a 200 carrying no reviews, which would read as an organization with none, so only measured values are offered.

Default"newest"

Value in

"newest"
"highest_rated"
"lowest_rated"

language?string

Default"en_US"

Value in

"en_US"
"ru_RU"
"tr_TR"
"uk_UA"

curl -X GET "https://example.com/v1/yandex/maps/reviews?place=1018907821" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "place_id": "string",    "sort": "string",    "language": "string",    "count": 0,    "total_reviews": 0,    "total_pages": 0,    "page": 0,    "page_size": 0,    "reviews_remaining": 0,    "reviews": [      {        "review_id": "string",        "business_id": "string",        "rating": 0,        "text": "string",        "text_language": "string",        "updated_at": "string",        "pinned": true,        "author_name": "string",        "author_public_id": "string",        "author_level": "string",        "author_avatar_url_template": "string",        "likes": 0,        "dislikes": 0,        "photos": {          "property1": null,          "property2": null        }      }    ],    "aspects": {      "property1": null,      "property2": null    },    "usage_note": "string"  }}