Yandex API: Search map places

Returns organizations and addresses from Yandex Maps — rating, phone numbers, websites, opening hours, categories, amenities and coordinates. Requires query; send latitude and longitude together to place the search. Up to 25 rows per page.

1 credit / requestBilled only on success

Authorization

ApiKeyAuth

x-api-key<token>

In: header

Query Parameters

query*string

A business name, a category, or an address. An address returns a row with type: "toponym" rather than an organization.

Length1 <= length <= 400

latitude?|

Centre latitude. Send latitude and longitude together or neither — one without the other is rejected here, because Yandex silently ignores it and answers from its own default region instead. With neither, the query coffee measured as returning a cafe in a small town in Krasnodar Krai.

Range-90 <= value <= 90

longitude?|

Centre longitude. Sent upstream in Yandex's longitude-first ll order by the worker; a caller never assembles that string.

Range-180 <= value <= 180

span?number

Half-width of the viewport in degrees, applied to both axes. 0.05 is roughly a city centre.

Range0 < value <= 90

bounds?string

What to do with results outside span. widen — the default, and Yandex's own behaviour — searches beyond it; restrict refuses them and requires span. Measured: Красная площадь with a New York span returns Moscow's Red Square under widen and nothing under restrict.

Default"widen"

Value in

"widen"
"restrict"

results?integer

Results per page, up to 25. Yandex answers anything above that with a 500.

Range1 <= value <= 25

Default25

page?|

Zero-based page. Sent upstream as skip = page * results, which is the only arithmetic Yandex accepts — any other offset is a 500. Deeper pages repeat rows, so de-duplicate on id.

Range0 <= value <= 100

Default0

language?string

Response language for titles, addresses and opening hours. An unlisted locale is a 500 upstream, not a fallback.

Default"en_US"

Value in

"en_US"
"ru_RU"
"tr_TR"
"uk_UA"

curl -X GET "https://example.com/v1/yandex/maps/search?query=coffee" \  -H "x-api-key: YOUR_API_KEY"

{  "data": {    "query": "string",    "page": 0,    "results_per_page": 0,    "language": "string",    "count": 0,    "total_result_count_estimate": 0,    "corrected_query": "string",    "request_id": "string",    "display_type": "string",    "results": [      {        "id": "string",        "type": "string",        "title": "string",        "short_title": "string",        "description": "string",        "address": "string",        "full_address": "string",        "composite_address": {          "property1": null,          "property2": null        },        "postal_code": "string",        "country": "string",        "latitude": 0,        "longitude": 0,        "uri": "string",        "url": "string",        "seoname": "string",        "kind": "string",        "geo_id": 0,        "categories": {          "property1": null,          "property2": null        },        "phones": {          "property1": null,          "property2": null        },        "websites": {          "property1": null,          "property2": null        },        "social_links": {          "property1": null,          "property2": null        },        "business_links": {          "property1": null,          "property2": null        },        "rating": {          "value": 0,          "ratings": 0,          "reviews": 0        },        "working_time_text": "string",        "working_status": {          "property1": null,          "property2": null        },        "status": "string",        "features": {          "property1": null,          "property2": null        },        "chain": {          "property1": null,          "property2": null        },        "metro": {          "property1": null,          "property2": null        },        "photo_count": 0,        "is_advert": true      }    ],    "usage_note": "string"  }}