PHPackages scraper-apis/2gis-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. [Parsing & Serialization](/categories/parsing) 4. / 5. scraper-apis/2gis-scraper ActiveLibrary[Parsing & Serialization](/categories/parsing) scraper-apis/2gis-scraper ========================= PHP client library for scraping 2GIS data (places, reviews, property, jobs) using Apify actors 011PHPCI passing Since Feb 20Pushed 3mo agoCompare [ Source](https://github.com/Scraper-APIs/2gis-scraper-php)[ Packagist](https://packagist.org/packages/scraper-apis/2gis-scraper)[ RSS](/packages/scraper-apis-2gis-scraper/feed)WikiDiscussions master Synced 1w ago READMEChangelogDependenciesVersions (1)Used By (0) 2GIS Scraper PHP ================ [](#2gis-scraper-php) **English** | [Русский](https://github.com/Scraper-APIs/2gis-parser-php) A PHP client library for scraping data from [2GIS](https://2gis.ru) — the largest business directory and map service across Russia, Central Asia, and the Middle East. Extract places, reviews, real estate listings, and job vacancies with typed DTOs. Powered by [Apify](https://apify.com/) actors under the hood. Installation ------------ [](#installation) ``` composer require scraper-apis/2gis-scraper ``` Quick Start ----------- [](#quick-start) ``` use TwoGisParser\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->name} — {$place->address}\n"; echo "Rating: {$place->rating} ({$place->reviewCount} reviews)\n"; if ($place->hasContactInfo()) { echo "Phone: {$place->getFirstPhone()}\n"; echo "Email: {$place->getFirstEmail()}\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 data type. ### 1. Places / Businesses [](#1-places--businesses) Search the 2GIS catalog by keyword and city. Returns rich records with 60+ fields including contacts, ratings, schedule, photos, and more. Covers 207 cities across 20 countries. ``` use TwoGisParser\Language; use TwoGisParser\Country; $places = $client->scrapePlaces( query: ['dentist', 'dental clinic'], location: 'Saint Petersburg', maxResults: 200, language: Language::Russian, country: Country::Russia, options: [ 'categoryFilter' => ['Dentistry'], 'filterRating' => 'excellent', // 4.5+ rating 'skipClosedPlaces' => true, 'filterCardPayment' => true, 'maxReviews' => 10, // fetch up to 10 reviews per place 'maxPhotos' => 5, // fetch up to 5 photos per place ], ); ``` **Available options for `scrapePlaces()`:** OptionTypeDescription`categoryFilter``string[]`Filter by business categories (fuzzy-matched against 731 categories)`filterRating``string`Min rating: `perfect` (4.9+), `excellent` (4.5+), `pretty_good` (4.0+), `nice` (3.5+), `not_bad` (3.0+)`sortBy``string`Sort by: `rating`, `opened_time`, `name``filterWebsite``string``all`, `withWebsite`, `withoutWebsite``skipClosedPlaces``bool`Skip permanently closed places`searchMatching``string``all`, `only_includes`, `only_exact``filterHasPhotos``bool`Only places with photos`filter24h``bool`Only 24/7 places`filterNewPlaces``bool`Only recently opened places`filterDelivery``bool`Has delivery`filterTakeaway``bool`Has takeaway`filterCardPayment``bool`Accepts card payment`filterWifi``bool`WiFi available`filterHasGoods``bool`Has price list/goods on 2GIS`filterAvgPriceMin``int`Min average check (local currency)`filterAvgPriceMax``int`Max average check (local currency)`maxReviews``int`Max reviews per place (0 = disabled, 99999 = all)`reviewsRating``string``all`, `positive` (4-5), `negative` (1-2)`reviewsWithAnswer``bool`Only reviews with business reply`reviewsStartDate``string`Only reviews after YYYY-MM-DD`reviewsTopic``string`Server-side topic filter`reviewsFilterKeyword``string`Client-side text search within reviews`reviewsSource``string``all`, `2gis`, `flamp`, `booking``maxPhotos``int`Max photos per place (0 = disabled, 99999 = all)`photoCategories``string[]`Photo categories: `food_and_drinks`, `interior`, `outside`, `price_list_image`, etc.`scrapeOrgBranches``bool`Scrape all branches of found organizations**Place DTO helpers:** ``` $place->hasContactInfo(); // true if phones or emails exist $place->getFirstPhone(); // first phone number or null $place->getFirstEmail(); // first email or null $place->hasWebsite(); // true if website is set $place->getCoordinates(); // ['lat' => float, 'lng' => float] or null ``` ### 2. Reviews [](#2-reviews) Extract reviews from specific 2GIS places. Accepts place URLs, search URLs, or branch IDs. Returns flat one-row-per-review records, ideal for CSV/Excel export. Aggregates reviews from 2GIS, Flamp, and Booking. ``` use TwoGisParser\ReviewsRating; use TwoGisParser\ReviewsSource; $reviews = $client->scrapeReviews( startUrls: [ 'https://2gis.ru/moscow/firm/70000001057394703', '70000001057394704', // plain branch ID also works ], maxReviews: 500, maxPlaces: 5, reviewsRating: ReviewsRating::Negative, reviewsSource: ReviewsSource::TwoGis, options: [ 'reviewsStartDate' => '2025-01-01', 'reviewsWithAnswer' => true, ], ); foreach ($reviews as $review) { echo "{$review->authorName}: {$review->rating}/5\n"; echo "{$review->text}\n"; if ($review->hasOfficialAnswer()) { echo "Reply: {$review->getOfficialAnswerText()}\n"; } } ``` **Available options for `scrapeReviews()`:** OptionTypeDescription`reviewsWithAnswer``bool`Only reviews with business reply`reviewsStartDate``string`Only reviews after YYYY-MM-DD`reviewsTopic``string`Server-side topic filter`reviewsFilterKeyword``string`Client-side keyword filter**Review DTO helpers:** ``` $review->hasOfficialAnswer(); // true if business replied $review->getOfficialAnswerText(); // reply text or null $review->hasPhotos(); // true if review has photos $review->isPositive(); // true if rating >= 4 $review->isNegative(); // true if rating scrapeProperties( location: 'Kazan', maxResults: 500, category: PropertyCategory::SaleResidential, sort: PropertySort::PriceAsc, options: [ 'rooms' => ['2', '3'], 'priceMax' => 15000000, 'areaMin' => 50, 'notFirstFloor' => true, 'notLastFloor' => true, ], ); foreach ($properties as $property) { echo "{$property->name}\n"; echo "Price: {$property->getPriceFormatted()}\n"; echo "Area: {$property->area} m², floor {$property->floor}\n"; echo "Address: {$property->address}\n"; } ``` **Available options for `scrapeProperties()`:** OptionTypeDescription`rooms``string[]`Room count: `studio`, `1`, `2`, `3`, `4`, `5``propertyType``string[]``flat`, `house`, `land`, `cottage`, `room`, `townhouse`, `share`, `part_house``newBuilding``string[]``secondary` (resale), `new` (new building)`priceMin``int`Minimum price`priceMax``int`Maximum price`pricePerMeterMin``float`Min price per m2`pricePerMeterMax``float`Max price per m2`areaMin``float`Min area in m2`areaMax``float`Max area in m2`floorMin``int`Min floor number`floorMax``int`Max floor number`notFirstFloor``bool`Exclude first floor`notLastFloor``bool`Exclude last floor`floorsInBuildingMin``int`Min building floors`floorsInBuildingMax``int`Max building floors`metroTime``string`Metro proximity: `5`, `10`, `20` (minutes walking)`provider``string[]`Listing providers: `cian`, `domclick`**Property DTO helpers:** ``` $property->hasImages(); // true if images array is not empty $property->getCoordinates(); // ['lat' => float, 'lng' => float] or null $property->getPriceFormatted(); // "1,500,000 RUB" or null ``` **Tip:** Need more data? Check our [Yandex Scraper](https://github.com/Scraper-APIs/yandex-scraper-php) for places and reviews from Yandex Maps, products from Yandex Market, real estate listings from Yandex Realty. All in one, for peace of mind. ### 4. Jobs / Vacancies [](#4-jobs--vacancies) Scrape job vacancies from 2GIS by city. Supports filtering by 224 job categories and salary range. ``` $jobs = $client->scrapeJobs( location: 'Novosibirsk', maxResults: 300, categoryId: '200', // Developer salaryMin: 80000, salaryMax: 250000, ); foreach ($jobs as $job) { echo "{$job->name} at {$job->orgName}\n"; echo "Salary: {$job->salaryLabel}\n"; echo "Address: {$job->address}\n"; if ($job->hasApplyUrl()) { echo "Apply: {$job->applyUrl}\n"; } } ``` **Job DTO helpers:** ``` $job->hasApplyUrl(); // true if apply URL is set $job->getCoordinates(); // ['lat' => float, 'lng' => float] or null ``` Enums Reference --------------- [](#enums-reference) ### Language [](#language) Supported across all 4 actors. 14 languages covering the 2GIS service area. CaseValueLanguage`Auto``auto`Auto-detect`Russian``ru`Russian`English``en`English`Arabic``ar`Arabic`Kazakh``kk`Kazakh`Uzbek``uz`Uzbek`Kyrgyz``ky`Kyrgyz`Armenian``hy`Armenian`Georgian``ka`Georgian`Azerbaijani``az`Azerbaijani`Tajik``tg`Tajik`Czech``cs`Czech`Spanish``es`Spanish`Italian``it`Italian### Country [](#country) 21 countries where 2GIS operates. CaseValue`Auto`*(auto-detect)*`Russia``ru``Kazakhstan``kz``UAE``ae``Uzbekistan``uz``Kyrgyzstan``kg``Armenia``am``Georgia``ge``Azerbaijan``az``Belarus``by``Tajikistan``tj``SaudiArabia``sa``Bahrain``bh``Kuwait``kw``Qatar``qa``Oman``om``Iraq``iq``Chile``cl``Czechia``cz``Italy``it``Cyprus``cy`### Other Enums [](#other-enums) EnumValues`RatingFilter``None`, `Perfect` (4.9+), `Excellent` (4.5+), `PrettyGood` (4.0+), `Nice` (3.5+), `NotBad` (3.0+)`ReviewsRating``All`, `Positive` (4-5 stars), `Negative` (1-2 stars)`ReviewsSource``All`, `TwoGis`, `Flamp`, `Booking``PropertyCategory``SaleResidential`, `SaleCommercial`, `RentResidential`, `RentCommercial`, `DailyRent``PropertySort``Default`, `PriceAsc`, `PriceDesc`, `AreaAsc`, `AreaDesc`Configuration ------------- [](#configuration) ``` use TwoGisParser\Client; use TwoGisParser\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 TwoGisParser\Exception\ApiException; use TwoGisParser\Exception\RateLimitException; try { $places = $client->scrapePlaces(query: ['cafe'], location: 'Almaty'); } 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) License ------- [](#license) MIT ### Health Score 19 — LowBetter than 10% of packages Maintenance53 Moderate activity, may be stable Popularity3 Limited adoption so far Community7 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 (8 commits)") --- Tags 2gis2gis-parser2gis-scraperapifybusiness-directorydata-extractiongisjob-scraperlead-generationphp-scraperreal-estate-datareview-scraperweb-scraping ### Embed Badge ![Health badge](/badges/scraper-apis-2gis-scraper/health.svg) ``` [![Health](https://phpackages.com/badges/scraper-apis-2gis-scraper/health.svg)](https://phpackages.com/packages/scraper-apis-2gis-scraper) ``` ### Alternatives [mck89/peast Peast is PHP library that generates AST for JavaScript code 19037.7M41](/packages/mck89-peast)[karriere/json-decoder JsonDecoder implementation that allows you to convert your JSON data into PHP class objects 141439.4k12](/packages/karriere-json-decoder)[sauladam/shipment-tracker Parses tracking information for several carriers, like UPS, USPS, DHL and GLS by simply scraping the data. No need for any kind of API access. 9642.0k](/packages/sauladam-shipment-tracker)[jstewmc/rtf Read and write Rich Text Format (RTF) documents with PHP 45143.1k6](/packages/jstewmc-rtf)[json-mapper/laravel-package The JsonMapper package for Laravel 25188.9k3](/packages/json-mapper-laravel-package)[jamesmoss/toml A parser for TOML implemented in PHP. 3231.7k15](/packages/jamesmoss-toml) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)