Yandex Maps Reviews Scraper & API | Парсер Отзывов Яндекс Карт

Extract public Yandex Maps business reviews into clean JSON through Apify Console, API, datasets, schedules, or Apify MCP. It is designed for reputation monitoring, local-market research, customer-experience analysis, and AI agents that need review text, ratings, dates, business responses, and the aggregate company rating in one predictable row shape.

What it extracts

Field	Meaning
reviewId	Yandex review identifier, or a stable generated ID when the page does not expose one
reviewerName, reviewerLevel	Public reviewer display fields
rating	Individual score from 1 to 5; score-only ratings are preserved
reviewText	Public comment, nullable when a user left only a score
publishedAt	ISO timestamp when exposed by Yandex
ownerResponse	Public business response when present
reviewUrl, photoUrls	Public links exposed on the review card
companyName, companyRating, companyRatingCount	Aggregate business metadata repeated on each row for easy joins
warnings	Non-fatal extraction or access diagnostics

Yandex says a user may submit a score without a comment, so reviewText is intentionally nullable. The actor does not invent missing text or ratings.

When to use it

Use this actor when you have one or more public Yandex Maps organization URLs, such as https://yandex.com/maps/org/yandex/117684461999/reviews/. Organization URLs without /reviews/ are normalized automatically. The actor supports the public Yandex Maps domains yandex.com, yandex.ru, yandex.kz, yandex.by, yandex.uz, yandex.co.il, and yandex.com.tr.

This is a review actor, not a business-directory search actor. It does not discover organizations from keywords, log in to Yandex accounts, post reviews, or access private owner dashboards. For directory discovery, first supply organization URLs from an authorized source.

Input

{
  "startUrls": [
    { "url": "https://yandex.com/maps/org/yandex/117684461999/reviews/" }
  ],
  "maxReviews": 25,
  "maxScrolls": 8,
  "requestDelayMs": 800,
  "includeCompanyInfo": true
}

maxReviews is the maximum number of unique review rows, not a page count. maxScrolls bounds lazy-loaded review batches. Increase it for businesses with long review histories, but keep it bounded for predictable runtime and target traffic. includeCompanyInfo keeps company metadata in every row by default. If Yandex blocks a cloud IP, provide a residential Apify proxy configuration through proxyConfiguration; the actor uses a low-concurrency browser session and retries 403, 429, and upstream failures.

Output

{
  "recordType": "review",
  "reviewId": "generated-7c5f2b91",
  "reviewerName": "Валентин Дерах",
  "reviewerLevel": "Level 13 Local Expert",
  "rating": 5,
  "reviewText": "Побывал этом офисе на мероприятии...",
  "publishedAt": "2025-10-01T00:00:00.000Z",
  "ownerResponse": null,
  "companyName": "Yandex",
  "companyRating": 4,
  "companyRatingCount": 66,
  "companyUrl": "https://yandex.com/maps/org/yandex/117684461999/reviews/",
  "sourceUrl": "https://yandex.com/maps/org/yandex/117684461999/reviews/",
  "warnings": []
}

The OUTPUT key-value record contains the terminal status, row count, failed-request count, warnings, runtime, and simulated or actual result-event billing counters. An empty but valid page is reported as EMPTY; a page that could not be loaded after retries is reported as FAILED rather than a misleading empty dataset.

Pricing

Event	Price
Actor start	$0.00005
Unique review row	$0.005

The run prints its maximum result-event cost before browsing. The actor charges only after a schema-valid row has been stored and stops at maxReviews or Apify’s event-charge limit. A 25-review run costs at most about $0.125 in result events, plus the actor-start event and any platform/proxy usage shown by Apify.

API and MCP

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: process.env.APIFY_TOKEN });
const run = await client.actor('YOUR_USERNAME/yandex-maps-reviews-scraper').call({
  startUrls: [{ url: 'https://yandex.com/maps/org/yandex/117684461999/reviews/' }],
  maxReviews: 50
});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

For Apify MCP, expose the actor through https://mcp.apify.com/?tools=YOUR_USERNAME/yandex-maps-reviews-scraper. The input descriptions route agents toward organization URLs, and the dataset schema documents nullable score-only review text and response fields.

Reliability, limits, and legal use

Yandex Maps is a JavaScript application and may change DOM classes, lazy-loading behavior, language labels, or access policies. The actor uses semantic attributes and several class fallbacks, preserves partial results, and records diagnostics. It does not promise access to all historical reviews: Yandex’s own business help says only the last 600 published reviews may be visible in the business account and Maps. Local runs are useful for parser tests; cloud runs with a suitable proxy are the meaningful access test.

Use only public pages and data for a lawful purpose. Respect Yandex Maps terms, robots/access controls, privacy rules, copyright, database rights, and any contractual restrictions that apply to your use case. Do not use this actor to collect private account data, bypass authentication, harass reviewers, or republish personal data without a lawful basis.

Related actors

Use a dedicated Yandex Maps organization/business scraper if you need directory discovery or contact fields. Use this actor when the primary output is review-level data.