Reputation & Reviews

Yandex Maps API

The Yandex Maps API returns Russian and CIS local-business data as clean JSON.

5 actionsLive JSON1,000 free creditsMCP-ready

🤖 Using an AI assistant? Copy this link into ChatGPT / Claude / Cursor — it reads every endpoint and parameter instantly and tells you if this API fits your use case.

The primary search endpoint returns organizations with id, name, address, coordinates, URL, rating and review count, and you can pull a detail, reviews, nearby places and geocode an address. It is built for CIS local-data products and review monitoring that need Yandex Maps data without a scraper. One ReefAPI key, one shared credit pool, the standard envelope.

Live example

Real request and response JSON

Captured from the indexed primary action, search, on Jul 18, 2026, 5:19 PM UTC.

Captured request

{
  "method": "POST",
  "url": "https://api.reefapi.com/yandex-maps/v1/search",
  "headers": {
    "x-api-key": "$REEF_KEY",
    "content-type": "application/json"
  },
  "body": {
    "text": "kahve",
    "region_id": "103705",
    "city": "istanbul"
  }
}

Captured response

{
  "ok": true,
  "meta": {
    "api": "yandex-maps",
    "endpoint": "search",
    "mode": "live",
    "latency_ms": 1556,
    "record_count": 25,
    "bytes": 471864,
    "cache_hit": false,
    "method": "ssr_state_view"
  },
  "data": {
    "orgs": [
      {
        "org_id": "[redacted-phone]",
        "name": "[redacted-name]",
        "address": "Canpolat Paşa Mah., Tekye Sok., Kilis Merkez, Kilis",
        "latitude": 36.71453,
        "longitude": 37.116151,
        "url": "https://yandex.com.tr/maps/org/ozkilinc_kahve_sekerleme/[redacted-phone]/",
        "seoname": "ozkilinc_kahve_sekerleme",
        "status": "open",
        "hours_text": "günlük, 09:00–23:00",
        "categories": [
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "seoname": "[trimmed-depth]"
          }
        ],
        "phones": [
          "[redacted-phone]"
        ],
        "website": null,
        "social_links": [
          {
            "type": "[trimmed-depth]",
            "href": "[trimmed-depth]",
            "handle": "[trimmed-depth]"
          }
        ],
        "rating": 4.2,
        "rating_count": 3,
        "review_count": 0
      },
      {
        "org_id": "[redacted-phone]",
        "name": "[redacted-name]",
        "address": "Kilis, Kilis Merkez, Ekrem Çetin Mah., Ahmet Taner Kışlalı Blv.",
        "latitude": 36.72605,
        "longitude": 37.101231,
        "url": "https://yandex.com.tr/maps/org/coffe_borsa/[redacted-phone]/",
        "seoname": "coffe_borsa",
        "status": "open",
        "hours_text": null,
        "categories": [
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "seoname": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "seoname": "[trimmed-depth]"
          }
        ],
        "phones": [
          "[redacted-phone]"
        ],
        "website": null,
        "social_links": [
          {
            "type": "[trimmed-depth]",
            "href": "[trimmed-depth]",
            "handle": "[trimmed-depth]"
          },
          {
            "type": "[trimmed-depth]",
            "href": "[trimmed-depth]",
            "handle": "[trimmed-depth]"
          }
        ],
        "rating": 4.5,
        "rating_count": 8,
        "review_count": 1
      },
      {
        "org_id": "[redacted-phone]",
        "name": "[redacted-name]",
        "address": "Kilis, Kilis Merkez, Ekrem Çetin Mah., Doğan Güreş Paşa Bul., 41A",
        "latitude": 36.729056,
        "longitude": 37.098761,
        "url": "https://yandex.com.tr/maps/org/dospresso_kilis/[redacted-phone]/",
        "seoname": "dospresso_kilis",
        "status": "open",
        "hours_text": "günlük, 09:00–00:00",
        "categories": [
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "seoname": "[trimmed-depth]"
          },
          {
            "id": "[trimmed-depth]",
            "name": "[trimmed-depth]",
            "seoname": "[trimmed-depth]"
          }
        ],
        "phones": [
          "[redacted-phone]"
        ],
        "website": null,
        "social_links": [],
        "rating": 4.2,
        "rating_count": 11,
        "review_count": 0
      }
    ]
  }
}

Actions

What the Yandex Maps API does

Action	Description	Concrete use case	Key params
search	Search Yandex Maps for businesses by text/category. Returns up to ~25 orgs with name, address, coordinates, rating, review count, categories, phone, website, social links and opening hours.	Support teams call search to search Yandex Maps for businesses by text/category.	text, city, region_id, ll, z
detail	Full business card for one org by org_id (or a Yandex Maps org URL): name, address, coordinates, rating, categories, phones, website, social links, opening hours, features and photo count.	Reputation platforms call detail to get full business card for one org by org_id (or a Yandex Maps org URL).	org_id, url
reviews	Paginated public customer reviews for an org: author handle, level, star rating, text, date and the business's reply. 50 reviews per page — page with `page`; meta.total_pages / meta.review_count tell you how many.	Market researchers call reviews to get paginated public customer reviews for an org.	org_id, page
nearby	Find businesses of a category around a coordinate. Returns geo-anchored orgs (same shape as search) closest to the given 'lon,lat' center.	B2B review analysts call nearby to find businesses of a category around a coordinate.	ll, text, z
geocode	Geocode an address/place name to coordinates via Yandex. Returns the matched toponym with latitude/longitude and a normalized address. Pass a complete address; Yandex resolves it directly (don't over-qualify a place already named).	Support teams call geocode to geocode an address/place name to coordinates via Yandex.	address

Code samples

Call search from your stack

curl -X POST https://api.reefapi.com/yandex-maps/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"text":"kahve","region_id":"103705","city":"istanbul"}'

import requests

r = requests.post(
    "https://api.reefapi.com/yandex-maps/v1/search",
    headers={"x-api-key": REEF_KEY},
    json={
  "text": "kahve",
  "region_id": "103705",
  "city": "istanbul"
},
)
print(r.json()["data"])

const res = await fetch("https://api.reefapi.com/yandex-maps/v1/search", {
  method: "POST",
  headers: {
    "x-api-key": process.env.REEF_KEY,
    "content-type": "application/json",
  },
  body: JSON.stringify({
  "text": "kahve",
  "region_id": "103705",
  "city": "istanbul"
}),
});
const { ok, data, meta, error } = await res.json();

MCP one-liner

Ask your MCP-connected assistant: call reefapi.yandex-maps.search with {"text":"kahve","region_id":"103705","city":"istanbul"}.

Use cases

Who uses this API and why

Local apps call search to list businesses across CIS regions.
Reputation tools use reviews to monitor ratings.
Lead-gen uses search and nearby to build local business lists.

FAQ

Questions developers ask before integrating

What is the Yandex Maps API?

Yandex Maps API is a ReefAPI endpoint group for yandex maps It returns live JSON through POST requests under /yandex-maps/v1.

Is the Yandex Maps API free to try?

Yes. ReefAPI starts with 1,000 free credits, no card required. Yandex Maps calls use the same shared credit balance as every other ReefAPI engine.

Do I need a Yandex Maps login or account?

No login to Yandex Maps is needed for the API response. You call ReefAPI with your x-api-key header, and the playground can run live examples before you create a production key.

How fresh is the Yandex Maps data?

The page example is captured from a live search call, and production requests fetch live data through ReefAPI rather than a static sample.

How many credits does the Yandex Maps API use?

Yandex Maps actions currently cost 1 credit per successful call. Failed or blocked calls are free, and all APIs draw from one credit pool.

Can I call Yandex Maps from an AI assistant or MCP client?

Yes. Connect ReefAPI once through MCP and your assistant can call yandex-maps actions with the same key, credit pool and JSON envelope used by normal REST requests.

Is the Yandex Maps API a Yandex Maps scraper?

It is the managed alternative to a DIY Yandex Maps scraper. Instead of building and maintaining your own scraper — proxies, headless browsers, captcha and constant breakage — you call one ReefAPI endpoint and get the same yandex maps back as clean JSON.

Why does my Yandex Maps scraper keep getting blocked?

Most Yandex Maps scrapers break on anti-bot defenses, rate limits and IP bans that need rotating residential proxies and browser fingerprinting to clear. ReefAPI handles all of that for you — no proxies, no captchas, no maintenance — and returns live JSON. Blocked or failed calls are free.

docs / yandex-maps

Yandex Maps

base /yandex-maps/v15 endpoints

post/yandex-maps/v1/search1 credit

Search Yandex Maps for businesses by text/category. Returns up to ~25 orgs with name, address, coordinates, rating, review count, categories, phone, website, social links and opening hours.

Parameter		Allowed / range	Description
text	required	—	What to look for — a business name, brand or category ('kahve', 'eczane', 'Starbucks', 'restaurant').
city	optional	—	City slug to scope the search (istanbul, moscow, ankara…). Defaults to Istanbul. Pair with region_id for precise routing.
region_id	optional	—	Advanced: Yandex internal region id (213=Moscow, 103705=Istanbul). Routes the search geographically; the city slug is cosmetic.
ll	optional	—	Map-center bias as 'lon,lat' (NOTE: lon first). Strongly recommended for local results.
z = 14	optional	1–21	Zoom level 1-21 (higher = tighter local area).

Try in playground →

post/yandex-maps/v1/detail1 credit

Full business card for one org by org_id (or a Yandex Maps org URL): name, address, coordinates, rating, categories, phones, website, social links, opening hours, features and photo count.

Parameter		Allowed / range	Description
org_id	optional	—	Yandex Maps org id (the number in /maps/org/<id>/). From a search result's org_id.
url	optional	—	Alternatively a full Yandex Maps org URL.

Try in playground →

post/yandex-maps/v1/reviews1 credit

Paginated public customer reviews for an org: author handle, level, star rating, text, date and the business's reply. 50 reviews per page — page with `page`; meta.total_pages / meta.review_count tell you how many.

Parameter		Allowed / range	Description
org_id	required	—	Yandex Maps org id to pull reviews for.
page = 1	optional	1–200	Review page (50 per page). Page until meta.total_pages.

Try in playground →

post/yandex-maps/v1/nearby1 credit

Find businesses of a category around a coordinate. Returns geo-anchored orgs (same shape as search) closest to the given 'lon,lat' center.

Parameter		Allowed / range	Description
ll	required	—	Center to search around as 'lon,lat' (lon first).
text	required	—	Category or keyword to find near the center ('eczane', 'atm', 'cafe', 'hastane').
z = 16	optional	10–21	Zoom (tighter = smaller radius).

Try in playground →

post/yandex-maps/v1/geocode1 credit

Geocode an address/place name to coordinates via Yandex. Returns the matched toponym with latitude/longitude and a normalized address. Pass a complete address; Yandex resolves it directly (don't over-qualify a place already named).

Parameter		Allowed / range	Description
address	required	—	Address or place name to geocode (e.g. 'Taksim Meydanı', 'Red Square Moscow').

Try in playground →

Example request · search

curl -X POST https://api.reefapi.com/yandex-maps/v1/search \
  -H "x-api-key: $REEF_KEY" \
  -H "content-type: application/json" \
  -d '{"text":"kahve","region_id":"103705","city":"istanbul"}'

Response shape

{
  "ok": true,
  "data": { /* the result */ },
  "meta": {
    "latency_ms": 240,
    "record_count": 12,
    "completeness_pct": 100
  },
  "error": null
}