2GIS Scraper & API — Extract Places, Phones, Emails | Парсер 2ГИС (2026)

2GIS scraper and API for extracting phone numbers, emails, and full business data. 1,000 places in 90 seconds. Covers 207 cities across Russia, Kazakhstan, UAE, Saudi Arabia, and 16 more countries. 14 languages. No browser, no login, no limits.

Парсер и API для 2ГИС — телефоны, email и полные данные организаций. 1000 мест за 90 секунд. 207 городов, 20 стран, 14 языков.

Try it free — new Apify users get $5 in platform credits. That's ~1,200 places at no cost.

1,000 places in under 90 seconds with 70+ fields per result — phones, emails, socials, reviews, photos, AI summaries, metro stations, attributes. The richest 2GIS output on Apify.

 

Related Scrapers ➤	2GIS Reviews	Apple Maps	Yandex Places	Google Directions

Copy to your AI assistant

Copy this block into ChatGPT, Claude, Cursor, or any LLM to start using this actor.

zen-studio/2gis-places-scraper-api on Apify. Call: ApifyClient("TOKEN").actor("zen-studio/2gis-places-scraper-api").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: query (array of search terms), location (string, city name), startUrls (array, direct 2GIS place/search URLs). Full actor spec (input schema with all params/enums/defaults, output dataset fields, README): fetch build via GET https://api.apify.com/v2/acts/zen-studio~2gis-places-scraper-api (Bearer TOKEN) → taggedBuilds.latest.buildId, then GET https://api.apify.com/v2/acts/zen-studio~2gis-places-scraper-api/builds/{buildId} → inputSchema, actorDefinition.storages.dataset, readme. Pricing: pay-per-event, $0.0045/place, $0.001/review, $0.0005/photo. Get token: https://console.apify.com/account/integrations

---

What You Get

Leads & contacts — phone numbers, email addresses, website URLs, and social media links (VK, Telegram, Instagram, WhatsApp) for every business. Filter by withoutWebsite to find businesses you can cold-pitch. Export straight to CSV for CRM import.

70+ fields per place — name, category, address, GPS, opening hours, rating, review count, AI sentiment summary, brand/chain info, badges (Michelin, hotel stars, price), 100+ rich attributes (menu items, payment methods, amenities), building info, nearest metro stations with walking distances.

Reviews (optional) — full text, author, rating, date, photos, business reply, source (2GIS / Flamp / Booking). 7 filter dimensions: sentiment, date range, keyword, topic, source, business reply.

Photos (optional) — high-res URLs from place gallery. 18 category filters: food, interior, exterior, menu, atmosphere, rooms, pool, spa, and more.

Key Capabilities

• 1,000 places in 90 seconds — no browser, pure API speed. Reviews and photos scale linearly
• Lead generation — extract phones, emails, and socials for thousands of businesses in minutes. Find businesses without websites for cold outreach
• 731 categories with fuzzy matching — type "dental" or "кофейни", it finds the right rubric
• Branch discovery — one query for "Шоколадница" in Moscow → all 227 branches with full data
• 20+ filters — rating, price range, delivery, WiFi, card payment, 24/7, photos, website presence
• 207 cities, 20 countries, 14 languages — Russia, Kazakhstan, UAE, Saudi Arabia, and beyond

---

startUrls — Direct URLs

The startUrls parameter accepts multiple formats. Mix and match in a single run:

Параметр startUrls принимает несколько форматов. Можно смешивать в одном запуске:

Format / Формат	Example / Пример
Place URL / Ссылка на место direct data extraction	https://2gis.ru/moscow/firm/70000001057394703
Search URL / Ссылка на поиск scrapes all results automatically	https://2gis.ru/moscow/search/рестораны
Search with filters / Поиск с фильтрами URL filters applied automatically	https://2gis.ru/moscow/search/кофейни/filters/rating_rating_perfect
Short link / Короткая ссылка go.2gis.com resolved automatically	https://go.2gis.com/Sg2sB
Numeric ID / Числовой ID if you already have the branch ID	70000001057394703

Copy a URL straight from the 2GIS address bar — all active filters are preserved. When URLs are provided, all fields except reviews, photos, and proxy are ignored. Скопируйте URL прямо из адресной строки 2ГИС — все активные фильтры сохранятся. Если указаны ссылки, все поля кроме отзывов, фото и прокси игнорируются.

---

Quick Start — Быстрый старт

Direct URLs — scrape specific places

{
    "startUrls": [
        "https://2gis.ru/moscow/firm/70000001057394703",
        "https://2gis.ru/spb/search/кофейни"
    ],
    "maxReviews": 50,
    "maxPhotos": 10
}

Search — find restaurants in Moscow

{
    "query": ["restaurant"],
    "location": "Moscow",
    "maxResults": 100
}

With filters — top-rated cafes with websites, card payment, WiFi

{
    "query": ["cafe"],
    "location": "Saint Petersburg",
    "maxResults": 500,
    "categoryFilter": ["cafes", "coffee shops"],
    "filterRating": "excellent",
    "filterWebsite": "withWebsite",
    "filterCardPayment": true,
    "filterWifi": true,
    "sortBy": "rating"
}

With reviews and photos

{
    "query": ["restaurant"],
    "location": "Almaty",
    "maxResults": 50,
    "maxReviews": 100,
    "reviewsRating": "negative",
    "reviewsStartDate": "2025-01-01",
    "maxPhotos": 20,
    "photoCategories": ["food_and_drinks", "interior"]
}

Lead generation — businesses without websites

{
    "query": ["dental clinics"],
    "location": "Kazan",
    "maxResults": 0,
    "filterWebsite": "withoutWebsite",
    "language": "ru"
}

Full configuration

{
    "query": ["кофейня", "coffee shop"],
    "location": "Moscow",
    "country": "RU",
    "language": "ru",
    "maxResults": 200,
    "categoryFilter": ["coffee shops", "cafes"],
    "filterRating": "pretty_good",
    "sortBy": "rating",
    "filterWebsite": "withWebsite",
    "skipClosedPlaces": true,
    "searchMatching": "only_includes",
    "filterHasPhotos": true,
    "filter24h": false,
    "filterNewPlaces": false,
    "filterDelivery": false,
    "filterTakeaway": true,
    "filterCardPayment": true,
    "filterWifi": true,
    "filterHasGoods": false,
    "filterAvgPriceMin": 300,
    "filterAvgPriceMax": 1500,
    "maxReviews": 50,
    "reviewsRating": "all",
    "reviewsWithAnswer": false,
    "reviewsStartDate": "2024-06-01",
    "reviewsTopic": "кофе",
    "reviewsFilterKeyword": "",
    "reviewsSource": "2gis",
    "maxPhotos": 10,
    "photoCategories": ["food_and_drinks", "interior", "outside"],
    "scrapeOrgBranches": false,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

---

Парсинг 2ГИС — поиск организаций, телефонов и email

Этот инструмент заменяет ручной сбор базы данных организаций из 2ГИС. Вместо покупки устаревших баз или использования десктопных парсеров, вы получаете актуальные данные напрямую: телефоны, email, сайты, соцсети, адреса, рейтинги и отзывы — всё в структурированном JSON, готовом для CRM-импорта или аналитики.

Поддерживается 207 городов в 20 странах: Россия (155 городов), Казахстан (19), Саудовская Аравия (14), ОАЭ, Узбекистан, Кыргызстан, Армения, Грузия, Азербайджан, Беларусь, Таджикистан, Бахрейн, Кувейт, Катар, Оман, Ирак, Чили, Чехия, Италия и Кипр.

---

Input Parameters — Входные параметры

Core — Основные

Parameter	Type	Description	Default
startUrls	array	2GIS place or search URLs, short links (go.2gis.com), or plain IDs. When provided, query and location are ignored	[]
query	array	Search queries — each runs as a separate search	["restaurant"]
location	string	City name (Russian or English) — 207 cities supported	"Moscow"
country	string	Country code to disambiguate city names (usually not needed)	Auto
language	string	Output language — 14 languages supported	Auto by region
maxResults	integer	Max places per query. 0 = unlimited	100

Filters — Фильтры

Parameter	Type	Description	Default
categoryFilter	array	Fuzzy-matched against 731 2GIS categories (RU/EN)	All
filterRating	string	Min rating: perfect 4.9+, excellent 4.5+, pretty_good 4.0+, nice 3.5+, not_bad 3.0+	All
sortBy	string	rating, opened_time (newest), name (A-Z)	Default
filterWebsite	string	withWebsite, withoutWebsite, or all	all
skipClosedPlaces	boolean	Skip permanently closed places	false
searchMatching	string	all, only_includes (name contains query), only_exact	all
filterHasPhotos	boolean	Only places with photos	false
filter24h	boolean	Only 24/7 places	false
filterNewPlaces	boolean	Only recently opened	false

Category-Specific Filters — Фильтры по категориям

Parameter	Type	Description	Default
filterDelivery	boolean	Has delivery service	false
filterTakeaway	boolean	Has takeaway/pickup	false
filterCardPayment	boolean	Accepts card payment	false
filterWifi	boolean	WiFi available	false
filterHasGoods	boolean	Has price list / goods on 2GIS	false
filterAvgPriceMin	integer	Min average check (local currency)	—
filterAvgPriceMax	integer	Max average check (local currency)	—

Reviews — Отзывы

Parameter	Type	Description	Default
maxReviews	integer	Max reviews per place. Empty = all, 0 = disabled	disabled
reviewsRating	string	all, positive (4-5 stars), negative (1-2 stars)	all
reviewsWithAnswer	boolean	Only reviews with business reply	false
reviewsStartDate	string	Only reviews after this date (YYYY-MM-DD)	—
reviewsTopic	string	Server-side topic filter (e.g., "сервис", "еда")	—
reviewsFilterKeyword	string	Client-side keyword search in review text	—
reviewsSource	string	all, 2gis, flamp, or booking	all

Photos — Фото

Parameter	Type	Description	Default
maxPhotos	integer	Max photos per place. Empty = all, 0 = disabled	disabled
photoCategories	array	Filter by category: food_and_drinks, interior, outside, menu, atmosphere, and 13 more	All

Organization — Организация

Parameter	Type	Description	Default
scrapeOrgBranches	boolean	Also scrape all branches of found organizations	false

System — Система

Parameter	Type	Description	Default
proxyConfiguration	object	Proxy settings	Apify Residential

---

Output Example — Пример выходных данных

Each place produces a structured JSON record. Here is a real example (abridged):

{
  "id": "70000001066421775_qx4fbwbc17d0dB8I3726AH6J2HI2ikdAzxo504839-B646J281J2J73278B-d8dd33G4G1A0768A86731996Auf8i3bdB9A8289676J7H0000117HHI2JHJIHG2I99",
  "name": "Bshushu Restaurant",
  "fullName": "Bshushu Restaurant, ресторан средиземноморской кухни",
  "extension": "ресторан средиземноморской кухни",
  "url": "https://2gis.ru/moscow/firm/70000001066421775_qx4fbwbc17d0dB8I3726AH6J2HI2ikdAzxo504839-B646J281J2J73278B-d8dd33G4G1A0768A86731996Auf8i3bdB9A8289676J7H0000117HHI2JHJIHG2I99",
  "categories": [
    "Рестораны"
  ],
  "categoryIds": [
    "164"
  ],
  "poiCategory": "food_restaurant",
  "rating": 4.7,
  "reviewCount": 94,
  "ratingCount": 136,
  "reviewProviders": [],
  "summary": "Авторская кухня с экзотическими блюдами: яйца пашот с щучьей икрой и мороженое из халвы. Посетители советуют попробовать обновляемое меню с неожиданными вкусовыми сочетаниями.",
  "description": "",
  "badges": [
    {
      "name": "Лучший ресторан 2025",
      "tag": "awards_awards2025_thebestrestaurants2025"
    },
    {
      "name": "Чек 1650 ₽",
      "tag": "food_service_avg_price"
    },
    {
      "name": "Средиземноморская кухня",
      "tag": "food_service_food_mediterranean"
    },
    {
      "name": "Доставка",
      "tag": "covid_homedelivery"
    }
  ],
  "address": "3-я улица Ямского Поля, 2 к3",
  "fullAddress": "Москва, 3-я улица Ямского Поля, 2 к3",
  "addressComment": "1 этаж",
  "postcode": "125124",
  "country": "Россия",
  "region": "Москва",
  "city": "Москва",
  "district": "Беговой",
  "street": "3-я улица Ямского Поля",
  "houseNumber": "2 к3",
  "latitude": 55.781846,
  "longitude": 37.581611,
  "timezoneOffset": 180,
  "mainPhotoUrl": "https://i3.photo.2gis.com/main/branch/32/70000001066421775/common",
  "photoCount": 137,
  "schedule": {
    "Fri": {
      "working_hours": [
        {
          "from": "10:00",
          "to": "24:00"
        }
      ]
    },
    "Mon": {
      "working_hours": [
        {
          "from": "10:00",
          "to": "24:00"
        }
      ]
    },
    "Sat": {
      "working_hours": [
        {
          "from": "10:00",
          "to": "24:00"
        }
      ]
    },
    "Sun": {
      "working_hours": [
        {
          "from": "10:00",
          "to": "24:00"
        }
      ]
    },
    "Thu": {
      "working_hours": [
        {
          "from": "10:00",
          "to": "24:00"
        }
      ]
    },
    "Tue": {
      "working_hours": [
        {
          "from": "10:00",
          "to": "24:00"
        }
      ]
    },
    "Wed": {
      "working_hours": [
        {
          "from": "10:00",
          "to": "24:00"
        }
      ]
    }
  },
  "isClosed": false,
  "nearestStations": [
    {
      "name": "Белорусская",
      "line": "D1 Белорусско-Савёловский диаметр",
      "color": "#ED9F2E",
      "distance": 700,
      "routeTypes": [
        "suburban_train",
        "aeroexpress",
        "mcd"
      ]
    },
    {
      "name": "Белорусская",
      "line": "Замоскворецкая линия",
      "color": "#3EA332",
      "distance": 750,
      "routeTypes": [
        "metro"
      ]
    },
    {
      "name": "Белорусская",
      "line": "Кольцевая линия",
      "color": "#912900",
      "distance": 900,
      "routeTypes": [
        "metro"
      ]
    }
  ],
  "phones": [
    "+79255650202"
  ],
  "phonesFormatted": [
    "+7‒925‒565‒02‒02"
  ],
  "emails": [
    "bshushu@yandex.ru"
  ],
  "website": "http://bshushu.moscow",
  "socials": {
    "whatsapp": [
      "https://wa.me/79255650202?text=%D0%97%D0%B4%D1%80%D0%B0%D0%B2%D1%81%D1%82%D0%B2%D1%83%D0%B9%D1%82%D0%B5!%0A%0A%D0%9F%D0%B8%D1%88%D1%83%20%D0%B8%D0%B7%20%D0%BF%D1%80%D0%B8%D0%BB%D0%BE%D0%B6%D0%B5%D0%BD%D0%B8%D1%8F%202%D0%93%D0%98%D0%A1.%0A%0A"
    ],
    "telegram": [
      "https://t.me/bshushu_moscow"
    ]
  },
  "orgName": "Bshushu Restaurant",
  "orgId": "70000001066421774",
  "orgBranchCount": 1,
  "orgRating": 4.7,
  "orgReviewCount": 94,
  "brand": "",
  "isPromoted": false,
  "hasGoods": true,
  "hasDiscount": false,
  "delivery": null,
  "replyRate": null,
  "floorCount": null,
  "yearBuilt": null,
  "buildingMaterial": "",
  "attributes": [
    "Лучший ресторан 2025",
    "Чек 1650 ₽",
    "Винный ресторан",
    "Средиземноморская кухня",
    "Завтрак",
    "Заказ столиков",
    "Заказ навынос",
    "Винная карта",
    "Столики на улице",
    "Проведение банкетов",
    "Можно с ноутбуком",
    "До 76 мест",
    "Можно с собакой",
    "Пицца",
    "Паста",
    "Картофель-фри",
    "Салаты",
    "Сэндвичи",
    "Супы",
    "Пицца на дровах",
    "На гриле",
    "Кофе с собой",
    "Глинтвейн",
    "Чай с собой",
    "Кофе по-турецки",
    "Доставка",
    "Wi-Fi для клиентов",
    "Оплата картой",
    "Наличный расчёт",
    "Перевод с карты",
    "Оплата по QR-коду"
  ],
  "attributeGroups": [
    {
      "name": "Премия 2ГИС",
      "iconUrl": "https://disk.2gis.com/rubricator/bar20bd6068bc164b6e75eb28eb560020d8.svg",
      "attributes": [
        {
          "name": "Лучший ресторан 2025",
          "tag": "awards_awards2025_thebestrestaurants2025"
        }
      ]
    },
    {
      "name": "Ресторан / Кафе",
      "iconUrl": "https://disk.2gis.com/rubricator/cafef99cdf22ed508f08db0d770943367ef0.svg",
      "attributes": [
        {
          "name": "Чек 1650 ₽",
          "tag": "food_service_avg_price"
        },
        {
          "name": "Винный ресторан",
          "tag": "food_service_bar_type_winerest"
        },
        {
          "name": "Средиземноморская кухня",
          "tag": "food_service_food_mediterranean"
        },
        {
          "name": "Завтрак",
          "tag": "food_service_details_food_breakfast"
        },
        {
          "name": "Заказ столиков",
          "tag": "food_service_details_food_table_reservation"
        },
        {
          "name": "Заказ навынос",
          "tag": "food_service_details_food_takeaway"
        },
        {
          "name": "Винная карта",
          "tag": "food_service_details_food_wine_list"
        },
        {
          "name": "Столики на улице",
          "tag": "food_service_infrastructure_outdoor_tables_eat_out"
        },
        {
          "name": "Проведение банкетов",
          "tag": "food_service_infrastructure_banquet"
        },
        {
          "name": "Можно с ноутбуком",
          "tag": "food_service_cafe_working"
        },
        {
          "name": "До 76 мест",
          "tag": "food_service_capacity"
        },
        {
          "name": "Можно с собакой",
          "tag": "food_service_dog_friendly_food"
        }
      ]
    },
    {
      "name": "Меню",
      "iconUrl": "https://disk.2gis.com/rubricator/cafef99cdf22ed508f08db0d770943367ef0.svg",
      "attributes": [
        {
          "name": "Пицца",
          "tag": "food_service_assortment_assortment_pizza"
        },
        {
          "name": "Паста",
          "tag": "food_service_assortment_assortment_pasta"
        },
        {
          "name": "Картофель-фри",
          "tag": "food_service_assortment_assortment_frenchfries"
        },
        {
          "name": "Салаты",
          "tag": "food_service_assortment_assortment_salads"
        },
        {
          "name": "Сэндвичи",
          "tag": "food_service_assortment_assortment_sandwich"
        },
        {
          "name": "Супы",
          "tag": "food_service_assortment_assortment_soups"
        },
        {
          "name": "Пицца на дровах",
          "tag": "food_service_assortment_assortment_firewood_pizza"
        },
        {
          "name": "На гриле",
          "tag": "food_service_assortment_assortment_grilled"
        }
      ]
    },
    {
      "name": "Напитки",
      "iconUrl": "https://disk.2gis.com/rubricator/cafef99cdf22ed508f08db0d770943367ef0.svg",
      "attributes": [
        {
          "name": "Кофе с собой",
          "tag": "cocktail_bars_types_coffee_take_away"
        },
        {
          "name": "Глинтвейн",
          "tag": "cocktail_bars_types_mulledwine"
        },
        {
          "name": "Чай с собой",
          "tag": "cocktail_bars_types_tea_take_away"
        },
        {
          "name": "Кофе по-турецки",
          "tag": "cocktail_bars_types_turkish_coffee"
        }
      ]
    },
    {
      "name": "Услуги",
      "iconUrl": "",
      "attributes": [
        {
          "name": "Доставка",
          "tag": "covid_homedelivery"
        }
      ]
    },
    {
      "name": "Дополнительно",
      "iconUrl": "",
      "attributes": [
        {
          "name": "Wi-Fi для клиентов",
          "tag": "additionally_services_wifi"
        }
      ]
    },
    {
      "name": "Способы оплаты",
      "iconUrl": "",
      "attributes": [
        {
          "name": "Оплата картой",
          "tag": "general_payment_type_card"
        },
        {
          "name": "Наличный расчёт",
          "tag": "general_payment_type_cash"
        },
        {
          "name": "Перевод с карты",
          "tag": "general_payment_type_transfercard"
        },
        {
          "name": "Оплата по QR-коду",
          "tag": "general_payment_type_qrcode"
        }
      ]
    }
  ],
  "createdAt": "2022-11-08T00:00:00Z",
  "updatedAt": "2025-11-24T14:26:14Z",
  "searchQuery": "restaurant",
  "scrapedAt": "2026-02-09T17:42:45.791504+00:00",
  "reviews": [
    {
      "reviewId": "211564346",
      "rating": 4,
      "text": "Еда вкусная, обслуживание отличное, на стол ставят воду, у раковины - крЭм. Всё на достаточно высоком уровне.\nПридерусь только к виду заведения: название не запомнишь, снаружи незаметно, внутри обшарпанные стены, бетонный пол, зона без окна, глубокие полки в спину упираются - место отнимают. Рядом и древний проём в стене с картинами, и индустриальные стеллажи, перегородка, кабель-каналы. Как-то это всё неуютно, на мой взгляд.",
      "dateCreated": "2026-01-12T03:27:52.766727+07:00",
      "dateEdited": "2026-01-12T04:23:47.276223+07:00",
      "authorName": "Константин Мороз",
      "authorId": "f56c4ac70e424603b47e696d6a01cb80",
      "authorPhotoUrl": "",
      "authorReviewsCount": 12,
      "likesCount": 0,
      "commentsCount": 0,
      "reactions": null,
      "provider": "2gis",
      "officialAnswer": {
        "text": "Уважаемый Гость, хочу поблагодарить Вас за выбор отеля Palace Bridge. Спасибо за обратную связь. Будем рады видеть вас снова.",
        "date": "2025-10-30T16:59:26.877935+07:00"
      },
      "photos": []
    },
    {
      "reviewId": "209896889",
      "rating": 4,
      "text": "Еда вкусная, скорость обслуживания средняя.",
      "dateCreated": "2026-01-03T09:17:45.896395+07:00",
      "dateEdited": "2026-01-05T01:58:53.55298+07:00",
      "authorName": "Дмитрий Пергунов",
      "authorId": "6dae1d4afbeb40f6885956f7e4ec5b31",
      "authorPhotoUrl": "https://i5.photo.2gis.com/images/profile/12345_640x.jpg",
      "authorReviewsCount": 8,
      "likesCount": 0,
      "commentsCount": 0,
      "reactions": {"fire": 2},
      "provider": "2gis",
      "officialAnswer": null,
      "photos": []
    }
    // can scrape all reviews
  ]
}

---

Pricing — Pay Per Event (PPE) — Тарифы

Transparent per-event pricing. You only pay for what you extract.

Events

Event	What triggers it	Free tier	Bronze	Silver	Gold
place_scraped	Each place extracted with full data	$4.50 / 1,000	$3.80 / 1,000	$3.20 / 1,000	$2.70 / 1,000
review_scraped	Each individual review extracted	$1.00 / 1,000	$0.80 / 1,000	$0.65 / 1,000	$0.50 / 1,000
photos_scraped	Each place with photos extracted	$0.50 / 1,000	$0.30 / 1,000	$0.15 / 1,000	$0.10 / 1,000

Cost Calculator — Калькулятор стоимости

Lead generation — 1,000 businesses with contacts:

What	Count	Cost
Places	1,000	$4.50
Total		$4.50

Market research — 500 restaurants with 50 reviews each:

What	Count	Cost
Places	500	$2.25
Reviews	25,000	$25.00
Total		$27.25

Reputation monitoring — 100 competitors, 20 reviews + photos:

What	Count	Cost
Places	100	$0.45
Reviews	2,000	$2.00
Photos	100 places	$0.05
Total		$2.50

Full city extraction — 10,000 places, no enrichment:

What	Count	Cost
Places	10,000	$45.00
Total		$45.00

---

How to Scrape 2GIS Data in Python — Парсинг 2ГИС на Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("zen-studio/2gis-places-scraper-api").call(run_input={
    "query": ["restaurant"],
    "location": "Moscow",
    "maxResults": 100,
    "filterRating": "excellent",
    "maxReviews": 10,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['name']} — {item['rating']}★ — {item['phones']}")

How to Scrape 2GIS Data in JavaScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_API_TOKEN' });

const run = await client.actor('zen-studio/2gis-places-scraper-api').call({
    query: ['restaurant'],
    location: 'Moscow',
    maxResults: 100,
    filterRating: 'excellent',
    maxReviews: 10,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach(item => {
    console.log(`${item.name} — ${item.rating}★ — ${item.phones}`);
});

---

Advanced Examples — Продвинутые сценарии

Extract all dental clinics in Almaty, Kazakhstan

{
    "query": ["стоматология"],
    "location": "Almaty",
    "country": "KZ",
    "language": "ru",
    "maxResults": 0,
    "categoryFilter": ["dental clinics"],
    "filterRating": "pretty_good"
}

Collect negative reviews for competitor analysis

{
    "query": ["Додо Пицца"],
    "location": "Novosibirsk",
    "maxResults": 50,
    "maxReviews": 200,
    "reviewsRating": "negative",
    "reviewsStartDate": "2025-06-01"
}

Find businesses without websites for cold outreach

{
    "query": ["автосервис"],
    "location": "Krasnodar",
    "maxResults": 0,
    "filterWebsite": "withoutWebsite",
    "skipClosedPlaces": true
}

Scrape entire restaurant chain with all branches

{
    "query": ["Якитория"],
    "location": "Moscow",
    "maxResults": 5,
    "scrapeOrgBranches": true,
    "maxReviews": 20,
    "maxPhotos": 5,
    "photoCategories": ["food_and_drinks", "interior"]
}

Dubai restaurants with delivery, sorted by rating

{
    "query": ["restaurant"],
    "location": "Dubai",
    "country": "AE",
    "language": "en",
    "maxResults": 500,
    "filterDelivery": true,
    "filterRating": "excellent",
    "sortBy": "rating",
    "filterAvgPriceMin": 50,
    "filterAvgPriceMax": 300
}

---

Supported Cities — Поддерживаемые города (207 городов, 20 стран)

Россия (155 городов) — Москва, Санкт-Петербург, Новосибирск, Екатеринбург, Казань, Нижний Новгород, Челябинск, Самара, Ростов-на-Дону, Уфа, Красноярск, Воронеж, Пермь, Волгоград, Краснодар, Тюмень, Иркутск, Омск, Томск, Сочи, and 135 more.

Казахстан (19) — Almaty, Astana, Shymkent, Karaganda, Aktobe, and more.

Саудовская Аравия (14) — Riyadh, Jeddah, Dammam, Medina, and more.

ОАЭ — Dubai, Abu Dhabi, Sharjah. Узбекистан — Tashkent, Samarkand, Bukhara. Кыргызстан — Bishkek. Армения — Yerevan. Грузия — Tbilisi, Batumi. Азербайджан — Baku. Беларусь — Minsk. Таджикистан — Dushanbe. Бахрейн — Manama. Кувейт — Kuwait City. Катар — Doha. Оман — Muscat. Ирак — Basra. Чили — Santiago. Чехия — Prague. Италия — Padua. Кипр — Cyprus.

---

14 Supported Languages — Поддерживаемые языки

Русский, English, العربية (Arabic), Қазақша (Kazakh), O'zbek (Uzbek), Кыргызча (Kyrgyz), Հայերեն (Armenian), ქართული (Georgian), Azərbaycan, Тоҷикӣ (Tajik), Čeština (Czech), Español (Spanish), Italiano (Italian) — or auto-detect by region.

---

Data Export — Экспорт данных

Export results in any format directly from the Apify platform:

• JSON — structured data for programmatic use, API integrations, and databases
• CSV — flat tables for Excel, Google Sheets, CRM import
• Excel (.xlsx) — ready for reporting and visualization
• XML — for legacy system integrations

---

Proxy Configuration — Настройка прокси

Residential proxies are recommended for stable extraction. The default configuration works out of the box:

{
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

Custom proxies:

{
    "proxyConfiguration": {
        "useApifyProxy": false,
        "proxyUrls": ["http://user:pass@proxy.example.com:8000"]
    }
}

---

FAQ — Часто задаваемые вопросы

Q: How many places can I scrape? / Сколько мест можно собрать? A: Set maxResults to 0 for unlimited extraction per query. 2GIS returns up to ~3,000 results per query depending on the city and search term. Use multiple queries to broaden coverage.

Q: Do I need a 2GIS account or browser? / Нужен ли аккаунт или браузер? A: No. No login, no cookies, no browser. Direct API access, works immediately. | Нет. Прямой доступ к API, без браузера.

Q: How fast is it? A: ~1,000 places in 90 seconds. No browser overhead. Reviews and photos scale linearly with the amount requested.

Q: How do category filters work? A: Fuzzy-matches your input (Russian or English) against all 731 2GIS rubrics. "dental" → "Стоматологические клиники", "coffee" → "Кофейни".

Q: Does it work for Dubai and Saudi Arabia? / هل يعمل في دبي والسعودية؟ A: Yes. Full support for UAE (Dubai, Abu Dhabi, Sharjah), Saudi Arabia (14 cities), and all Gulf states.

Q: Как собрать базу телефонов и email? A: Запустите с нужным запросом и городом. Телефоны, email, сайты и соцсети извлекаются автоматически. Экспортируйте в CSV для CRM.

Q: Need just reviews in flat format for Excel? / Нужны только отзывы? A: Use /zen-studio/2gis-reviews-scraper — one review = one row, 7 filters, CSV export. | Один отзыв = одна строка, 7 фильтров.

Q: Looking for jobs or real estate? A: /zen-studio/2gis-jobs-scraper — vacancies with salary, company, apply links. /zen-studio/2gis-property-scraper — sale & rent listings with 12 filters.

---

Getting Started — Начало работы

1. Create an Apify account

Sign up free — new users get $5 in platform credits.

2. Configure your search

Set your search query, city, and filters. Start with a small maxResults (10-50) to preview the data structure.

3. Run and export

Start the scraper, wait for results, download in JSON/CSV/Excel. Or use the API to automate everything.

4. Scale up

Schedule recurring runs, connect webhooks, pipe data into your CRM or analytics tools. Use the Apify API for full programmatic control.

---

Disclaimer

Data is collected from publicly available sources and provided "as is" for informational purposes. Users are responsible for compliance with 2GIS' terms of service and applicable regulations in their jurisdiction.

---

Start Scraping 2GIS Now — Начать парсинг 2ГИС

---

Structured data from the largest business directory in Russia, CIS, and the Middle East — extracted in minutes, not days.