yandex_maps_data_view

🗺️ Yandex Maps Data API Documentation

Welcome to the Yandex Maps Data API! This document provides detailed information on how to interact with our endpoint to retrieve valuable business and place data from Yandex Maps. All requests are authenticated using headers provided by RapidAPI.

🔑 Authentication

Authentication is required for all API endpoints. You must include the following headers in every request:

Header	Type	Required	Description
x-rapidapi-key	string	✅ Yes	Your personal key from your RapidAPI subscription.
x-rapidapi-host	string	✅ Yes	The API host: `yandex-maps-data.p.rapidapi.com`

📍 1. Search for Places

This endpoint allows you to search for businesses and places on Yandex Maps using keywords and location filters. It supports advanced filtering by domain, country, and sorting by review count.

Method & Path: POST /api/yandex/maps/search/v1/

▶️ Request Body

Parameter	Type	Required	Description
search_word	string	✅ Yes	A keyword to search for businesses or places (e.g., "cafe", "car repair").
address	string	❌ No	A specific location to narrow down the search (e.g., "Moscow", "Istanbul, Turkey"). If omitted, the search is global.
domain_name	string	❌ No	The domain name of a company to filter by (e.g., "ikea.com").
reviews_total_sort_mode	string	❌ No	Sort results by the total number of reviews. Can be `asc` or `desc`.
page_number	integer	❌ No	The page number for pagination. Defaults to 1.
page_size	integer	❌ No	The number of results per page. Defaults to 10. Max is 20.

✅ Success Response (200 OK)

{
  "result": {
    "search_word": "string",
    "domain_name": "string | null",
    "reviews_total_sort_mode": "string | null",
    "api_version": "string",
    "page_number": "integer",
    "page_size": "integer",
    "total": "integer",
    "count": "integer",
    "data": [
      {
        "unique_id": "integer",
        "name": "string",
        "address": "string",
        "country_name": "string",
        "category_names": ["string"],
        "logo_url": "string (url) | null",
        "image_urls": ["string (url)"],
        "phone_numbers": ["string"],
        "website_urls": ["string (url)"],
        "reviews_rating": "float",
        "reviews_total": "integer",
        "socials": [
          {
            "name": "string",
            "url": "string (url)"
          }
        ]
      }
    ]
  }
}