Skip to main content
POST
/
api
/
yandexmaps
/
organizations
/
search
/yandexmaps/organizations/search
curl --request POST \
  --url https://api.anysite.io/api/yandexmaps/organizations/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "text": "<string>",
  "count": 2,
  "timeout": 300,
  "geo": "213/moscow",
  "latitude": 0,
  "longitude": 0,
  "zoom": 11,
  "open_now": false,
  "good_place": false,
  "has_photo": false,
  "sort": "default",
  "filters": {
    "breakfast": true,
    "wi_fi": true
  }
}
'
[
  {
    "id": "<string>",
    "@type": "@yandex_maps_organization",
    "title": "<string>",
    "alias": "<string>",
    "description": "<string>",
    "url": "<string>",
    "rating": 123,
    "rating_count": 123,
    "review_count": 123,
    "categories": [],
    "phones": [],
    "website": "<string>",
    "address": "<string>",
    "full_address": "<string>",
    "additional_address": "<string>",
    "postal_code": "<string>",
    "locality": "<string>",
    "country": "<string>",
    "latitude": 123,
    "longitude": 123,
    "image": "<string>",
    "photo_count": 123,
    "photos": [],
    "working_status": "<string>",
    "working_time_text": "<string>",
    "is_open_now": true,
    "working_hours": [],
    "features": [],
    "metro": [],
    "stops": [],
    "links": [],
    "awards": [],
    "chain": "<string>",
    "is_verified": true
  }
]

Authorizations

access-token
string
header
required

API token from the dashboard

Headers

access-token
string
required

Body

application/json
text
string
required

Search query or category

Minimum string length: 1
Examples:

"кофейня"

"ресторан"

count
integer
required

Max number of results to return

Required range: x >= 1
timeout
integer
default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500
geo
string
default:213/moscow

Geo permalink in '{geoId}/{citySlug}' form bounding the search area

Examples:

"213/moscow"

"2/saint-petersburg"

latitude
number | null

Latitude of the search center

Required range: -90 <= x <= 90
longitude
number | null

Longitude of the search center

Required range: -180 <= x <= 180
zoom
integer | null

Map zoom level controlling the search radius

Required range: 1 <= x <= 21
rating_threshold
enum<string> | null

Keep only organizations rated at or above this value

Available options:
gt3.0,
gt3.5,
gt4.0,
gt4.5,
gt4.7,
gt4.9
price_category
enum<string> | null

Keep only organizations in this price band

Available options:
price_cheap,
price_reasonable,
price_expensive,
price_very_expensive
open_now
boolean
default:false

Keep only organizations open at the moment

good_place
boolean
default:false

Keep only organizations marked as a good place

has_photo
boolean
default:false

Keep only organizations that have photos

sort
enum<string>
default:default

Result ordering — relevance (default) or by rating

Available options:
default,
rating
filters
Filters · object

Extra category-specific filters as a map of filter id to value, e.g. {"wi_fi": true, "type_cuisine": "italian_cuisine"}. Boolean true selects a toggle filter.

Example:
{ "breakfast": true, "wi_fi": true }

Response

Successful Response

id
string
required
@type
string
default:@yandex_maps_organization
title
string | null
alias
string | null
description
string | null
url
string | null
rating
number | null
rating_count
integer | null
review_count
integer | null
categories
YandexMapsCategory · object[]
phones
string[]
website
string | null
address
string | null
full_address
string | null
additional_address
string | null
postal_code
string | null
locality
string | null
country
string | null
latitude
number | null
longitude
number | null
image
string | null
photo_count
integer | null
photos
string[]
working_status
string | null
working_time_text
string | null
is_open_now
boolean | null
working_hours
YandexMapsWorkingHours · object[]
features
YandexMapsFeature · object[]
metro
YandexMapsNearbyPlace · object[]
stops
YandexMapsNearbyPlace · object[]
awards
string[]
chain
string | null
is_verified
boolean | null