2GIS Business Directory Extractor for CIS & Middle East

Scrape 2GIS business listings across 14 country sites — Russia, Kazakhstan, the UAE, Kyrgyzstan, Uzbekistan, Belarus, Azerbaijan, Armenia, Georgia, Tajikistan, Cyprus, Czechia, Italy and Chile. Search by keyword and city or map area, or paste search, place, organization and building links. Records include the address and coordinates, categories, rating and review counts when published, opening hours, contacts, social links and published attributes, plus a main photo when 2GIS exposes one. No account, API key or proxy is needed.

What this actor does

• Three modes: search by keyword + city/area, read 2GIS links, or look up place IDs.
• Rich place data: phones, websites, emails, social links, messengers, hours, rating, review counts, attributes, nearest transit and a main photo.
• Organization and branch discovery: expand an organization to its branches, or read every business inside a building.
• Real filters: open now, 24/7, has a website, has photos, has goods/menu, has a rating or reviews, plus rating/review thresholds and category filters.
• Optional enrichment: review texts with rating, author, date and business replies; photo URLs.
• Clean output: every empty field is omitted, so records contain no nulls or placeholder values.

Output per place

• id — 2GIS branch ID
• name, fullName, shortName, extension, type, recordType
• url — the place page on the correct 2GIS country site
• categories, categoryIds, rubrics[], primaryCategory
• address, addressComment, postcode, street, houseNumber, landmark
• country, region, city, addressCity, district, districtArea, cityAlias
• latitude, longitude, timezoneOffset
• phones, phonesFormatted, website, websites, emails, socialLinks, messengers
• rating, reviewCount, ratingCount, orgRating, orgReviewCount, ratingCategory, reviewProviders[]
• workingHours[], scheduleText, is24x7, isClosed
• orgId, orgName, orgBranchCount, brand
• attributes[], attributeGroups[], attributesByTag
• photoCount (when 2GIS returns it), mainPhotoUrl, photos[] (when photo URLs are enabled)
• reviews[] — review text, rating, author, date, photos and business reply (when enabled)
• isPromoted, hasGoods, hasDiscount, delivery
• nearestStations[], nearestMetro[]
• searchQuery, searchCity, scrapedAt, updatedAt, createdAt, description

Input

Field	Type	Default	Description
mode	string	search	search, urls or ids
searchQueries	array	–	Search terms (mode=search)
locationQuery	string	–	City to search in (mode=search)
cities	array	–	Additional cities; every term runs in each city
cityIds	array	–	Exact 2GIS city IDs instead of names
startUrls	array	–	Search, /firm/, /branches/, /inside/ or short links (mode=urls)
placeIds	array	–	Branch IDs (mode=ids)
latitude, longitude	number	–	Center for a point search
radiusMeters	integer	20000	Radius around the point (1–50000)
bbox	string	–	Map rectangle as lon1,lat1,lon2,lat2
country	string	auto	Country site: ru, kz, ae, kg, uz, by, az, am, ge, tj, cy, cz, it, cl
language	string	auto	Content language, e.g. ru_RU, ru_KZ, en_AE, kk_KZ
maxItems	integer	50	Max places per search term + city/area
sortBy	string	relevance	relevance, rating, distance, flamp_rating, creation_time, opened_time, name
rubricIds	array	–	Category IDs, e.g. 162 for coffee shops
districtIds	array	–	District IDs for splitting large cities
minRating	number	–	Keep places rated at least this value
minReviews	integer	–	Keep places with at least this many reviews
websiteFilter	string	all	all, with or without a website
filterHasPhotos	boolean	false	Only places with photos
filterOpenNow	boolean	false	Only places open now
filter24x7	boolean	false	Only places open around the clock
filterHasGoods	boolean	false	Only places with goods or a menu
filterHasRating	boolean	false	Only places with a rating
filterHasReviews	boolean	false	Only places with reviews
filterDelivery	boolean	false	Only places whose attributes mention delivery
filterTakeaway	boolean	false	Only places whose attributes mention takeaway
filterCardPayment	boolean	false	Only places whose attributes mention card payment
filterWifi	boolean	false	Only places whose attributes mention Wi-Fi
minAverageCheck, maxAverageCheck	integer	–	Filter by published average check
skipAds	boolean	false	Drop promoted results
includeContacts	boolean	true	Add phones, websites, emails, socials and messengers
includeReviews	boolean	false	Add review texts
maxReviewsPerPlace	integer	10	Max review texts per place
reviewsSort	string	date_created	date_created, date_edited or rating
reviewsMinRating	integer	–	Keep reviews with at least this rating
reviewsWithAnswer	boolean	false	Keep only reviews with a business reply
reviewsSince	string	–	Keep reviews since YYYY-MM-DD
reviewsKeyword	string	–	Keep reviews containing this word
includePhotos	boolean	false	Add photo URLs
maxPhotosPerPlace	integer	5	Max photo URLs per place
scrapeOrgBranches	boolean	false	Expand a place link to its organization's branches

Example: coffee shops in Moscow

{
  "mode": "search",
  "searchQueries": ["coffee"],
  "locationQuery": "Moscow",
  "maxItems": 25,
  "websiteFilter": "with",
  "sortBy": "rating"
}

Example: Dubai restaurants that are open now

{
  "mode": "search",
  "searchQueries": ["restaurant"],
  "locationQuery": "Dubai",
  "filterOpenNow": true,
  "includeContacts": true,
  "maxItems": 50
}

Example: read a place and its organization's branches

{
  "mode": "urls",
  "startUrls": ["https://2gis.ru/moscow/firm/70000001044357973"],
  "scrapeOrgBranches": true,
  "includeReviews": true,
  "maxReviewsPerPlace": 5
}

Example: every business inside a building

{
  "mode": "urls",
  "startUrls": ["https://2gis.ru/moscow/inside/4504235290707169"],
  "maxItems": 100
}

Use cases

• Local lead generation — collect businesses by city and category with phone, website and email contacts.
• Market research — compare category coverage, ratings and review volumes across cities and countries.
• Competitor tracking — follow a chain's branches, addresses, hours and rating changes.
• Reputation monitoring — export ratings, review counts and optional review texts with business replies.
• Directory enrichment — fill missing contacts, coordinates and opening hours in your own listings.
• Coverage checks — find businesses without a website, without photos or without reviews.

FAQ

Do I need a 2GIS account or API key?

No. The actor reads 2GIS's public directory data and needs no account, API key, cookie or proxy. Just choose a search term and a city.

Which countries are supported?

Russia, Kazakhstan, the UAE, Kyrgyzstan, Uzbekistan, Belarus, Azerbaijan, Armenia, Georgia, Tajikistan, Cyprus, Czechia, Italy and Chile. The country site is detected automatically from a link or resolved from the city.

Why are some fields missing from a place?

2GIS listings vary. A website, email, social link, photo or review is only included when the business has published it. Empty fields are omitted rather than filled with null or placeholder values.

What is the difference between rating and orgRating?

rating belongs to the individual branch. orgRating and orgReviewCount aggregate the whole organization. ratingCount counts star votes, while reviewCount counts written reviews.

Do reviews and photos work for every place?

Rating and review counts are included whenever 2GIS publishes them. Review texts and photo URLs are optional and depend on what 2GIS exposes for that place. A main photo URL and an exact photo count are included when 2GIS returns them; places with no reviews or photos simply omit those fields.

How do I get more than the default number of places?

Raise maxItems. For very large categories, split the search by district, category (rubricIds) or several narrower search terms. The run status message tells you if more places were available than were requested.

How do I search in Russian, Kazakh or Arabic?

Use the local spelling in searchQueries and locationQuery (for example кофейня and Москва), or set language to the content language you want.

Is this affiliated with 2GIS?

No. This is a third-party actor that reads the public 2GIS directory. It is not affiliated with, endorsed by, or sponsored by 2GIS.