PHPackages scraper-apis/yandex-scraper - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. scraper-apis/yandex-scraper ActiveLibrary[Utility & Helpers](/categories/utility) scraper-apis/yandex-scraper =========================== PHP client library for scraping Yandex data (places, reviews, market products) using Apify actors 01PHPCI passing Since Feb 20Pushed 4mo agoCompare [ Source](https://github.com/Scraper-APIs/yandex-scraper-php)[ Packagist](https://packagist.org/packages/scraper-apis/yandex-scraper)[ RSS](/packages/scraper-apis-yandex-scraper/feed)WikiDiscussions master Synced today READMEChangelogDependenciesVersions (1)Used By (0) Yandex Scraper PHP ================== [](#yandex-scraper-php) **English** | [Русский](https://github.com/Scraper-APIs/yandex-parser-php) A PHP client library for scraping data from [Yandex](https://yandex.ru) services -- extract places and businesses from Yandex Maps, reviews from Yandex Maps, products from Yandex Market (Russia's largest marketplace), and real estate listings from Yandex Realty. Returns typed DTOs for each data type. Powered by [Apify](https://apify.com/) actors under the hood. Installation ------------ [](#installation) ``` composer require scraper-apis/yandex-scraper ``` Quick Start ----------- [](#quick-start) ``` use YandexParser\Client; $client = new Client('your_apify_api_token'); // Search for restaurants in Moscow $places = $client->scrapePlaces( query: ['restaurant'], location: 'Moscow', maxResults: 50, ); foreach ($places as $place) { echo "{$place->title} — {$place->address}\n"; echo "Rating: {$place->rating} ({$place->reviewCount} reviews)\n"; if ($place->hasContactInfo()) { echo "Phone: {$place->getFirstPhone()}\n"; echo "Email: {$place->email}\n"; } if ($place->hasWebsite()) { echo "Website: {$place->website}\n"; } } ``` Available Methods ----------------- [](#available-methods) The client wraps 4 specialized Apify actors, each optimized for a specific Yandex service. ### 1. Places / Businesses (Yandex Maps) [](#1-places--businesses-yandex-maps) Search Yandex Maps by keyword and location. Returns rich records with 60+ fields including contacts, ratings, schedule, photos, videos, AI-generated summaries, and more. ``` use YandexParser\Language; $places = $client->scrapePlaces( query: ['dentist', 'dental clinic'], location: 'Saint Petersburg', maxResults: 200, language: Language::Russian, options: [ 'filterRating' => 4.5, 'filterOpenNow' => true, 'filterCardPayment' => true, 'enrichBusinessData' => true, 'maxPhotos' => 5, ], ); ``` **Available options for `scrapePlaces()`:** OptionTypeDescription`filterRating``float`Minimum rating threshold`filterOpenNow``bool`Only currently open places`filterOpen24h``bool`Only 24/7 places`filterDelivery``bool`Has delivery service`filterTakeaway``bool`Has takeaway option`filterWifi``bool`WiFi available`filterCardPayment``bool`Accepts card payments`filterParking``bool`Has parking`filterPetFriendly``bool`Pet-friendly establishment`filterWheelchairAccess``bool`Wheelchair accessible`filterGoodPlace``bool`Yandex "Good Place" badge`filterMichelin``bool`Michelin-rated`filterBusinessLunch``bool`Offers business lunch`filterSummerTerrace``bool`Has summer terrace`filterCuisine``string`Filter by cuisine type`filterPriceCategory``string`Price category filter`filterPriceMin``int`Minimum average check`filterPriceMax``int`Maximum average check`filterCategoryId``string`Filter by category ID`filterChainId``string`Filter by chain ID`customFilters``array`Custom filter parameters`sortBy``string`Sort results`sortOrigin``string`Sort origin point`enrichBusinessData``bool`Fetch detailed business data`maxPhotos``int`Max photos per place`maxPosts``int`Max posts per place`startUrls``string[]`Direct Yandex Maps URLs`businessIds``string[]`Direct business IDs`coordinates``string`Search center coordinates`viewportSpan``string`Map viewport span`category``string`Category filter**Place DTO helpers:** ``` $place->hasContactInfo(); // true if phones or email exist $place->getFirstPhone(); // first phone number or null $place->hasWebsite(); // true if website is set $place->getCoordinates(); // ['lat' => float, 'lng' => float] or null $place->isVerified(); // true if owner is verified $place->hasVideos(); // true if videos array is not empty $place->hasMenu(); // true if menu data is present ``` ### 2. Reviews (Yandex Maps) [](#2-reviews-yandex-maps) Extract reviews from Yandex Maps businesses. Accepts business URLs or numeric IDs. Returns flat one-row-per-review records with author info, business reply, and AI analysis. ``` use YandexParser\ReviewSort; use YandexParser\Language; $reviews = $client->scrapeReviews( startUrls: [ 'https://yandex.ru/maps/org/pushkin/1124715036/', ], maxReviewsPerPlace: 500, reviewSort: ReviewSort::Newest, minRating: 1, maxRating: 3, language: Language::Russian, ); foreach ($reviews as $review) { echo "{$review->authorName}: {$review->rating}/5\n"; echo "{$review->text}\n"; if ($review->hasBusinessReply()) { echo "Reply: {$review->getBusinessReplyText()}\n"; } if ($review->hasPhotos()) { echo "Photos: " . count($review->photos) . "\n"; } } ``` **Parameters for `scrapeReviews()`:** ParameterTypeDefaultDescription`startUrls``string[]``[]`Yandex Maps business URLs`businessIds``string[]``[]`Direct numeric business IDs`maxReviewsPerPlace``int``0`Max reviews per place (0 = all)`reviewSort``ReviewSort``Relevance`Sort order`minRating``int``0`Minimum star rating filter`maxRating``int``0`Maximum star rating filter`language``Language``English`Response languageAt least one of `startUrls` or `businessIds` must be provided; otherwise an `ApiException` is thrown. **Review DTO helpers:** ``` $review->hasBusinessReply(); // true if business replied $review->getBusinessReplyText(); // reply text or null $review->hasPhotos(); // true if review has photos $review->hasVideos(); // true if review has videos $review->isPositive(); // true if rating >= 4 $review->isNegative(); // true if rating hasTranslation(); // true if text translations exist ``` ### 3. Products (Yandex Market) [](#3-products-yandex-market) Scrape product listings from Yandex Market -- Russia's largest e-commerce marketplace. Returns detailed product data with pricing, seller info, specifications, stock status, and YaBank card discounts. ``` use YandexParser\MarketSort; use YandexParser\MarketRegion; $products = $client->scrapeProducts( query: 'ASUS laptop', maxItems: 50, region: MarketRegion::Moscow, sort: MarketSort::PriceAsc, options: [ 'priceFrom' => 30000, 'priceTo' => 80000, 'includeReviews' => true, ], ); foreach ($products as $product) { echo "{$product->title}\n"; echo "Price: {$product->getPriceFormatted()}\n"; echo "Seller: {$product->sellerName} (rating: {$product->sellerRating})\n"; $discount = $product->getYaBankDiscount(); if ($discount !== null) { echo "YaBank discount: {$discount}%\n"; } if ($product->isInStock()) { echo "In stock: {$product->stockCount} units\n"; } } ``` **Available options for `scrapeProducts()`:** OptionTypeDescription`priceFrom``int`Minimum price filter`priceTo``int`Maximum price filter`categoryId``string`Filter by category`enrichProducts``bool`Fetch detailed product data`includeReviews``bool`Include product reviews`proxyUrl``string`Custom proxy URL**Product DTO helpers:** ``` $product->hasReviews(); // true if reviews array is not empty $product->hasImages(); // true if images array is not empty $product->isInStock(); // true if product is available $product->getPriceFormatted(); // "54,990 RUB" or null $product->getYaBankDiscount(); // percentage discount (e.g. 10.0) or null $product->hasUgcImages(); // true if user-generated images exist $product->hasVideos(); // true if videos array is not empty ``` ### 4. Real Estate Listings (Yandex Realty) [](#4-real-estate-listings-yandex-realty) Scrape property listings from Yandex Realty -- Russia's major real estate platform. Returns detailed listing data with pricing, location, property specs, seller info, price predictions, and more. ``` use YandexParser\DealType; use YandexParser\PropertyCategory; use YandexParser\RealtySort; $listings = $client->scrapeListings( location: 'Moscow', dealType: DealType::Sell, category: PropertyCategory::Apartment, maxItems: 50, sort: RealtySort::PriceAsc, roomsTotal: ['1', '2'], options: [ 'priceMin' => 5000000, 'priceMax' => 15000000, ], ); foreach ($listings as $listing) { echo "{$listing->getAddress()} — {$listing->getPriceValue()} RUR\n"; echo "Area: {$listing->getAreaValue()} m², floor: {$listing->floorsOffered[0] ?? '?'}/{$listing->floorsTotal}\n"; if ($listing->hasPhones()) { echo "Phone: {$listing->getFirstPhone()}\n"; } if (!$listing->isFromOwner()) { echo "Agency: {$listing->getSellerName()}\n"; } $predicted = $listing->getPredictedPrice(); if ($predicted !== null) { echo "Predicted: {$predicted['min']}–{$predicted['max']} RUR\n"; } } ``` **Parameters for `scrapeListings()`:** ParameterTypeDefaultDescription`location``string``'Москва'`City or region name`dealType``DealType``Sell`Deal type (sell or rent)`category``PropertyCategory``Apartment`Property category`maxItems``int``100`Max listings to return`sort``RealtySort``Relevance`Sort order`roomsTotal``string[]``[]`Room filter: `STUDIO`, `1`, `2`, `3`, `PLUS_4`**Available options for `scrapeListings()`:** OptionTypeDescription`priceMin``int`Minimum price filter`priceMax``int`Maximum price filter`areaMin``int`Minimum area (m²)`areaMax``int`Maximum area (m²)`floorMin``int`Minimum floor`floorMax``int`Maximum floor`agents``bool`Include agent listings`regionId``string`Yandex region ID`includePhones``bool`Fetch phone numbers`includePriceHistory``bool`Fetch price change history**Listing DTO helpers:** ``` $listing->getPriceValue(); // price in rubles or null $listing->getPriceCurrency(); // currency code (e.g. "RUR") or null $listing->getPriceTrend(); // "INCREASED", "DECREASED", "UNCHANGED" or null $listing->getPreviousPrice(); // previous price value or null $listing->getAddress(); // full address string or null $listing->getCoordinates(); // ['lat' => float, 'lng' => float] or null $listing->getCity(); // city name or null $listing->getRegion(); // region/federation name or null $listing->getAreaValue(); // total area in m² or null $listing->hasPhones(); // true if phone numbers available $listing->getFirstPhone(); // first phone number or null $listing->getWhatsAppPhones(); // WhatsApp numbers from author $listing->hasImages(); // true if images exist $listing->hasPriceHistory(); // true if price history available $listing->getSellerName(); // seller/agency name or null $listing->isFromOwner(); // true if listed by owner (not agency) $listing->getBuildingYear(); // construction year or null $listing->getPredictedPrice(); // ['min' => int, 'max' => int, 'value' => int] or null ``` Enums Reference --------------- [](#enums-reference) ### Language [](#language) Supported across places and reviews actors. 6 languages covering the Yandex Maps service area. CaseValueLanguage`Auto``auto`Auto-detect`Russian``ru`Russian`English``en`English`Turkish``tr`Turkish`Ukrainian``uk`Ukrainian`Kazakh``kk`Kazakh### ReviewSort [](#reviewsort) CaseValueDescription`Relevance``relevance`Most relevant first`Newest``newest`Newest first`Highest``highest`Highest rating first`Lowest``lowest`Lowest rating first### MarketSort [](#marketsort) CaseValueDescription`Default`*(none)*Default sorting`Popular``dpop`Most popular first`PriceAsc``aprice`Lowest price first`PriceDesc``dprice`Highest price first`Rating``rating`Highest rating first### MarketRegion [](#marketregion) 16 major Russian cities with their Yandex region IDs. CaseValueCity`Moscow``213`Moscow`SaintPetersburg``2`Saint Petersburg`Yekaterinburg``54`Yekaterinburg`Kazan``43`Kazan`Novosibirsk``65`Novosibirsk`NizhnyNovgorod``69`Nizhny Novgorod`Samara``51`Samara`RostovOnDon``39`Rostov-on-Don`Krasnodar``35`Krasnodar`Chelyabinsk``56`Chelyabinsk`Ufa``61`Ufa`Perm``47`Perm`Voronezh``62`Voronezh`Volgograd``63`Volgograd`Krasnoyarsk``66`Krasnoyarsk`Omsk``68`Omsk### DealType [](#dealtype) CaseValueDescription`Sell``SELL`Properties for sale`Rent``RENT`Properties for rent### PropertyCategory [](#propertycategory) CaseValueDescription`Apartment``APARTMENT`Apartments`Rooms``ROOMS`Individual rooms`House``HOUSE`Houses / cottages`Lot``LOT`Land plots`Commercial``COMMERCIAL`Commercial real estate`Garage``GARAGE`Garages / parking### RealtySort [](#realtysort) CaseValueDescription`Relevance``RELEVANCE`Most relevant first`Newest``DATE_DESC`Newest first`PriceAsc``PRICE`Lowest price first`PriceDesc``PRICE_DESC`Highest price first`AreaAsc``AREA`Smallest area first`AreaDesc``AREA_DESC`Largest area first`CommissioningDate``COMMISSIONING_DATE`By commissioning dateConfiguration ------------- [](#configuration) ``` use YandexParser\Client; use YandexParser\Config; // Simple — just pass the API token $client = new Client('your_apify_api_token'); // Advanced — override timeout or base URL $client = new Client('token', new Config( apiToken: 'token', baseUrl: 'https://api.apify.com/v2', timeout: 600, )); ``` Error Handling -------------- [](#error-handling) ``` use YandexParser\Exception\ApiException; use YandexParser\Exception\RateLimitException; try { $places = $client->scrapePlaces(query: ['cafe'], location: 'Kazan'); } catch (RateLimitException $e) { // Retry after the suggested delay sleep($e->retryAfter); } catch (ApiException $e) { echo "API error: {$e->getMessage()}\n"; } ``` Requirements ------------ [](#requirements) - PHP 8.3+ - [Apify API token](https://console.apify.com/account/integrations) See Also -------- [](#see-also) - [2GIS Scraper PHP](https://github.com/Scraper-APIs/2gis-scraper-php) — scrape 2GIS places and reviews, real estate, jobs across 200+ cities in 20 countries License ------- [](#license) MIT ### Health Score 17 — LowBetter than 6% of packages Maintenance51 Moderate activity, may be stable Popularity0 Limited adoption so far Community6 Small or concentrated contributor base Maturity12 Early-stage or recently created project Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Community Maintainers ![](https://avatars.githubusercontent.com/u/8433587?v=4)[Peter Thaleikis](/maintainers/spekulatius)[@spekulatius](https://github.com/spekulatius) --- Top Contributors [![spekulatius](https://avatars.githubusercontent.com/u/8433587?v=4)](https://github.com/spekulatius "spekulatius (7 commits)") --- Tags apifyclassified-scraperdata-extractionmaps-scraperphp-scraperreal-estate-dataweb-scrapingyandexyandex-scraper ### Embed Badge ![Health badge](/badges/scraper-apis-yandex-scraper/health.svg) ``` [![Health](https://phpackages.com/badges/scraper-apis-yandex-scraper/health.svg)](https://phpackages.com/packages/scraper-apis-yandex-scraper) ``` ### Alternatives [macroman/terminal-progress-bar Flexible ascii progress bar. 5246.2k](/packages/macroman-terminal-progress-bar) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)