Yandex Maps API & Scraper
The Yandex Maps API returns Russian and CIS local-business data as clean JSON.
5 actionsLive JSON1,000 free credits$0.67–$1.50 / 1,000 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.
Reference
How a Yandex Maps org is identified, and which text is localized
This engine reads the Turkish surface of Yandex Maps, so almost every human-readable label comes back in Turkish while the ids and slugs stay stable. Two things trip callers up: there are two separate review counters that mean different things, and a rating of 0.0 is not a rating. Everything below came from live calls on 2026-08-27.
| Field | Format | Measured example |
|---|---|---|
| org_id | Numeric string, 9-12 digits, no prefix, the number in /maps/org/<seoname>/<org_id>/ | "1242233919" (Kofemaniya, Moscow), "138235130252", "173477046228". It is always a string in the response; do not parse it as an integer. |
| rating | Float 0-5 with one decimal. 0.0 means nobody has voted, not zero stars | 4.7 for Kofemaniya. In a Berlin cafe search 22 of 25 orgs came back 0.0 with rating_count 0; in a New York search, 24 of 25. |
| rating_count vs review_count | Star votes against written reviews, and rating_count is the larger of the two | Kofemaniya: rating_count 7809, review_count 2264. A small Kilis coffee shop: rating_count 3, review_count 0. |
| categories[] | {id, name, seoname} where name is localized Turkish and seoname is a stable English slug | {"id":"184106390","name":"Kafe","seoname":"cafe"}. Other measured slugs: coffee_shop, coffee_store, tea_shop, restaurant, pharmacy, fast_food, advertising_agency. |
| status | String; measured values "open" and "permanent-closed" | A 25-org Moscow search returned 24 "open" and 1 "permanent-closed". |
| hours_text | A single free-text Turkish string, or null when the card has none | "günlük, 09:00-23:00" and "günlük, 24 saat açık". It is not a structured schedule, so parse it or display it as-is. |
| reviews[].rating | Integer 1-5, unlike the org-level rating which is a float | One 50-review page for Kofemaniya broke down as 37 fives, 5 threes, 4 twos and 4 ones. |
| reviews[].date | ISO 8601 UTC with milliseconds and a Z | "2026-05-16T10:43:03.043Z". review_id sits alongside it as a 30-33 character mixed-case token, not a number. |
| geocode result | {name, address, latitude, longitude, type, uri} where uri is Yandex's own object reference | "Taksim Meydanı" resolved to 41.037437, 28.985607 with type "toponym" and uri "ymapsbm1://geo?data=<base64>". |
ll is "lon,lat", longitude first, the reverse order of the latitude and longitude fields the response gives back, and it overrides everything else. city is a real anchor too now: one of nineteen named slugs across Turkey, Russia and the CIS, re-measured on istanbul, ankara and moscow, with anything outside the list refused as INVALID_PARAM rather than answered from somewhere else. region_id stays the raw escape hatch and nothing validates it — 103705 is Kilis, roughly 900 km from Istanbul, and Istanbul is 11508.
Live example
Real request and response JSON
Captured from the indexed primary action, search, on .
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",
"city": "istanbul"
}
}Captured response
{
"ok": true,
"meta": {
"api": "yandex-maps",
"endpoint": "search",
"mode": "live",
"latency_ms": 776.7,
"record_count": 24,
"bytes": 737127,
"cache_hit": false,
"charged_credits": 1,
"version": "1.0.0"
},
"data": {
"orgs": [
{
"org_id": "66785495102",
"name": "Kahve Dünyası",
"address": "İstanbul, Fatih, Ankara Cad., 42",
"latitude": 41.014382,
"longitude": 28.975417,
"url": "https://yandex.com.tr/maps/org/kahve_dunyasi/66785495102/",
"seoname": "kahve_dunyasi",
"status": "open",
"hours_text": "günlük, 07:00–23:00",
"categories": [
{
"id": "184106390",
"name": "Kafe",
"seoname": "cafe"
},
{
"id": "144176536401",
"name": "kahve dükkanı",
"seoname": "coffee_store"
},
{
"id": "35193114937",
"name": "kahve dükkanları",
"seoname": "coffee_shop"
}
],
"phones": [
"[redacted-contact]",
"[redacted-contact]",
"[redacted-contact]"
],
"website": "https://x.com/kahvedunyasi",
"social_links": [
{
"type": "facebook",
"href": "https://www.facebook.com/KahveDunyasi/",
"handle": "www.facebook.com/KahveDunyasi"
},
{
"type": "instagram",
"href": "https://www.instagram.com/kahvedunyasi/",
"handle": "@kahvedunyasi"
}
],
"rating": 4.1,
"rating_count": 52,
"review_count": 10
},
{
"org_id": "160783544013",
"name": "Viyana Kahvesi Sirkeci",
"address": "İstanbul, Fatih, Hobyar Mah., Hamidiye Cad., 16D",
"latitude": 41.015845,
"longitude": 28.973914,
"url": "https://yandex.com.tr/maps/org/viyana_kahvesi_sirkeci/160783544013/",
"seoname": "viyana_kahvesi_sirkeci",
"status": "open",
"hours_text": "günlük, 07:00–01:00",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
}
],
"phones": [
"[redacted-contact]"
],
"website": null,
"social_links": [],
"rating": 4.7,
"rating_count": 182,
"review_count": 42
},
{
"org_id": "1128206727",
"name": "Kurukahveci Mehmet Efendi",
"address": "Tahmis Sokağı 66 Eminönü İstanbul ",
"latitude": 41.01657,
"longitude": 28.970219,
"url": "https://yandex.com.tr/maps/org/kurukahveci_mehmet_efendi/1128206727/",
"seoname": "kurukahveci_mehmet_efendi",
"status": "open",
"hours_text": "Pzt-Cmt 08:00–18:00",
"categories": [
{
"id": "144176536401",
"name": "Kahve dükkanı",
"seoname": "coffee_store"
},
{
"id": "35193114937",
"name": "kahve dükkanları",
"seoname": "coffee_shop"
}
],
"phones": [
"[redacted-contact]",
"[redacted-contact]",
"[redacted-contact]"
],
"website": "https://x.com/_mehmetefendi_",
"social_links": [
{
"type": "instagram",
"href": "https://www.instagram.com/kurukahveci_mehmet_efendi/",
"handle": "@kurukahveci_mehmet_efendi"
},
{
"type": "youtube",
"href": "https://www.youtube.com/@kurukahvecimehmetefendi1871",
"handle": "www.youtube.com/@kurukahvecimehmetefendi1871"
},
{
"type": "facebook",
"href": "https://www.facebook.com/142793642454151",
"handle": "www.facebook.com/142793642454151"
}
],
"rating": 4.6,
"rating_count": 257,
"review_count": 83
},
{
"org_id": "1065047819",
"name": "Kahve Dünyası",
"address": "İstanbul, Fatih, Molla Fenari Mah., Nuru Osmaniye Cad., 47",
"latitude": 41.010106,
"longitude": 28.97198,
"url": "https://yandex.com.tr/maps/org/kahve_dunyasi/1065047819/",
"seoname": "kahve_dunyasi",
"status": "open",
"hours_text": "günlük, 07:00–20:30",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
},
{
"id": "144176536401",
"name": "kahve dükkanı",
"seoname": "coffee_store"
}
],
"phones": [
"[redacted-contact]",
"[redacted-contact]"
],
"website": "https://x.com/kahvedunyasi",
"social_links": [
{
"type": "facebook",
"href": "https://www.facebook.com/KahveDunyasiNuruosmaniye/",
"handle": "www.facebook.com/KahveDunyasiNuruosmaniye"
},
{
"type": "instagram",
"href": "https://www.instagram.com/kahvedunyasi/",
"handle": "@kahvedunyasi"
},
{
"type": "youtube",
"href": "https://www.youtube.com/@KahvedunyasiTR",
"handle": "www.youtube.com/@KahvedunyasiTR"
},
{
"type": "youtube",
"href": "https://www.youtube.com/@KahveDunyasiTR",
"handle": "www.youtube.com/@KahveDunyasiTR"
}
],
"rating": 4.2,
"rating_count": 93,
"review_count": 15
},
{
"org_id": "70789178744",
"name": "Mim Kahve",
"address": "İstanbul, Fatih, Demirtaş Mah., Devoğlu Yokuşu, 12A",
"latitude": 41.017416,
"longitude": 28.967198,
"url": "https://yandex.com.tr/maps/org/mim_kahve/70789178744/",
"seoname": "mim_kahve",
"status": "open",
"hours_text": "günlük, 09:00–23:00",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
}
],
"phones": [
"[redacted-contact]",
"[redacted-contact]"
],
"website": null,
"social_links": [
{
"type": "facebook",
"href": "https://www.facebook.com/mimkahve/",
"handle": "www.facebook.com/mimkahve"
},
{
"type": "instagram",
"href": "https://www.instagram.com/mimkahve",
"handle": "@mimkahve"
}
],
"rating": 4.4,
"rating_count": 76,
"review_count": 9
},
{
"org_id": "104598894699",
"name": "Viyana Kahvesi",
"address": "Şahkulu, Şahkapısı sk. No:16, 34421 Beyoğlu/İstanbul",
"latitude": 41.025995,
"longitude": 28.97393,
"url": "https://yandex.com.tr/maps/org/viyana_kahvesi/104598894699/",
"seoname": "viyana_kahvesi",
"status": "open",
"hours_text": "günlük, 07:00–02:00",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
}
],
"phones": [
"[redacted-contact]",
"[redacted-contact]",
"[redacted-contact]"
],
"website": null,
"social_links": [
{
"type": "facebook",
"href": "https://www.facebook.com/viyanakahvesi/",
"handle": "www.facebook.com/viyanakahvesi"
},
{
"type": "instagram",
"href": "https://www.instagram.com/viyanakahvesi/",
"handle": "@viyanakahvesi"
},
{
"type": "youtube",
"href": "https://www.youtube.com/channel/UC8F7cbUq1MeA8B8x1YaQA8w/featured",
"handle": "www.youtube.com/@featured"
},
{
"type": "twitter",
"href": "https://twitter.com/viyanakahvesii",
"handle": "@viyanakahvesii"
}
],
"rating": 4.5,
"rating_count": 459,
"review_count": 189
},
{
"org_id": "92274140994",
"name": "Espressolab",
"address": "İstanbul, Beyoğlu, Kemankeş Karamustafapaşa Mah., Rıhtım Cad., 5B",
"latitude": 41.02192,
"longitude": 28.975967,
"url": "https://yandex.com.tr/maps/org/espressolab/92274140994/",
"seoname": "espressolab",
"status": "open",
"hours_text": "Pzt-Cum 07:00–23:00; Cmt,Paz 07:00–00:30",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
},
{
"id": "184106390",
"name": "kafe",
"seoname": "cafe"
}
],
"phones": [
"[redacted-contact]",
"[redacted-contact]"
],
"website": "https://x.com/espressolabtr",
"social_links": [
{
"type": "facebook",
"href": "https://facebook.com/espressolabtr",
"handle": "facebook.com/espressolabtr"
},
{
"type": "instagram",
"href": "https://instagram.com/espressolabtr",
"handle": "@espressolabtr"
},
{
"type": "twitter",
"href": "https://twitter.com/espressolabtr",
"handle": "@espressolabtr"
},
{
"type": "youtube",
"href": "https://youtube.com/channel/UC0XGp1i_AZF0N93_d8mUEiA",
"handle": "youtube.com/@UC0XGp1i_AZF0N93_d8mUEiA"
}
],
"rating": 4.5,
"rating_count": 85,
"review_count": 22
},
{
"org_id": "233993958491",
"name": "Kahve Dünyası",
"address": "Evliya Çelebi Mh., Meşrutiyet Cd., No: 64, Pera, Beyoğlu, İstanbul",
"latitude": 41.028455,
"longitude": 28.972019,
"url": "https://yandex.com.tr/maps/org/kahve_dunyasi/233993958491/",
"seoname": "kahve_dunyasi",
"status": "open",
"hours_text": "günlük, 07:00–23:00",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
},
{
"id": "144176536401",
"name": "kahve dükkanı",
"seoname": "coffee_store"
},
{
"id": "184106390",
"name": "kafe",
"seoname": "cafe"
}
],
"phones": [
"[redacted-contact]",
"[redacted-contact]",
"[redacted-contact]"
],
"website": "https://x.com/kahvedunyasi",
"social_links": [
{
"type": "facebook",
"href": "https://facebook.com/kahvedunyasi",
"handle": "facebook.com/kahvedunyasi"
},
{
"type": "instagram",
"href": "https://instagram.com/kahvedunyasi",
"handle": "@kahvedunyasi"
},
{
"type": "youtube",
"href": "https://youtube.com/user/kahvedunyasicom",
"handle": "youtube.com/@kahvedunyasicom"
}
],
"rating": 4.1,
"rating_count": 40,
"review_count": 5
},
{
"org_id": "21294817660",
"name": "Coffeetopia",
"address": "İstanbul, Fatih, Hobyar Mah., Arpacılar Cad., 4",
"latitude": 41.01666,
"longitude": 28.973349,
"url": "https://yandex.com.tr/maps/org/coffeetopia/21294817660/",
"seoname": "coffeetopia",
"status": "open",
"hours_text": "Pzt-Cmt 07:00–22:00; Paz 08:00–22:00",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
},
{
"id": "184108035",
"name": "çay mağazaları",
"seoname": "tea_shop"
}
],
"phones": [
"[redacted-contact]"
],
"website": null,
"social_links": [
{
"type": "instagram",
"href": "https://www.instagram.com/coffeetopiatr",
"handle": "@coffeetopiatr"
}
],
"rating": 4.5,
"rating_count": 115,
"review_count": 34
},
{
"org_id": "24893829740",
"name": "Coffee No. 4",
"address": "İstanbul, Fatih, Alemdar Mah., Molla Fenari Sok., 4",
"latitude": 41.009105,
"longitude": 28.975218,
"url": "https://yandex.com.tr/maps/org/coffee_no_4/24893829740/",
"seoname": "coffee_no_4",
"status": "open",
"hours_text": "Pzt-Cmt 07:00–00:30; Paz 07:00–23:00",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
}
],
"phones": [
"[redacted-contact]"
],
"website": null,
"social_links": [
{
"type": "instagram",
"href": "https://www.instagram.com/coffeeno4/",
"handle": "@coffeeno4"
}
],
"rating": 5,
"rating_count": 118,
"review_count": 34
},
{
"org_id": "167536699807",
"name": "Dudu",
"address": "Binbirdirek Mah., Üçler Sok., 7A, Fatih, İstanbul",
"latitude": 41.005462,
"longitude": 28.973992,
"url": "https://yandex.com.tr/maps/org/dudu_bakery_coffee/167536699807/",
"seoname": "dudu_bakery_coffee",
"status": "open",
"hours_text": "günlük, 08:00–19:00",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
},
{
"id": "184106390",
"name": "kafe",
"seoname": "cafe"
}
],
"phones": [],
"website": null,
"social_links": [
{
"type": "instagram",
"href": "https://www.instagram.com/dudufirinistanbul/",
"handle": "@dudufirinistanbul"
},
{
"type": "facebook",
"href": "https://www.facebook.com/profile.php?id=61556441122637",
"handle": "www.facebook.com/profile.php"
},
{
"type": "instagram",
"href": "https://www.instagram.com/dudufirin",
"handle": "@dudufirin"
},
{
"type": "facebook",
"href": "https://www.facebook.com/Dudu-F%C4%B1r%C4%B1n-61556441122637/",
"handle": "www.facebook.com/Dudu-F%C4%B1r%C4%B1n-61556441122637"
}
],
"rating": 5,
"rating_count": 122,
"review_count": 54
},
{
"org_id": "40526041676",
"name": "Espressolab",
"address": "İstanbul, Fatih, Ankara Cad., 18",
"latitude": 41.013103,
"longitude": 28.975381,
"url": "https://yandex.com.tr/maps/org/espressolab/40526041676/",
"seoname": "espressolab",
"status": "open",
"hours_text": "günlük, 07:00–22:00",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
}
],
"phones": [
"[redacted-contact]"
],
"website": null,
"social_links": [
{
"type": "twitter",
"href": "https://twitter.com/espressolabtr",
"handle": "@espressolabtr"
},
{
"type": "youtube",
"href": "https://youtube.com/channel/UC0XGp1i_AZF0N93_d8mUEiA",
"handle": "youtube.com/@UC0XGp1i_AZF0N93_d8mUEiA"
},
{
"type": "instagram",
"href": "https://instagram.com/espressolabtr",
"handle": "@espressolabtr"
},
{
"type": "facebook",
"href": "https://facebook.com/espressolabtr",
"handle": "facebook.com/espressolabtr"
}
],
"rating": 4.6,
"rating_count": 108,
"review_count": 40
},
{
"org_id": "78629220584",
"name": "The Coffee Factory Gülhane",
"address": "İstanbul, Fatih, Hocapaşa Mah., Ebussuud Cad., 2",
"latitude": 41.011973,
"longitude": 28.978195,
"url": "https://yandex.com.tr/maps/org/the_coffee_factory_gulhane/78629220584/",
"seoname": "the_coffee_factory_gulhane",
"status": "open",
"hours_text": null,
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
}
],
"phones": [
"[redacted-contact]",
"[redacted-contact]"
],
"website": null,
"social_links": [
{
"type": "facebook",
"href": "https://www.facebook.com/761822970337504",
"handle": "www.facebook.com/761822970337504"
}
],
"rating": 4.6,
"rating_count": 23,
"review_count": 7
},
{
"org_id": "133524171993",
"name": "Caffe Dell Arte",
"address": "İstanbul, Fatih, Alemdar Cad.",
"latitude": 41.010234,
"longitude": 28.978867,
"url": "https://yandex.com.tr/maps/org/caffe_dell_arte/133524171993/",
"seoname": "caffe_dell_arte",
"status": "open",
"hours_text": "Pzt-Cum 07:30–23:30; Cmt 07:30–23:00; Paz 08:00–23:30",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
}
],
"phones": [
"[redacted-contact]"
],
"website": null,
"social_links": [
{
"type": "instagram",
"href": "https://www.instagram.com/caffe__dell_arte",
"handle": "@caffe__dell_arte"
},
{
"type": "instagram",
"href": "http://instagram.com/cafedellarte/",
"handle": "@cafedellarte"
}
],
"rating": 5,
"rating_count": 112,
"review_count": 11
},
{
"org_id": "146862325068",
"name": "Galata Kahvesi",
"address": "İstanbul, Beyoğlu, Şahkulu Mah., Yörük Çk. Sok., 1",
"latitude": 41.027318,
"longitude": 28.974691,
"url": "https://yandex.com.tr/maps/org/galata_coffee_kitchen/146862325068/",
"seoname": "galata_coffee_kitchen",
"status": "open",
"hours_text": "günlük, 08:00–01:00",
"categories": [
{
"id": "184106390",
"name": "Kafe",
"seoname": "cafe"
},
{
"id": "35193114937",
"name": "kahve dükkanları",
"seoname": "coffee_shop"
},
{
"id": "184106394",
"name": "restoran",
"seoname": "restaurant"
}
],
"phones": [
"[redacted-contact]",
"[redacted-contact]"
],
"website": null,
"social_links": [],
"rating": 4.9,
"rating_count": 104,
"review_count": 37
},
{
"org_id": "24468504366",
"name": "Hafız Mustafa ",
"address": "İstanbul, Fatih, Mimar Hayrettin Mah., Divani Ali Sok., 14",
"latitude": 41.008582,
"longitude": 28.968344,
"url": "https://yandex.com.tr/maps/org/hafiz_mustafa_/24468504366/",
"seoname": "hafiz_mustafa_",
"status": "open",
"hours_text": "günlük, 08:00–02:00",
"categories": [
{
"id": "184108017",
"name": "Pasta, şekerleme ve tatlı",
"seoname": "confectionary"
},
{
"id": "35193114937",
"name": "kahve dükkanları",
"seoname": "coffee_shop"
},
{
"id": "184106390",
"name": "kafe",
"seoname": "cafe"
}
],
"phones": [
"[redacted-contact]",
"[redacted-contact]"
],
"website": "https://x.com/hafizmustafa_tr",
"social_links": [
{
"type": "instagram",
"href": "https://www.instagram.com/hafizmustafa1864/",
"handle": "@hafizmustafa1864"
},
{
"type": "facebook",
"href": "https://www.facebook.com/hafizmustafa1864",
"handle": "www.facebook.com/hafizmustafa1864"
},
{
"type": "youtube",
"href": "https://www.youtube.com/channel/UCxnhFNpxfLsZqrd1E31HZyg",
"handle": "www.youtube.com/@UCxnhFNpxfLsZqrd1E31HZyg"
},
{
"type": "instagram",
"href": "https://www.instagram.com/hafizmustafa1864/?hl=tr",
"handle": "@hafizmustafa1864"
}
],
"rating": 5,
"rating_count": 548,
"review_count": 195
},
{
"org_id": "36273575488",
"name": "Wuux Coffee",
"address": "İstanbul, Beyoğlu, Büyük Hendek Cad., 27A",
"latitude": 41.026429,
"longitude": 28.973142,
"url": "https://yandex.com.tr/maps/org/wuux_coffee/36273575488/",
"seoname": "wuux_coffee",
"status": "open",
"hours_text": "günlük, 08:00–01:00",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
},
{
"id": "144176536401",
"name": "kahve dükkanı",
"seoname": "coffee_store"
}
],
"phones": [
"[redacted-contact]"
],
"website": null,
"social_links": [
{
"type": "instagram",
"href": "https://www.instagram.com/wuuxcoffee/",
"handle": "@wuuxcoffee"
},
{
"type": "facebook",
"href": "https://www.facebook.com/wuuxcoffee/",
"handle": "www.facebook.com/wuuxcoffee"
}
],
"rating": 5,
"rating_count": 74,
"review_count": 28
},
{
"org_id": "38188805010",
"name": "Madam'ın Kahvesi",
"address": "İstanbul, Fatih, Hocapaşa Mah., İbn-i Kemal Cad., 23",
"latitude": 41.013381,
"longitude": 28.976642,
"url": "https://yandex.com.tr/maps/org/madam_in_kahvesi/38188805010/",
"seoname": "madam_in_kahvesi",
"status": "open",
"hours_text": "Pzt-Cum 09:00–20:00; Cmt,Paz 10:00–20:00",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
}
],
"phones": [],
"website": null,
"social_links": [
{
"type": "instagram",
"href": "https://www.instagram.com/madaminkahvesisirkeci/",
"handle": "@madaminkahvesisirkeci"
}
],
"rating": 4.7,
"rating_count": 22,
"review_count": 5
},
{
"org_id": "1379623733",
"name": "Costa Coffee",
"address": "İstanbul, Fatih, Ragıp Gümüşpala Cad., 27A",
"latitude": 41.018944,
"longitude": 28.965359,
"url": "https://yandex.com.tr/maps/org/la_kaffette_coffee/1379623733/",
"seoname": "la_kaffette_coffee",
"status": "open",
"hours_text": "günlük, 08:00–22:00",
"categories": [
{
"id": "184106390",
"name": "Kafe",
"seoname": "cafe"
},
{
"id": "35193114937",
"name": "kahve dükkanları",
"seoname": "coffee_shop"
}
],
"phones": [
"[redacted-contact]"
],
"website": null,
"social_links": [
{
"type": "instagram",
"href": "https://www.instagram.com/lakaffette",
"handle": "@lakaffette"
}
],
"rating": 5,
"rating_count": 46,
"review_count": 18
},
{
"org_id": "86364746480",
"name": "Starbucks",
"address": "Kemankeş Karamustafa Paşa Mah. Mumhane Cad. No: 50, Beyoğlu, İstanbul",
"latitude": 41.025762,
"longitude": 28.9805,
"url": "https://yandex.com.tr/maps/org/starbucks_reserve/86364746480/",
"seoname": "starbucks_reserve",
"status": "open",
"hours_text": "günlük, 11:00–22:00",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
}
],
"phones": [
"[redacted-contact]",
"[redacted-contact]"
],
"website": "https://x.com/starbucksTR",
"social_links": [
{
"type": "facebook",
"href": "https://www.facebook.com/StarbucksTurkiye",
"handle": "www.facebook.com/StarbucksTurkiye"
},
{
"type": "instagram",
"href": "https://www.instagram.com/starbucks_tr/",
"handle": "@starbucks_tr"
},
{
"type": "youtube",
"href": "https://www.youtube.com/c/StarbucksTr",
"handle": "www.youtube.com/@StarbucksTr"
},
{
"type": "whatsapp",
"href": "https://wa.me/902122430289",
"handle": "+902122430289"
},
{
"type": "youtube",
"href": "https://www.youtube.com/@StarbucksTr",
"handle": "www.youtube.com/@StarbucksTr"
},
{
"type": "tiktok",
"href": "https://www.tiktok.com/@starbucks_turkiye",
"handle": "@starbucks_turkiye"
}
],
"rating": 4.1,
"rating_count": 80,
"review_count": 21
},
{
"org_id": "86642949324",
"name": "Fiyeli Coffee Co Sirkeci",
"address": "İstanbul, Fatih, Hocapaşa Mah., Ebussuud Cad., 11",
"latitude": 41.012681,
"longitude": 28.976794,
"url": "https://yandex.com.tr/maps/org/fiyeli_coffee_co_sirkeci/86642949324/",
"seoname": "fiyeli_coffee_co_sirkeci",
"status": "open",
"hours_text": "günlük, 08:00–20:30",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
}
],
"phones": [
"[redacted-contact]",
"[redacted-contact]"
],
"website": null,
"social_links": [
{
"type": "facebook",
"href": "https://www.facebook.com/fiyelicoffeeco/",
"handle": "www.facebook.com/fiyelicoffeeco"
},
{
"type": "instagram",
"href": "https://www.instagram.com/fiyelicoffeeco/",
"handle": "@fiyelicoffeeco"
},
{
"type": "twitter",
"href": "https://www.twitter.com/fiyelicoffeeco/",
"handle": "@fiyelicoffeeco"
}
],
"rating": 4.7,
"rating_count": 54,
"review_count": 6
},
{
"org_id": "140598383633",
"name": "7 Hills Coffee",
"address": "İstanbul, Fatih, Cankurtaran Mah., Utangaç Sok., 22A",
"latitude": 41.006254,
"longitude": 28.979797,
"url": "https://yandex.com.tr/maps/org/7_hills_coffee/140598383633/",
"seoname": "7_hills_coffee",
"status": "open",
"hours_text": "günlük, 07:00–22:00",
"categories": [
{
"id": "184106394",
"name": "Restoran",
"seoname": "restaurant"
},
{
"id": "35193114937",
"name": "kahve dükkanları",
"seoname": "coffee_shop"
}
],
"phones": [
"[redacted-contact]"
],
"website": null,
"social_links": [],
"rating": 4.7,
"rating_count": 4,
"review_count": 0
},
{
"org_id": "110494763281",
"name": "Books & Coffee",
"address": "Arap Cami Mah., Teğmen Hüseyin Sofu Sok., No:13, Beyoğlu, İstanbul",
"latitude": 41.022911,
"longitude": 28.974301,
"url": "https://yandex.com.tr/maps/org/books_coffee/110494763281/",
"seoname": "books_coffee",
"status": "open",
"hours_text": "günlük, 07:30–22:30",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
}
],
"phones": [
"[redacted-contact]",
"[redacted-contact]"
],
"website": null,
"social_links": [
{
"type": "instagram",
"href": "http://www.instagram.com/booksandcoffeeturkiye",
"handle": "@booksandcoffeeturkiye"
},
{
"type": "facebook",
"href": "https://www.facebook.com/booksandcoffeeturkiye",
"handle": "www.facebook.com/booksandcoffeeturkiye"
}
],
"rating": 4.4,
"rating_count": 117,
"review_count": 35
},
{
"org_id": "1311522349",
"name": "Kahve Dünyasi",
"address": "İstanbul, Fatih, Rüstempaşa Mah., Büyükbaş Sok., 2",
"latitude": 41.017504,
"longitude": 28.969281,
"url": "https://yandex.com.tr/maps/org/kahve_dunyasi/1311522349/",
"seoname": "kahve_dunyasi",
"status": "open",
"hours_text": "günlük, 07:00–19:30",
"categories": [
{
"id": "35193114937",
"name": "Kahve dükkanları",
"seoname": "coffee_shop"
},
{
"id": "144176536401",
"name": "kahve dükkanı",
"seoname": "coffee_store"
}
],
"phones": [
"[redacted-contact]"
],
"website": null,
"social_links": [
{
"type": "facebook",
"href": "https://www.facebook.com/KahveDunyasi/",
"handle": "www.facebook.com/KahveDunyasi"
},
{
"type": "instagram",
"href": "https://www.instagram.com/kahvedunyasi/",
"handle": "@kahvedunyasi"
}
],
"rating": 3.9,
"rating_count": 41,
"review_count": 7
}
]
}
}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","city":"istanbul"}'import requests
r = requests.post(
"https://api.reefapi.com/yandex-maps/v1/search",
headers={"x-api-key": REEF_KEY},
json={
"text": "kahve",
"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",
"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","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
How does this differ from the google-maps engine?
Different id space and different strengths. There is no cross-walk between a Yandex org_id and a Google place id, so you cannot join the two without matching on name and coordinates. On coverage: Moscow and Istanbul searches returned phones on nearly every row and real ratings on most, while Berlin and New York, reached with ll because they are outside the nineteen named cities, also returned 25 genuine orgs each with street addresses and coordinates but a real rating on 0 of 25 and 2 of 25 respectively. Outside Russia and Turkey you get the place, not the reputation data.
Is a rating of 0.0 a bad business?
No, it is the empty state. Every org we saw with rating 0.0 also had rating_count 0, meaning nobody has voted. The engine returns 0.0 rather than null, so a naive average or a "rating below 2" filter will silently pick up unrated places. Gate on rating_count greater than 0 before you use rating at all.
Why do rating_count and review_count disagree?
They count different things. rating_count is how many people tapped a star rating; review_count is how many wrote text. Kofemaniya returned 7809 and 2264, roughly one written review for every three ratings. The reviews action pages against review_count, not rating_count, so use review_count when working out how many pages exist.
Does nearby really return the closest businesses first?
It returns nearby businesses, but not in distance order. A live nearby call for "eczane" around 28.985,41.036 returned six pharmacies at roughly 1.52, 0.37, 2.12, 2.06, 2.43 and 3.21 km from the center, in that order. Sort client-side from the latitude and longitude on each row. nearby also returns far fewer rows than search, six against search's usual 25, so it narrows the area and not just the ordering.
How many review pages can I pull?
50 reviews per page, and meta tells you the ceiling: for Kofemaniya, review_count 2264 with total_pages 46, plus has_more and next_page. Reviews are not sorted by date, the first three on page 1 being dated 2026-05-16, 2026-08-25 and 2026-07-16, so if you need the newest, pull the pages and sort yourself. business_reply is the owner's response text or null; on that page 49 of 50 reviews had one.
What does detail give me that search does not?
Seven extra fields plus an undocumented one: description, country, locality, street, house, photo_count, features and geo_id. A detail call on org_id 1242233919 returned country "Russian Federation", locality "Moscow", street "Kutuzovsky Avenue", house "17", photo_count 283 and geo_id 116997. One caveat worth knowing before you build on it: description was just the address restated ("Kutuzovsky Avenue No:17, Moscow"), not an about-the-business blurb.
What is inside features on a detail response?
An array of {name, value} pairs pulled from the amenities panel, where name is Turkish and value is either a string or a real boolean. The Kofemaniya card returned 20 of them, including {"name":"ortalama hesap","value":"1500-2500 ₽"} and {"name":"yemek teslimatı","value":true}. Because the names are free text in Turkish, match on them defensively rather than assuming a fixed key set.
Which fields are safe to key on if I do not read Turkish?
org_id, latitude, longitude, categories[].seoname and status all stay in a stable machine form. name, address, hours_text, author_level and every features[].name come back localized, for example author_level "9. seviye şehir uzmanı", which is Yandex's city-expert level with the level number at the front of the string.
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. 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.