# 2GIS Places Scraper - Phones, Emails, Hours & Reviews (`parseforge/2gis-places-scraper`) Actor Scrape 2GIS businesses in 206 cities across Russia, Kazakhstan, Uzbekistan, the UAE and more: phones, emails, websites, socials, hours, ratings, plus reviews as separate rows. Goes past the 5,000 result cap. Export CSV, Excel, JSON or XML. No 2GIS key needed. - **URL**: https://apify.com/parseforge/2gis-places-scraper.md - **Developed by:** [ParseForge](https://apify.com/parseforge) (community) - **Categories:** Lead generation, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks - **User rating**: No ratings yet ## Pricing from $1.90 / 1,000 place scrapeds This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events. Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have. Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event ## What's an Apify Actor? An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes. In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours, and optionally produces a well-defined JSON output, datasets with results, or files in key-value store. In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server. Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md. ## How to integrate an Actor? If asked about integration, you help developers integrate Actors into their projects. You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready. Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run. For examples already wired to this Actor's own input schema, see the [API](#api) section below. Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`). # README ![ParseForge Banner](https://raw.githubusercontent.com/ParseForge/apify-assets/main/banner-v3.webp) ## 🗺️ 2GIS Places Scraper > 🚀 **Export 2GIS business listings in seconds.** Up to 69 fields per place with phones, emails, websites, social links, hours and ratings, plus reviews as their own rows. No 2GIS account and no API key. 2GIS is the business directory and map used across Russia, Kazakhstan, Uzbekistan, the UAE and 16 more countries. Its public catalog shows about 5,000 results per search and its website has no export. This Actor reads the same public catalog that powers the 2GIS website, and when a search holds more than one query can show (8,844 cafes in Moscow, for example) it splits the map into circles and collects them all. Search by keyword, rubric and city, or paste 2GIS links. You get one flat row per place, and optionally one row per review and the photo gallery of each place. | 🎯 Target Audience | 💡 Primary Use Cases | | --- | --- | | Sales and lead teams | Lead lists by city and category with phone, email, website and socials, including businesses with no website | | Marketing and SEO agencies | Local prospects to pitch, ranked by rating, review count and average bill | | Market researchers | Competitor and coverage maps by district, category and chain | | Franchise and retail analysts | Every branch of a chain with address, coordinates and hours | | Reputation teams | Reviews with stars, source, date and the business reply | | Data and GIS teams | Place tables with coordinates for maps, BI and ML | ### 📋 What the 2GIS Places Scraper does > 💡 **Why it matters:** a directory entry tells you a business exists. A phone, an email and a rating tell you whether it is worth contacting. This Actor puts all of it in one row. - Searches by keyword, by 2GIS rubric (1,667 categories) or both, in one of 206 cities or a whole country. - Accepts search links, place links, organization (all branches) links, building links, go.2gis.com short links and bare place IDs. - Returns name, branch ID, organization, brand, branch count, categories, full address, street, postcode, district, city, country, latitude and longitude. - Returns every phone, email and website, plus Instagram, Facebook, VK, Telegram, WhatsApp and YouTube links. - Returns opening hours by day, a 24 hour flag, rating and review count for the branch and for the whole organization, and the average bill. - Returns payment methods, services and attribute groups. - Splits searches bigger than 5,000 places into map circles and de-duplicates them. - Filters at the source by website, photos, reviews, rated places, open now and open 24 hours, and by email, phone, Wi-Fi, card payment, delivery, takeaway, average bill and listing age on each listing. - Optional reviews as separate rows, filtered by stars, source and date, with the business reply. - Optional photo gallery of each place, up to 10 full-size image URLs. ### 🎬 Full Demo 🚧 Coming soon. ### 📊 Output Every row has a `rowType` column. `place` rows carry the business, `review` rows carry one review and point back to their place through `placeId`. A `photos` list is added to place rows when the photo gallery option is on. #### Place rows | Field | Type | Description | | --- | --- | --- | | 🖼 `imageUrl` | string | Main photo of the place (or the first review photo on review rows) | | 🏷 `rowType` | string | place or review | | 🏷 `name` | string | Short name of the place | | 🏷 `fullName` | string | Name with its rubric, as 2GIS shows it | | 🆔 `placeId` | string | 2GIS branch id (firm id) | | 🔗 `url` | string | 2GIS page of the place | | 🆔 `organizationId` | string | 2GIS organization id (shared by every branch) | | 🏷 `organizationName` | string | Organization name | | 📌 `brand` | string | Brand name | | 🔢 `branchCount` | number | Branches of the organization | | 🏷 `primaryCategory` | string | Main rubric | | 🏷 `categories` | array | All rubrics | | 🏷 `categoryIds` | array | Rubric ids | | 📍 `address` | string | Street address | | 📍 `fullAddress` | string | Address with the city | | 📍 `addressDetails` | string | Floor, office or entrance note | | 📍 `street` | string | Street and number | | 📌 `postcode` | string | Postcode | | 🆔 `buildingId` | string | 2GIS building id | | 📍 `district` | string | District | | 📍 `city` | string | City | | 📍 `region` | string | Region | | 📍 `country` | string | Country | | 🧭 `latitude` | number | Latitude | | 🧭 `longitude` | number | Longitude | | 📞 `phone` | string | First phone number | | 📞 `phones` | array | All phone numbers | | ✉️ `email` | string | First email | | ✉️ `emails` | array | All emails | | 🔗 `website` | string | First website | | 🔗 `websites` | array | All websites | | 🏷 `instagram` | string | Instagram link | | 📌 `facebook` | string | Facebook link | | 📌 `vk` | string | VKontakte link | | 📞 `telegram` | string | Telegram link | | 📌 `whatsapp` | string | WhatsApp link | | 📌 `youtube` | string | YouTube link | | 🔗 `socialLinks` | object | Every social link by network | | ⏰ `openingHours` | object | Opening hours by day | | 💬 `openingHoursText` | string | Opening hours on one line | | ⏰ `open24x7` | string | Open around the clock | | ⏰ `specialHours` | array | Holiday or special schedule notes | | ⭐ `rating` | number | Star rating of this branch | | 💬 `reviewCount` | number | Reviews of this branch | | 💬 `ratedReviewCount` | number | Reviews with a star rating | | ⭐ `organizationRating` | number | Rating of the whole organization | | 💬 `organizationReviewCount` | number | Reviews of the whole organization | | 📌 `averageBill` | string | Average bill as 2GIS writes it | | 📌 `averageBillValue` | number | Average bill amount | | 💵 `averageBillCurrency` | string | Average bill currency | | 📌 `paymentMethods` | array | Accepted payment methods | | 📌 `features` | array | Services and attributes | | 📌 `attributeGroups` | object | Attributes by group | | 📌 `badges` | array | Badges and awards | | 🖼 `hasPhotos` | string | Place has photos | | 🖼 `photoCount` | number | Photos in the gallery | | 📌 `isPromoted` | string | Paid advertiser placement | | 💬 `promoText` | string | Advertiser text | | 📌 `description` | string | Description when the listing has one | | 📌 `purpose` | string | Type of the place | | 🕒 `updatedAt` | string | Last update of the listing | | 🕒 `createdAt` | string | Creation date of the listing | | 🕒 `timezoneOffsetMinutes` | number | Time zone offset in minutes | | 📍 `regionId` | string | 2GIS city id | | 📌 `searchTerm` | string | Search term that found the place | | 📍 `searchLocation` | string | City searched | | 🖼 `photos` | array | Photo URLs at 1920 px (when photos are requested) | | 🕒 `scrapedAt` | string | Scrape time (ISO) | | ❌ `error` | string | Error message, empty on data rows | #### Review rows | Field | Type | Description | | --- | --- | --- | | 🖼 `imageUrl` | string | Main photo of the place (or the first review photo on review rows) | | 🏷 `rowType` | string | place or review | | 💬 `reviewId` | string | Review id | | 🆔 `placeId` | string | 2GIS branch id (firm id) | | 🏷 `placeName` | string | Place the review is about | | 💵 `placeUrl` | string | 2GIS page of that place | | ⭐ `rating` | number | Star rating of this branch | | 💬 `text` | string | Review text | | 📌 `source` | string | 2gis, flamp, booking and others | | 🕒 `dateCreated` | string | Written at | | 🕒 `dateEdited` | string | Edited at | | 🏷 `authorName` | string | Author | | 🆔 `authorId` | string | Author id | | 🖼 `authorPhoto` | string | Author photo | | 💬 `authorReviewCount` | number | Reviews by the author | | 🔢 `likes` | number | Likes | | 💬 `comments` | number | Comments | | 🖼 `photos` | array | Photo URLs at 1920 px (when photos are requested) | | 📌 `businessReply` | string | Reply of the business | | 🕒 `businessReplyDate` | string | Date of the reply | | 📌 `isRated` | string | Review carries stars | | 🕒 `scrapedAt` | string | Scrape time (ISO) | | ❌ `error` | string | Error message, empty on data rows | Three real records from a run (long lists shortened): ```json [ { "imageUrl": "https://i2.photo.2gis.com/main/branch/0/70000001113359188/common", "rowType": "place", "name": "Здрасте", "fullName": "Здрасте, кофейня", "placeId": "70000001113359188", "url": "https://2gis.ru/moscow/firm/70000001113359188", "organizationId": "70000001033681797", "organizationName": "Здрасте, кофейня", "brand": "Здрасте", "branchCount": 103, "primaryCategory": "Кофейни", "categories": [ "Кофейни", "Кафе", "Доставка еды" ], "categoryIds": [ "162", "161", "1203" ], "address": "Крымская набережная, 10 ст2", "fullAddress": "Москва, Крымская набережная, 10 ст2", "addressDetails": "Not Disclosed", "street": "Крымская набережная 10 ст2", "postcode": "119049", "buildingId": "4504235290707169", "district": "Якиманка", "city": "Москва", "region": "Москва", "country": "Россия", "latitude": 55.735952, "longitude": 37.605268, "phone": "+79966574489", "phones": [ "+79966574489" ], "email": "Not Disclosed", "emails": [], "website": "http://zdrastecafe.ru", "websites": [ "http://zdrastecafe.ru", "http://zdraste.ru", "http://t.me/+X0ITYNollx1iOGEy" ], "instagram": "Not Disclosed", "facebook": "Not Disclosed", "vk": "https://vk.com/zdrastecoffeebar", "telegram": "https://t.me/zdrastecafe", "whatsapp": "Not Disclosed", "youtube": "Not Disclosed", "socialLinks": { "vkontakte": [ "https://vk.com/zdrastecoffeebar" ], "telegram": [ "https://t.me/zdrastecafe" ] }, "openingHours": { "Monday": "10:00-22:00", "Tuesday": "10:00-22:00", "Wednesday": "10:00-22:00", "Thursday": "10:00-22:00", "Friday": "10:00-22:00", "Saturday": "10:00-22:00", "Sunday": "10:00-22:00" }, "openingHoursText": "Mon 10:00-22:00; Tue 10:00-22:00; Wed 10:00-22:00; Thu 10:00-22:00; Fri 10:00-22:00; Sat 10:00-22:00; Sun 10:00-22:00", "open24x7": "No", "specialHours": [], "rating": 4.8, "reviewCount": 107, "ratedReviewCount": 122, "organizationRating": 4.9, "organizationReviewCount": 16949, "averageBill": "Чек 1500 ₽", "averageBillValue": 1500, "averageBillCurrency": "₽", "paymentMethods": [ "Оплата картой", "Наличный расчёт" ], "features": [ "Детское кафе", "Европейская кухня" ], "attributeGroups": { "Ресторан / Кафе": [ "Чек 1500 ₽", "Детское кафе", "Европейская кухня", "Авторская кухня", "Бизнес-ланч", "Завтрак", "Заказ навынос", "Детское меню", "Постное меню", "Аниматоры, мастер-классы для детей", "Можно с ноутбуком", "Английский завтрак" ], "Меню": [ "Пицца", "Паста", "Поке", "Бельгийские вафли", "Сэндвичи", "На гриле", "Бутерброды", "Кесадилья", "Боулы", "Панкейки" ], "Напитки": [ "Bubble Tea", "Чай с собой", "Смузи", "Молочные коктейли", "Свежевыжатые соки", "Какао", "Лимонад" ], "Доставка": [ "Пицца", "Завтраки", "Десерты", "Паста", "Вторые блюда", "Салаты", "Закрытая пицца", "Кофе" ], "Услуги": [ "Доставка" ], "Дополнительно": [ "Wi-Fi для клиентов", "Туалет" ], "Способы оплаты": [ "Оплата картой", "Наличный расчёт", "Оплата по QR-коду", "Оплата через приложение" ], "Актуальность данных": [ "Данные актуальны" ] }, "badges": [], "hasPhotos": "Yes", "photoCount": 59, "isPromoted": "Yes", "promoText": "Лето в «Здрасте». Завтраки весь день и любимый кофе от 290 ₽", "description": "Not Disclosed", "purpose": "Кафе, бар", "updatedAt": "2026-10-05T05:39:06Z", "createdAt": "Not Disclosed", "timezoneOffsetMinutes": 180, "regionId": "32", "searchTerm": "кофейни", "searchLocation": "Москва", "photos": [ "https://i0.photo.2gis.com/photo-gallery/812c1e0e-a5a1-4765-806a-2caaf7fa8473_1920x.jpg", "https://i5.photo.2gis.com/photo-gallery/525714c4-906f-411e-bc47-e82bd2fd391c_1920x.jpg" ], "scrapedAt": "2026-10-23T21:39:50.810Z", "error": null }, { "imageUrl": "https://i8.photo.2gis.com/main/branch/0/70000001114794591/common", "rowType": "place", "name": "Special", "fullName": "Special, кофейня", "placeId": "70000001114794591", "url": "https://2gis.ru/moscow/firm/70000001114794591", "organizationId": "70000001115608348", "organizationName": "Special, кофейня", "brand": "N/A", "branchCount": 1, "primaryCategory": "Кофейни", "categories": [ "Кофейни", "Кафе" ], "categoryIds": [ "162", "161" ], "address": "Сельскохозяйственная улица, вл35 к6", "fullAddress": "Москва, Сельскохозяйственная улица, вл35 к6", "addressDetails": "Not Disclosed", "street": "Сельскохозяйственная улица вл35 к6", "postcode": "129323", "buildingId": "70030076195138420", "district": "Останкинский", "city": "Москва", "region": "Москва", "country": "Россия", "latitude": 55.853786, "longitude": 37.623477, "phone": "+79151258503", "phones": [ "+79151258503" ], "email": "Not Disclosed", "emails": [], "website": "http://onespecial.ru/", "websites": [ "http://onespecial.ru/" ], "instagram": "Not Disclosed", "facebook": "Not Disclosed", "vk": "Not Disclosed", "telegram": "Not Disclosed", "whatsapp": "Not Disclosed", "youtube": "Not Disclosed", "socialLinks": {}, "openingHours": { "Monday": "08:00-22:00", "Tuesday": "08:00-22:00", "Wednesday": "08:00-22:00", "Thursday": "08:00-22:00", "Friday": "08:00-22:00", "Saturday": "08:00-22:00", "Sunday": "08:00-22:00" }, "openingHoursText": "Mon 08:00-22:00; Tue 08:00-22:00; Wed 08:00-22:00; Thu 08:00-22:00; Fri 08:00-22:00; Sat 08:00-22:00; Sun 08:00-22:00", "open24x7": "No", "specialHours": [], "rating": 5, "reviewCount": 19, "ratedReviewCount": 23, "organizationRating": 5, "organizationReviewCount": 19, "averageBill": "Not Disclosed", "averageBillValue": "N/A", "averageBillCurrency": "N/A", "paymentMethods": [ "Оплата картой", "Наличный расчёт", "Оплата по QR-коду" ], "features": [ "Данные актуальны" ], "attributeGroups": { "Способы оплаты": [ "Оплата картой", "Наличный расчёт", "Оплата по QR-коду" ], "Актуальность данных": [ "Данные актуальны" ] }, "badges": [], "hasPhotos": "Yes", "photoCount": 97, "isPromoted": "Yes", "promoText": "Отдохните от суеты и насладитесь блюдами ресторанного уровня у нас!", "description": "Not Disclosed", "purpose": "N/A", "updatedAt": "2026-09-14T17:00:13Z", "createdAt": "Not Disclosed", "timezoneOffsetMinutes": 180, "regionId": "32", "searchTerm": "кофейни", "searchLocation": "Москва", "photos": [ "https://i2.photo.2gis.com/photo-gallery/7f1ad95d-a9b0-4f9d-b206-1f737a80c34d_1920x.jpg", "https://i0.photo.2gis.com/photo-gallery/4d420cbf-374e-42f4-bec8-6e12bebb82a7_1920x.jpg" ], "scrapedAt": "2026-10-23T21:39:50.811Z", "error": null }, { "imageUrl": "https://i2.photo.2gis.com/images/profile/30258560337826213_e739.jpg", "rowType": "review", "reviewId": "309080343", "placeId": "70000001114794591", "placeName": "Special", "placeUrl": "https://2gis.ru/moscow/firm/70000001114794591", "rating": 5, "text": "Я туда захожу по пути всегда", "source": "2gis", "dateCreated": "2026-10-24T02:00:32.535483+07:00", "dateEdited": "Not Disclosed", "authorName": "Городской житель", "authorId": "c8e526fff27b414a8cdd9bed62abcdf1", "authorPhoto": "https://i2.photo.2gis.com/images/profile/30258560337826213_e739.jpg", "authorReviewCount": 6, "likes": 0, "comments": 0, "photos": [], "businessReply": "Not Disclosed", "businessReplyDate": "Not Disclosed", "isRated": "Yes", "scrapedAt": "2026-10-23T21:39:53.074Z", "error": null } ] ``` Fields a listing does not publish hold `Not Disclosed`, or `N/A` when they do not apply, never an empty cell. `isPromoted` marks paid advertiser placements, which 2GIS ranks first. Instagram and Facebook links are empty for Russian businesses, where both are blocked, and filled for most other countries. ### ✨ Why choose this Actor - **Past the 5,000 cap.** Searches bigger than one query can read are split into circles automatically. 8,844 unique Moscow cafes came back from one test run. - **206 cities, 20 countries.** Pick cities from a list or one whole country. Names follow the city's language. - **Contacts inside every row.** Phones, emails, websites and socials are part of the place, not an add-on event. - **Reviews as rows.** One row per review with stars, text, source, dates, author, likes and the business reply. - **Filters 2GIS applies itself.** Website, photos, reviews, rated, open now, open 24 hours and sort by rating change the totals at the source. - **Pay for what you switch on.** Places, reviews and photo galleries are separate pay-per-event items. Reviews and photos are off by default. ### 📈 How it compares to alternatives | | This Actor | Typical 2GIS scraper | Manual browsing | | --- | --- | --- | --- | | Places by keyword and city | ✅ | ✅ | ✅ one at a time | | Phones, emails, websites, socials per row | ✅ included | Sometimes billed on top | ✅ one at a time | | Searches past 5,000 results | ✅ map circles | Sometimes | ❌ | | Reviews as separate rows | ✅ stars, source and date filters | Sometimes | ✅ one at a time | | Whole-country search | ✅ | Sometimes | ❌ | | Free-text location or drawn area | ❌ city list plus a circle | Sometimes | ✅ | | Building and apartment data | ❌ | Rarely | ✅ one at a time | ### 🚀 How to use 1. Create a free Apify account. New accounts get $5 in free credit: [sign up here](https://console.apify.com/sign-up?fpr=vmoqkp). 2. Open the 2GIS Places Scraper and click **Try for free**. 3. Enter search terms and pick your cities, or paste 2GIS links. 4. Set **Max Items** and any filters. 5. Turn on reviews or the photo gallery if you need them. 6. Click **Start** and watch the run log. 7. Open the **Storage** tab and download CSV, Excel, JSON or XML, or read the rows through the Apify API. Input examples: ```json { "searchTerms": ["кофейни"], "locations": ["moscow", "spb"], "sort": "rating", "onlyWithEmail": true, "onlyWithoutWebsite": true, "maxItems": 500 } ``` ```json { "searchTerms": ["стоматология"], "locations": ["almaty"], "maxItems": 50, "maxReviewsPerPlace": 100, "reviewMinRating": 1, "reviewMaxRating": 2 } ``` ```json { "startUrls": [{ "url": "https://2gis.kz/almaty/branches/9429948590736555" }, { "url": "https://2gis.ru/moscow/firm/70000001024539495" }] } ``` Free Apify plans return up to 10 places with up to 10 reviews each as a preview. ### 💼 Business use cases #### Local lead lists Search a category in one city or a whole country, keep places with an email or a phone, or keep only places with no website to sell web and marketing services. #### Market mapping List every branch of a chain, every dentist in a district, or every place inside a circle around an address, with coordinates for your GIS or BI tool. #### Reputation watch Pull the reviews of a place or a category, filter by stars (1 to 2 for complaints), by source and by date, with the business reply next to each review. #### Spotting new openings Use the listing age filter and sort by rating to find places added to 2GIS recently. ### 🔌 Automating 2GIS Places Scraper - **Make and Zapier**: run the Actor on a schedule and send new leads to a CRM. - **Slack**: post an alert when a place gets a new 1 star review. - **Airbyte**: sync places and reviews into a warehouse and join them on `placeId`. - **GitHub Actions**: run weekly and commit the CSV so a change history builds itself. - **Google Drive**: drop each export into a shared folder for the sales team. - **Apify Scheduler**: run daily, weekly or hourly with no external tooling. ### 🌟 Beyond business use cases - **Research**: study how the density of cafes, clinics or pharmacies varies across districts and countries. - **Personal**: find open 24 hour pharmacies in a new city before you travel. - **Non-profit**: map clinics and shelters with phones for a community directory. - **Experimentation**: build a multilingual review corpus with star labels and business replies. ### 🤖 Ask an AI assistant about this scraper Paste this into ChatGPT, Claude or any assistant: > I am using the 2GIS Places Scraper on Apify. It returns place rows with name, address, latitude, longitude, phones, emails, website, rating, reviewCount and openingHours, and review rows with rating, text, source, dateCreated and businessReply linked by placeId. Help me design an analysis that finds the best rated dental clinics per district in one city and lists which ones have no website. ### ❓ Frequently Asked Questions #### 🔑 Do I need a 2GIS account or API key? No. The Actor reads the public 2GIS catalog. There is nothing to sign up for and no key to paste. #### 🌍 Which countries and cities are covered? 206 cities in 20 countries, including Russia, Kazakhstan, Uzbekistan, Kyrgyzstan, Azerbaijan, the UAE, Saudi Arabia, Chile and Cyprus. Pick cities from the list or set a country code to search all of its cities. #### 🔢 How many places can I get per search? One 2GIS query shows about 5,000 places. When a search is bigger, the Actor tiles the area with circles and de-duplicates, which gave 8,844 unique cafes for Moscow. `maxItems` and `maxItemsPerSearch` cap the run. #### 📧 Are emails really included? Yes, when the listing publishes one. The `email` and `emails` columns carry them, and `onlyWithEmail` keeps only places that have one. The email is the one the business itself lists. #### 📱 Why are Instagram and Facebook empty for Russian places? Both are blocked in Russia, and 2GIS does not show them there. In our test of 4,142 Moscow cafes none carried either link. Other countries have them. #### 💬 How do reviews work? Set reviews per place above zero and each review comes as its own row with `rowType` set to `review`. You can filter by stars, by source (2GIS, Flamp, Booking and more) and by date. #### 🖼 What does the photo gallery add? Up to 10 full-size photo URLs per place in a `photos` list. It is an optional extra and off by default. #### 🔎 Can I search by free-text address or draw an area? No. Location is a city or country list plus an optional circle (latitude, longitude and radius). Free-text places and drawn areas are not supported. #### 🏢 Do I get building or apartment data? No. The Actor returns businesses and their reviews. It does not return residential buildings or apartments. #### 🔁 Can the same place appear twice? No. Rows are de-duplicated on the place ID within a run. #### 🌐 Do I need a proxy? The default already uses Apify residential proxy, which was the only option that stayed clean in our tests. Datacenter proxies worked on some runs and stalled on others. #### 🛑 What happens when 2GIS blocks a run? The Actor retries. If nothing comes back it ends with an error row, which is never charged. #### 💵 How is it billed? Pay per event: one event per place, one per review and one per place whose photo gallery was read. Error rows are free. Current prices are on the Actor's Pricing tab. ### 🔌 Integrate with any app Every run writes to an Apify dataset you can read over the REST API, stream into a webhook, or export as CSV, Excel, JSON or XML. Apify's integrations cover Make, Zapier, Airbyte, Slack, Google Drive, GitHub, Google Sheets and plain HTTP webhooks, so the rows land wherever your team already works. ### 🔗 Recommended Actors - [Google Maps Scraper](https://apify.com/parseforge/google-maps-scraper) for places, phones, ratings and details from Google Maps. - [Google Maps Reviews Scraper](https://apify.com/parseforge/google-maps-reviews-scraper) for review rows from Google Maps. - [Yelp Scraper](https://apify.com/parseforge/yelp-scraper) for local business listings and reviews from Yelp. > 💡 **Pro Tip:** browse the complete [ParseForge collection](https://apify.com/parseforge) for more scrapers. **🆘 Need Help?** [Open our contact form](https://tally.so/r/BzdKgA) > **⚠️ Disclaimer:** This is an independent tool and is not affiliated with, endorsed by, or connected to 2GIS. It collects only publicly available data. Business emails and phone numbers are published by the businesses themselves. You are responsible for using the data in line with 2GIS's terms and applicable laws, including GDPR and anti-spam rules. # Actor input Schema ## `searchTerms` (type: `array`): Keywords or business types, one per line. 2GIS matches them in the language of the city (Russian for Russia, Russian or Kazakh for Kazakhstan, English or Arabic for the UAE). Each term is searched in every selected city. ## `startUrls` (type: `array`): 2GIS search, place (/firm/), organization (/branches/) or building (/inside/) URLs, go.2gis.com short links or numeric place ids. Mix them freely. ## `maxItems` (type: `integer`): Free users: Limited to 10 items (preview). Paid users: Optional, max 1,000,000 ## `locations` (type: `array`): One or more of the 206 cities 2GIS covers. Empty means Moscow. Ignored when a country below is chosen. ## `countryCode` (type: `string`): Search every 2GIS city of one country instead of the cities above. Use with a per-search limit. ## `rubricIds` (type: `array`): Optional 2GIS rubrics (1,667 of them). Combined with the search terms when both are given, or used alone to list every place of a rubric. ## `language` (type: `string`): Language of names, categories and addresses. Auto uses the city's first language; if the city does not offer the one you pick it falls back to it. ## `latitude` (type: `number`): Optional. With longitude and radius, only places inside this circle are returned. ## `longitude` (type: `number`): Optional center of the circle (see latitude). ## `radiusMeters` (type: `integer`): Radius of the circle, 50 to 40,000. ## `maxItemsPerSearch` (type: `integer`): Stop each term and city after this many places. 0 means no limit besides Max Items. ## `sort` (type: `string`): Relevance is 2GIS's default ranking (advertisers first). Rating puts the best rated first. ## `hasWebsite` (type: `boolean`): Keep places that list a website. ## `hasPhotos` (type: `boolean`): Keep places that have photos. ## `hasReviews` (type: `boolean`): Keep places that have at least one review. ## `onlyRated` (type: `boolean`): Keep places that have a star rating. ## `openNow` (type: `boolean`): Keep places that are open at the moment of the run (local time of the city). ## `open24x7` (type: `boolean`): Keep places that are open around the clock. ## `minRating` (type: `number`): Keep places rated at least this much (0 to 5). Applied after the search. ## `minReviews` (type: `integer`): Keep places with at least this many reviews. Applied after the search. ## `onlyWithEmail` (type: `boolean`): Keep places that publish an email. Applied after the search. ## `onlyWithPhone` (type: `boolean`): Keep places that publish a phone number. Applied after the search. ## `onlyWithoutWebsite` (type: `boolean`): Keep places that list no website: prospects for web and marketing services. Applied after the search. ## `filterWifi` (type: `boolean`): Keep places whose listing shows Wi-Fi. Applied after the search, on the attributes of each listing. ## `filterCardPayment` (type: `boolean`): Keep places whose listing shows card payment. Applied after the search. ## `filterDelivery` (type: `boolean`): Keep places whose listing shows delivery. Applied after the search. ## `filterTakeaway` (type: `boolean`): Keep places whose listing shows takeaway. Applied after the search. ## `minAverageBill` (type: `number`): Keep places whose listed average bill is at least this amount, in the local currency. Places without a listed bill are dropped. Applied after the search. ## `maxAverageBill` (type: `number`): Keep places whose listed average bill is at most this amount (0 = no limit). Applied after the search. ## `createdWithinDays` (type: `integer`): Keep places added to 2GIS in the last N days: new openings. Only listings that show a creation date (about 4 in 10) can match. Applied after the search. ## `maxReviewsPerPlace` (type: `integer`): 0 turns reviews off. Free users: up to 10 per place. ## `reviewSort` (type: `string`): Newest first, last edited, or by trust score. ## `reviewSources` (type: `array`): Where the review was written. Empty means all sources. ## `reviewMinRating` (type: `integer`): Lowest star rating to keep (1 to 5). Use 1 to 2 to find complaints. ## `reviewMaxRating` (type: `integer`): Highest star rating to keep (1 to 5). ## `reviewsSince` (type: `string`): Only with newest-first order: stop at reviews older than this date (YYYY-MM-DD). ## `maxPhotosPerPlace` (type: `integer`): 0 turns the photo gallery off. Adds a photos list (1920 px image URLs, up to 10) to each place. ## `proxyConfiguration` (type: `object`): Residential is the reliable choice (datacenter addresses often stall). Turn the proxy off only when running from an address 2GIS accepts. ## Actor input object example ```json { "searchTerms": [ "кофейни" ], "maxItems": 10, "locations": [ "moscow" ], "countryCode": "none", "language": "auto", "radiusMeters": 1000, "maxItemsPerSearch": 0, "sort": "relevance", "hasWebsite": false, "hasPhotos": false, "hasReviews": false, "onlyRated": false, "openNow": false, "open24x7": false, "minRating": 0, "minReviews": 0, "onlyWithEmail": false, "onlyWithPhone": false, "onlyWithoutWebsite": false, "filterWifi": false, "filterCardPayment": false, "filterDelivery": false, "filterTakeaway": false, "minAverageBill": 0, "maxAverageBill": 0, "createdWithinDays": 0, "maxReviewsPerPlace": 0, "reviewSort": "date_created", "reviewMinRating": 1, "reviewMaxRating": 5, "maxPhotosPerPlace": 0, "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `overview` (type: `string`): Places with contacts and rating ## `fullData` (type: `string`): Complete dataset with all 69 place fields and 23 review fields # API You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup. ## JavaScript example ```javascript import { ApifyClient } from 'apify-client'; // Initialize the ApifyClient with your Apify API token // Replace the '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = { "searchTerms": [ "кофейни" ], "maxItems": 10, "locations": [ "moscow" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }; // Run the Actor and wait for it to finish const run = await client.actor("parseforge/2gis-places-scraper").call(input); // Fetch and print Actor results from the run's dataset (if any) console.log('Results from dataset'); console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`); const { items } = await client.dataset(run.defaultDatasetId).listItems(); items.forEach((item) => { console.dir(item); }); // 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs ``` ## Python example ```python from apify_client import ApifyClient # Initialize the ApifyClient with your Apify API token # Replace '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = { "searchTerms": ["кофейни"], "maxItems": 10, "locations": ["moscow"], "proxyConfiguration": { "useApifyProxy": True, "apifyProxyGroups": ["RESIDENTIAL"], }, } # Run the Actor and wait for it to finish run = client.actor("parseforge/2gis-places-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}") for item in client.dataset(run.default_dataset_id).iterate_items(): print(item) # 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{ "searchTerms": [ "кофейни" ], "maxItems": 10, "locations": [ "moscow" ], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } }' | apify call parseforge/2gis-places-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "type": "http", "url": "https://mcp.apify.com/?tools=fetch-actor-details,parseforge/2gis-places-scraper" } } } ``` The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer ` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations). ## OpenAPI specification Download the OpenAPI definition: https://api.apify.com/v2/actors/ffXaKrEbxN1libAfu/builds/APQrDRtSPgfNkRSre/openapi.json