{
  "openapi": "3.0.1",
  "info": {
    "title": "Yandex Maps Scraper | Парсер Яндекс Карт: Leads, Reviews & API",
    "description": "Unofficial Yandex Maps API. Scrape business data, phone numbers, emails, reviews, photos, and posts from Russia, Turkey, and CIS. Export 63+ fields to Excel, JSON, or CSV. No browser needed — fast, unlimited, and pay-per-result. Includes AI review summaries and full menu prices.",
    "version": "0.0",
    "x-build-id": "h4fULePAaOe9aB2JX"
  },
  "servers": [
    {
      "url": "https://api.apify.com/v2"
    }
  ],
  "paths": {
    "/acts/zen-studio~yandex-maps-scraper/run-sync-get-dataset-items": {
      "post": {
        "operationId": "run-sync-get-dataset-items-zen-studio-yandex-maps-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    },
    "/acts/zen-studio~yandex-maps-scraper/runs": {
      "post": {
        "operationId": "runs-sync-zen-studio-yandex-maps-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor and returns information about the initiated run in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/runsResponseSchema"
                }
              }
            }
          }
        }
      }
    },
    "/acts/zen-studio~yandex-maps-scraper/run-sync": {
      "post": {
        "operationId": "run-sync-zen-studio-yandex-maps-scraper",
        "x-openai-isConsequential": false,
        "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
        "tags": [
          "Run Actor"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/inputSchema"
              }
            }
          }
        },
        "parameters": [
          {
            "name": "token",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "Enter your Apify token here"
          }
        ],
        "responses": {
          "200": {
            "description": "OK"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "inputSchema": {
        "type": "object",
        "required": [
          "query"
        ],
        "properties": {
          "query": {
            "title": "Search queries / Запросы",
            "type": "array",
            "description": "Search queries to run. Each query runs as a separate search.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "location": {
            "title": "Location / Город",
            "type": "string",
            "description": "City or area to search in. Type <strong>any city name in any language</strong> — works with English, Russian, Turkish, local scripts, etc. (e.g. <code>München</code>, <code>Стамбул</code>, <code>東京</code>).",
            "default": "Moscow"
          },
          "category": {
            "title": "Quick category / Категория",
            "enum": [
              "",
              "Restaurants",
              "Cafes",
              "Fast food",
              "Coffee",
              "Bars",
              "Sushi",
              "Pizza",
              "Burgers",
              "Hookah bars",
              "Hotels",
              "Groceries",
              "Shopping malls",
              "Pharmacies",
              "Banks",
              "ATMs",
              "Gas stations",
              "Car wash",
              "Auto repair",
              "Beauty salons",
              "Fitness",
              "Sport",
              "Hospitals",
              "Dentists",
              "Veterinary",
              "Museums",
              "Cinemas",
              "Government services",
              "Kindergartens",
              "Schools",
              "Dry cleaning"
            ],
            "type": "string",
            "description": "Select a common category. This adds an optimized search query in Russian for best results. You can combine this with custom queries above.",
            "default": ""
          },
          "maxResults": {
            "title": "Max results / Лимит",
            "minimum": 0,
            "maximum": 10000,
            "type": "integer",
            "description": "Maximum number of places to scrape. Set to 0 for unlimited. Each place costs ~$0.004.",
            "default": 100
          },
          "language": {
            "title": "Language",
            "enum": [
              "ru",
              "en",
              "tr",
              "uk",
              "kk"
            ],
            "type": "string",
            "description": "<strong>Translates:</strong> addresses, categories, working hours, features, photo tags.<br/><strong>Not translated:</strong> business names (original), reviews (user-written), posts (user-written).<br/><strong>Note:</strong> Reviews are sorted by language — e.g. Turkish locale returns Turkish-language reviews first, English returns English reviews first.",
            "default": "ru"
          },
          "enrichBusinessData": {
            "title": "Enrich with email, AI summary & menu / Email, нейросаммари и меню",
            "type": "boolean",
            "description": "Fetches <strong>email</strong>, AI-generated review summary (neurosummary), full delivery menu with prices, related businesses, foot traffic, and booking availability. Adds $1.50 / 1,000 places on top of the base scraping cost.",
            "default": false
          },
          "maxPhotos": {
            "title": "Max photos per place / Фото",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum photos to fetch per place. Set to 0 to skip.",
            "default": 0
          },
          "maxPosts": {
            "title": "Max posts per place / Посты",
            "minimum": 0,
            "maximum": 1000,
            "type": "integer",
            "description": "Maximum posts/news items to fetch per place. Set to 0 to skip.",
            "default": 0
          },
          "startUrls": {
            "title": "Yandex Maps URLs",
            "type": "array",
            "description": "Paste Yandex Maps business page URLs. Supported formats:<br><code>https://yandex.com/maps/org/name/12345/</code><br><code>https://yandex.com/maps/-/CPqIUMo</code> (short share links)<br>Works with all Yandex domains (yandex.ru, yandex.com.tr, etc.) and with <code>/reviews/</code> suffix. For search queries, use the Search queries field above.",
            "default": [],
            "items": {
              "type": "object",
              "required": [
                "url"
              ],
              "properties": {
                "url": {
                  "type": "string",
                  "title": "URL of a web page",
                  "format": "uri"
                }
              }
            }
          },
          "businessIds": {
            "title": "Business IDs",
            "type": "array",
            "description": "Direct Yandex business/organization IDs (numeric). Found in URLs like <code>/org/name/<strong>17323657526</strong>/</code>.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "coordinates": {
            "title": "Coordinates",
            "type": "string",
            "description": "Exact center point as <code>longitude,latitude</code> (e.g. <code>37.622,55.753</code>). Overrides the Location field. <br><em>Tip: Right-click any point on Yandex/Google Maps to copy coordinates.</em>",
            "default": ""
          },
          "viewportSpan": {
            "title": "Viewport span",
            "type": "string",
            "description": "Search area size as <code>dLon,dLat</code>. <br>• <code>0.01,0.01</code> ≈ 1km (Neighborhood)<br>• <code>0.1,0.1</code> ≈ 10km (City center)<br>• <code>0.5,0.5</code> ≈ 50km (Full city)",
            "default": ""
          },
          "filterRating": {
            "title": "Minimum rating",
            "enum": [
              "",
              "gt4.9",
              "gt4.7",
              "gt4.5",
              "gt4.0",
              "gt3.5",
              "gt3.0"
            ],
            "type": "string",
            "description": "Filter by minimum rating threshold.",
            "default": ""
          },
          "filterOpenNow": {
            "title": "Open now",
            "type": "boolean",
            "description": "Only show places currently open.",
            "default": false
          },
          "filterOpen24h": {
            "title": "Open 24 hours",
            "type": "boolean",
            "description": "Only show places open 24/7.",
            "default": false
          },
          "filterDelivery": {
            "title": "Delivery",
            "type": "boolean",
            "description": "Only show places with food delivery.",
            "default": false
          },
          "filterTakeaway": {
            "title": "Takeaway",
            "type": "boolean",
            "description": "Only show places with takeaway option.",
            "default": false
          },
          "filterWifi": {
            "title": "Wi-Fi",
            "type": "boolean",
            "description": "Only show places with Wi-Fi.",
            "default": false
          },
          "filterCardPayment": {
            "title": "Card payment",
            "type": "boolean",
            "description": "Only show places accepting card payments.",
            "default": false
          },
          "filterParking": {
            "title": "Parking",
            "type": "boolean",
            "description": "Only show places with parking.",
            "default": false
          },
          "filterPetFriendly": {
            "title": "Pet-friendly",
            "type": "boolean",
            "description": "Only show pet-friendly places.",
            "default": false
          },
          "filterWheelchairAccess": {
            "title": "Wheelchair accessible",
            "type": "boolean",
            "description": "Only show wheelchair-accessible places.",
            "default": false
          },
          "filterGoodPlace": {
            "title": "Good place (Yandex badge)",
            "type": "boolean",
            "description": "Only show places with Yandex's \"Good Place\" badge.",
            "default": false
          },
          "filterMichelin": {
            "title": "Michelin",
            "type": "boolean",
            "description": "Only show Michelin-rated restaurants.",
            "default": false
          },
          "filterBusinessLunch": {
            "title": "Business lunch",
            "type": "boolean",
            "description": "Only show restaurants offering business lunch.",
            "default": false
          },
          "filterSummerTerrace": {
            "title": "Summer terrace",
            "type": "boolean",
            "description": "Only show places with a summer terrace.",
            "default": false
          },
          "filterCuisine": {
            "title": "Cuisine type",
            "type": "array",
            "description": "Filter by cuisine type (e.g. <code>italian</code>, <code>japanese</code>, <code>georgian</code>). ",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "filterPriceCategory": {
            "title": "Price category",
            "type": "array",
            "description": "Filter by price level (e.g. <code>low</code>, <code>average</code>, <code>above_average</code>, <code>high</code>).",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "filterPriceMin": {
            "title": "Min average bill",
            "type": "integer",
            "description": "Minimum average bill (in local currency)."
          },
          "filterPriceMax": {
            "title": "Max average bill",
            "type": "integer",
            "description": "Maximum average bill (in local currency)."
          },
          "filterCategoryId": {
            "title": "Category IDs",
            "type": "array",
            "description": "Filter by Yandex category IDs (e.g. <code>184106408</code> for hotels). Comma-separated values within a single entry match ANY.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "filterChainId": {
            "title": "Chain IDs",
            "type": "array",
            "description": "Filter by chain/franchise IDs.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "customFilters": {
            "title": "Custom filters",
            "type": "array",
            "description": "Raw <code>key:value</code> filter strings for advanced filtering. Use when built-in filter fields don't cover your needs.",
            "default": [],
            "items": {
              "type": "string"
            }
          },
          "sortBy": {
            "title": "Sort by",
            "enum": [
              "",
              "distance"
            ],
            "type": "string",
            "description": "Sort order for search results.",
            "default": ""
          },
          "sortOrigin": {
            "title": "Sort origin",
            "type": "string",
            "description": "Origin point for distance sorting as <code>longitude,latitude</code>. Only used when Sort by = Distance.",
            "default": ""
          }
        }
      },
      "runsResponseSchema": {
        "type": "object",
        "properties": {
          "data": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "actId": {
                "type": "string"
              },
              "userId": {
                "type": "string"
              },
              "startedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "finishedAt": {
                "type": "string",
                "format": "date-time",
                "example": "2025-01-08T00:00:00.000Z"
              },
              "status": {
                "type": "string",
                "example": "READY"
              },
              "meta": {
                "type": "object",
                "properties": {
                  "origin": {
                    "type": "string",
                    "example": "API"
                  },
                  "userAgent": {
                    "type": "string"
                  }
                }
              },
              "stats": {
                "type": "object",
                "properties": {
                  "inputBodyLen": {
                    "type": "integer",
                    "example": 2000
                  },
                  "rebootCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "restartCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "resurrectCount": {
                    "type": "integer",
                    "example": 0
                  },
                  "computeUnits": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "options": {
                "type": "object",
                "properties": {
                  "build": {
                    "type": "string",
                    "example": "latest"
                  },
                  "timeoutSecs": {
                    "type": "integer",
                    "example": 300
                  },
                  "memoryMbytes": {
                    "type": "integer",
                    "example": 1024
                  },
                  "diskMbytes": {
                    "type": "integer",
                    "example": 2048
                  }
                }
              },
              "buildId": {
                "type": "string"
              },
              "defaultKeyValueStoreId": {
                "type": "string"
              },
              "defaultDatasetId": {
                "type": "string"
              },
              "defaultRequestQueueId": {
                "type": "string"
              },
              "buildNumber": {
                "type": "string",
                "example": "1.0.0"
              },
              "containerUrl": {
                "type": "string"
              },
              "usage": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "integer",
                    "example": 1
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              },
              "usageTotalUsd": {
                "type": "number",
                "example": 0.00005
              },
              "usageUsd": {
                "type": "object",
                "properties": {
                  "ACTOR_COMPUTE_UNITS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATASET_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "KEY_VALUE_STORE_WRITES": {
                    "type": "number",
                    "example": 0.00005
                  },
                  "KEY_VALUE_STORE_LISTS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_READS": {
                    "type": "integer",
                    "example": 0
                  },
                  "REQUEST_QUEUE_WRITES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_INTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "DATA_TRANSFER_EXTERNAL_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                    "type": "integer",
                    "example": 0
                  },
                  "PROXY_SERPS": {
                    "type": "integer",
                    "example": 0
                  }
                }
              }
            }
          }
        }
      }
    }
  }
}