docs / yandex-maps

Yandex Maps API

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
}