2GIS: scrapers and the official API, compared

Business directory listings, addresses, phones, websites, ratings, hours and coordinates from 2GIS cities.

Short answer

For most 2GIS jobs, start with 2GIS Business Directory Extractor for CIS & Middle East: it covers 8 of 8 core fields (name, address, phones, website and 4 more) at $0.99 per 1,000 results on Apify's Free plan. The top published score for 2GIS goes to 2GIS Scraper by dami_studio (94 of 100), a Store tool from another publisher, listed for reference.

From published Store listings, output schemas and the official documentation. Checked 2026-10-27. How the ranking works.

2GIS Business Directory Extractor for CIS & Middle East: inputs, code and costOpen in Apify Store

1 catalogue Actor 8 other Store tools Official API: Public API Lowest rate  $0.50 per 1K

Route map

Each line is one way to get 2GIS data; each stop is a field you probably need. Green lines are catalogue Actors, ranked by the published formula.

Route diagram for 2GIS data2GIS Business Directory Extractor for CIS & Middle East: stops at 6 of the 10 fields shown; Other Store tools (8): stops at 10 of the 10 fields shown; 2GIS Places API: public, field coverage not compared.2GISnameaddressphoneswebsiteratingreviewplaceIdplaceNameplaceUrlrubrics1+API

Stops are fields. A ring means the field is in that route's published output schema; no ring means the line passes without it. Bold labels are the core fields for this website, the rest are fields that differ between routes. A white capsule means every data line stops there. The red line is the official API; its field coverage is not compared. A crossed red line means there is no open official API.

Catalogue Actors for 2GIS

2GIS Business Directory Extractor for CIS & Middle East

Search 2GIS for businesses by category and city across Russia, the UAE, Kazakhstan and the wider CIS, and get name, address, rating, hours,…

8/8 core fields 66 output fields $0.99 per 1K Open in Apify Store

Field matrix: who returns what

Every tool with a published output schema, against the 8 fields most 2GIS jobs need. A dot means the field name appears in the schema; rows can still leave it empty.

Which tools return each core 2GIS field, from published output schemas
ToolnameaddressphoneswebsiteratingreviewlatitudelongitudeFields
2GIS Business Directory Extractor for CIS & Middle East●●●●●●●●8/8
2GIS ScraperReference only, by dami_studio●●●●●–●●7/8
2gis Places ScraperReference only, by m_mamaev●●●●●●●●8/8
2GIS Reviews Scraper (2026)Reference only, by zen-studio●●––●–●●5/8
2GIS Places ScraperReference only, by themineworks●●●●●–––5/8
2GIS Scraper (Phones, Emails, Reviews)Reference only, by zen-studio●●●●●●●●8/8
2GIS Reviews ScraperReference only, by dami_studio●●––●–––3/8
2GIS ScraperReference only, by piotrv1001●●●●●–––5/8
2GIS Places ScraperReference only, by bovi●●●●●–––5/8
Tools returning it99779355

Field dictionary: the exact keys

The same core field has a different key in each Actor's output. Map these before you merge datasets; a dash means the published schema has no matching key. Need a field that is not listed here, such as email? Search every 2GIS Actor by field.

Output keys for each core 2GIS field in the top catalogue Actors
Core field 2GIS Business Directory…
name name, fullName, shortName
address address, street
phones phones, phonesFormatted
website website, websites
rating rating, orgRating
review reviews
latitude latitude
longitude longitude

All 9 tools, scored

Catalogue Actors link to their detail pages; the score (0 to 100) is the published formula, identical for every tool. Other Store tools follow in their own table, for reference. Price is the published primary-result rate per 1,000 (the Free-plan rate where the price is tiered; higher Apify plans pay less); start events and platform usage are excluded.

Catalogue Actors for 2GIS, ranked by the published method
Sample fields
85 name, address, phones 66 $0.99 16 runs, too few to rate Oct 2026

Other Store tools, for reference

Scored with the same published formula and listed for comparison only; this site does not link or recommend them.

Other Store tools for 2GIS, for reference
Sample fields
94
2GIS Scraper Reference only, by dami_studio
name, addressFull, phone 45 $0.50 99% of 3,608 runs Nov 2026
87
2gis Places Scraper Reference only, by m_mamaev
title, street, phoneText 49 $3.00 97% of 4,526 runs Oct 2026
85
2GIS Reviews Scraper (2026) Reference only, by zen-studio
placeName, placeAddress, placeRating 63 $1.00 99% of 4,440 runs Nov 2026
84
2GIS Places Scraper Reference only, by themineworks
name, address, phone 10 $0.50 99% of 75 runs Nov 2026
79
2GIS Scraper (Phones, Emails, Reviews) Reference only, by zen-studio
name, address, phones 120 $4.50 94% of 1,397 runs Nov 2026
78
2GIS Reviews Scraper Reference only, by dami_studio
placeName, placeAddress, rating 14 $0.50 100% of 673 runs Nov 2026
78
2GIS Scraper Reference only, by piotrv1001
name, address, phones 11 $1.80 85% of 298 runs Nov 2026
74
2GIS Places Scraper Reference only, by bovi
name, address, phones 12 $2.90 100% of 78 runs Nov 2026

Official API route

2GIS Places API

The 2GIS Places API searches organizations, buildings, landmarks and other objects by name, category, address, coordinates and more. Keys are created in the 2GIS Platform Manager as a demo key or a paid subscription.

Price. Monthly packages priced in Russian rubles: from 6,700 RUB for 10,000 billing units up to 250,000 RUB for 5,000,000 units; annual subscriptions get 10% off. A successful request counts as a billing unit.

Limits. Demo keys allow 1,000 successful Places API requests in total. Subscriptions are rate limited to 600 units per minute for the Places API.

Official documentation Official pricing

The 2GIS licence agreement prohibits automated requests to collect data and extracting its databases; public business data only. This is general information, not legal advice.

Read 2GIS' terms. Keep to public data, do not bypass logins or access controls, and check whether personal data is involved before you collect it. The can-I-scrape checklist walks through it.

How to start

  1. Open 2GIS Business Directory Extractor for CIS & Middle East and start from its default input; its Actor page has the full example input and code.
  2. Set the 2GIS search, profile, listing or URL you need and a result limit; the required input is mode.
  3. Run it and export the dataset as JSON, CSV or Excel, or call it from the Apify API.

Call 2GIS Business Directory Extractor for CIS & Middle East from code

The example input uses the Actor's published defaults; set your own 2GIS query before you run it. You need an Apify API token.

Python

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run_input = {
    "mode": "search",
    "searchQueries": [
        "coffee"
    ],
    "locationQuery": "Moscow",
    "radiusMeters": 20000,
    "country": "auto",
    "language": "auto",
    "maxItems": 3,
    "sortBy": "relevance",
    "websiteFilter": "all",
    "filterHasPhotos": False,
    "filterOpenNow": False,
    "filter24x7": False,
    "filterHasGoods": False,
    "filterHasRating": False,
    "filterHasReviews": False,
    "filterDelivery": False,
    "filterTakeaway": False,
    "filterCardPayment": False,
    "filterWifi": False,
    "skipAds": False,
    "includeContacts": True,
    "includeReviews": False,
    "maxReviewsPerPlace": 10,
    "reviewsSort": "date_created",
    "reviewsWithAnswer": False,
    "includePhotos": False,
    "maxPhotosPerPlace": 5,
    "scrapeOrgBranches": False
}

run = client.actor("vexaloom-labs/2gis-business-directory-extractor-for-cis").call(run_input=run_input)
if run is None:
    raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

pip install apify-client

JavaScript

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
    "mode": "search",
    "searchQueries": [
        "coffee"
    ],
    "locationQuery": "Moscow",
    "radiusMeters": 20000,
    "country": "auto",
    "language": "auto",
    "maxItems": 3,
    "sortBy": "relevance",
    "websiteFilter": "all",
    "filterHasPhotos": false,
    "filterOpenNow": false,
    "filter24x7": false,
    "filterHasGoods": false,
    "filterHasRating": false,
    "filterHasReviews": false,
    "filterDelivery": false,
    "filterTakeaway": false,
    "filterCardPayment": false,
    "filterWifi": false,
    "skipAds": false,
    "includeContacts": true,
    "includeReviews": false,
    "maxReviewsPerPlace": 10,
    "reviewsSort": "date_created",
    "reviewsWithAnswer": false,
    "includePhotos": false,
    "maxPhotosPerPlace": 5,
    "scrapeOrgBranches": false
};

const run = await client.actor("vexaloom-labs/2gis-business-directory-extractor-for-cis").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

npm install apify-client

cURL

curl -X POST "https://api.apify.com/v2/actors/vexaloom-labs~2gis-business-directory-extractor-for-cis/run-sync-get-dataset-items"   -H "Authorization: Bearer $APIFY_TOKEN"   -H "Content-Type: application/json"   -d '{"mode":"search","searchQueries":["coffee"],"locationQuery":"Moscow","radiusMeters":20000,"country":"auto","language":"auto","maxItems":3,"sortBy":"relevance","websiteFilter":"all","filterHasPhotos":false,"filterOpenNow":false,"filter24x7":false,"filterHasGoods":false,"filterHasRating":false,"filterHasReviews":false,"filterDelivery":false,"filterTakeaway":false,"filterCardPayment":false,"filterWifi":false,"skipAds":false,"includeContacts":true,"includeReviews":false,"maxReviewsPerPlace":10,"reviewsSort":"date_created","reviewsWithAnswer":false,"includePhotos":false,"maxPhotosPerPlace":5,"scrapeOrgBranches":false}'

Waits for the run and returns the dataset items (runs over 300 seconds return HTTP 408; start an async run instead).

MCP (AI agents)

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=vexaloom-labs/2gis-business-directory-extractor-for-cis",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

Adds this Actor as a tool in an MCP client that takes a remote server URL (Cursor, VS Code, Claude Code) through Apify's hosted MCP server. OAuth sign-in also works without the header. Clients that only start local servers can wrap the URL with npx mcp-remote.

Questions people ask

What is the cheapest catalogue Actor for 2GIS data?

2GIS Business Directory Extractor for CIS & Middle East lists $0.99 per 1,000 results (pay per event), with 66 fields in its published output schema. Start events and platform usage are billed separately. Checked 2026-10-27.

Which 2GIS scraper returns the most core fields?

2GIS Business Directory Extractor for CIS & Middle East covers 8 of the 8 core 2GIS fields this page tracks (name, address, phones, website, rating, review, latitude, longitude), based on its published output schema.

Does 2GIS have an official API?

Public API: The 2GIS Places API searches organizations, buildings, landmarks and other objects by name, category, address, coordinates and more. Keys are created in the 2GIS Platform Manager as a demo key or a paid subscription. Monthly packages priced in Russian rubles: from 6,700 RUB for 10,000 billing units up to 250,000 RUB for 5,000,000 units; annual subscriptions get 10% off. A successful request counts as a billing unit.

Is it legal to scrape 2GIS?

It depends on what you collect and how. The 2GIS licence agreement prohibits automated requests to collect data and extracting its databases; public business data only. Read 2GIS' terms (https://law.2gis.ru/licensing-agreement) before you collect, and check whether personal data is involved. This is general information, not legal advice.

More on 2GIS

Sources

Data checked 2026-10-27
Cite this page

Scraper Finder. "How to get 2GIS data." https://scraperfinder.com/sites/2gis/ (data checked 2026-10-27).

Highest-scoring catalogue Actor

2GIS Business Directory Extractor for CIS & Middle East: 8 of 8 core fields, $0.99 per 1,000 results, score 85. The highest score overall is 94 (2GIS Scraper, a Store tool from another publisher); both are in the table above.

Open in Apify Store