Every API, one clean contract.

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.

{
  "text": "kahve",
  "region_id": "103705",
  "city": "istanbul"
}

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.

{
  "org_id": "1242233919"
}

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.

{
  "org_id": "1242233919"
}

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

{
  "ll": "28.985,41.036",
  "text": "eczane"
}

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).

{
  "address": "Taksim Meydanı"
}