# 2GIS Business Scraper: Phones, Websites, Ratings | $1/1K (`one_dollar_store/2gis-business-scraper`) Actor

$1 per 1,000 results, platform usage included. Search 2GIS by keyword and city: name, categories, address, coordinates, phones, website, email, social links, rating, reviews and opening hours. Russia, Kazakhstan, Uzbekistan, UAE and other 2GIS cities.

- **URL**: https://apify.com/one_dollar_store/2gis-business-scraper.md
- **Developed by:** [One Dollar Store](https://apify.com/one_dollar_store) (community)
- **Categories:** Lead generation, Business
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 results

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

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

## 2GIS Business Scraper: Phones, Websites and Ratings by City

**$1 per 1,000 businesses. Platform usage included. No rental, no minimum.**

[Open it in Apify Console](https://console.apify.com/actors/byMcqG1n2Yoe8fEvm/input)

### What it costs

| Businesses | This actor |
|---|---|
| 1,000 | $1.00 |
| 10,000 | $10.00 |
| 100,000 | $100.00 |

One flat price, platform usage included, so there is no separate compute or proxy bill. Plus $0.001 per run. Pulling 2,000 businesses once a week costs $2.001 per run, about $8.70 a month. Set `maxItems` or a spending limit on the run; the actor stops cleanly when it is reached.

### Why use it

- **Contacts in one row:** phones, website, email, and messenger and social links such as Telegram, WhatsApp and VK when the business lists them.
- **Ready for maps and lead lists:** address, district, coordinates, rating, review count, weekly opening hours and the number of outlets in a chain.
- **Russia, Kazakhstan, Uzbekistan, Kyrgyzstan, the UAE** and other 2GIS countries, by local or English city name.
- **Quick.** In our tests 60 businesses in Almaty took about 14 seconds.

### Quick start

1. Open the actor, type a search term and a city, press **Start**.
2. Or paste this input:

```json
{ "queries": ["кофейня"], "city": "Almaty", "maxItems": 60 }
```

3. Download the results as JSON, CSV or Excel, or read them through the API.

### Use it from code

```bash
curl -X POST "https://api.apify.com/v2/acts/one_dollar_store~2gis-business-scraper/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"queries": ["dentist"], "city": "Dubai", "maxItems": 20}'
```

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")
run = client.actor("one_dollar_store/2gis-business-scraper").call(
    run_input={"queries": ["стоматология"], "city": "Новосибирск", "maxItems": 30}
)
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item["name"], item.get("phone"), item.get("rating"), item["url"])
```

### Use it from an AI assistant

Claude, ChatGPT, Cursor and other assistants can call this actor through Apify's MCP server. Add it with this server address:

```
https://mcp.apify.com?tools=one_dollar_store/2gis-business-scraper
```

Then ask, for example: "Find 50 coffee shops in Almaty on 2GIS with their phone numbers and ratings."

### Switching from another 2GIS actor

Most 2GIS actors take search terms, a city and a result limit. Here they are `queries` (a list), `city` and `maxItems`. The core fields are `name`, `address`, `phone`, `website`, `rating`, `reviewCount`, `latitude`, `longitude` and `url`.

### Input

| Field | Type | Default | What it does |
|---|---|---|---|
| `queries` | list of text | required | Business types or names, for example `кафе` or `car service`. |
| `city` | text | `Москва` | A city 2GIS covers, in local spelling or English, for example `Новосибирск`, `Almaty`, `Ташкент`, `Dubai`. A numeric 2GIS region id also works. |
| `maxItems` | number | 100 | The run stops after this many businesses in total, across all searches. Minimum 10. |
| `proxyConfiguration` | proxy | Apify datacenter | Proxy for the requests to 2GIS. Its cost is included. |

### Output fields

`id`, `name`, `fullName`, `legalForm`, `category`, `categories`, `address`, `addressComment`, `postcode`, `district`, `city`, `region`, `country`, `latitude`, `longitude`, `phone` (usually international format), `phoneFormatted`, `phones`, `website`, `websites`, `email`, `emails`, `socialLinks` (telegram, whatsapp, viber, max, vkontakte, instagram, facebook, youtube and others when listed), `rating`, `reviewCount`, `openingHours`, `branchCount` (outlets in the same chain), `orgName`, `url` (the 2GIS card), `searchQuery`, `searchCity`, `scrapedAt`.

`phones`, `websites` and `emails` appear only when a business lists more than one. Fields a business does not list are left out of its row.

### Sample results

Real rows from test runs on 4 October 2026, shortened to the main fields.

```json
[
  {"name": "Qulpynai, сеть пекарен-кондитерских", "category": "Кофейни",
   "address": "улица Толе би, 75", "district": "Алмалинский район", "city": "Алматы", "country": "Казахстан",
   "latitude": 43.254519, "longitude": 76.934184, "phone": "+77471111818", "website": "http://qulpynai.kz",
   "email": "info@qulpynai.kz", "socialLinks": {"instagram": "https://instagram.com/qulpynai_bakery"},
   "rating": 4.9, "reviewCount": 2840, "openingHours": "Mon 07:30-22:00; ...", "url": "https://2gis.kz/firm/70000001048534082"},
  {"name": "Coffee BOOM, сеть кофеен", "category": "Кофейни", "address": "улица Гоголя, 58",
   "city": "Алматы", "phone": "+77079906965", "phones": ["+77079906965", "+77761112595", "+77073130202"],
   "website": "http://coffeeboom.kz", "rating": 4.8, "reviewCount": 1865, "branchCount": 24,
   "url": "https://2gis.kz/firm/70000001061772322"},
  {"name": "WHITE provenance, центр имплантации и ортодонтии", "category": "Частные стоматологии",
   "address": "Семьи Шамшиных, 65", "district": "Центральный район", "city": "Новосибирск",
   "website": "http://white-dental.ru", "email": "info@white-dental.ru",
   "socialLinks": {"telegram": "https://t.me/white_dentalclinic", "vkontakte": "https://vk.com/white_nsk"},
   "rating": 5, "reviewCount": 764, "url": "https://2gis.ru/firm/70000001043874723"}
]
```

### Limits

- 2GIS returns results in pages of 50. A busy search in a big city can report thousands of matches; the actor keeps paging until it reaches your limit or the end of the list.
- Contacts, ratings and hours come exactly as the business card on 2GIS shows them. Many small businesses list a phone but no website or email.
- A chain with many outlets appears once per outlet, each with its own address and id.
- In the UAE, 2GIS treats the whole country as one region, so `Dubai` searches the UAE region (a test for `dentist` returned Dubai clinics first).
- Search terms work best in the language of the city. An English term in a Russian city finds fewer businesses.

### FAQ

**How much does it cost to scrape 10,000 businesses from 2GIS?**
$10, plus $0.001 for each run.

**Do I pay for compute or proxy on top?**
No. Platform usage, including the proxy, is included in the $1 per 1,000 price.

**Which cities can I use?**
Any city 2GIS covers. Write the name in the local spelling or in English; if the actor cannot match it, the log says so and you pay only the run start.

**Do I need a 2GIS account or an API key?**
No. The actor reads the same public business cards a visitor sees on the 2GIS website.

**Why is the same chain listed many times?**
2GIS lists each outlet as its own card. Use `orgName` and `branchCount` to group them.

**Is it legal?**
The actor collects only public business information that anyone can see without logging in. You are responsible for how you use it: follow the 2GIS terms of use and local law, including data protection and marketing rules, when you store the data or contact businesses.

**Is this an official 2GIS product?**
No. It is an independent tool and is not affiliated with or endorsed by 2GIS.

**Do I need an Apify account?**
Yes. Actors run from an Apify account, and a free account is enough to start: it includes $5 of platform usage every month. You can [sign up here](https://www.apify.com?fpr=ymnoit). This is a referral link and it costs you nothing.

**Is there a limit on the free plan?**
Yes. A run started from a free plan account delivers the first 10 results, then ends with a message and a link to the plans. Any paid plan returns everything you ask for, up to your own limit. The price per result is the same on every plan.

### More from The One Dollar Store

Every actor here costs $1 per 1,000 results, platform usage included.

**Google and search**

- [Google News Scraper](https://apify.com/one_dollar_store/google-news-articles-scraper): News articles by keyword, topic or country.
- [Google Maps Leads Scraper](https://apify.com/one_dollar_store/google-maps-leads-scraper): Local businesses with phones, websites and emails.
- [Google Ads Transparency Scraper](https://apify.com/one_dollar_store/google-ads-transparency-scraper): Ads any advertiser or domain runs on Google.

**Maps and local business**

- [Yandex Maps Scraper](https://apify.com/one_dollar_store/yandex-maps-business-scraper): Businesses on Yandex Maps around any city.
- [IndiaMART Supplier Scraper](https://apify.com/one_dollar_store/indiamart-supplier-scraper): Indian suppliers for any product, with phones.

**Social media**

- [Threads Scraper](https://apify.com/one_dollar_store/threads-post-scraper): Public Threads posts by keyword or profile.
- [Instagram Profile Scraper](https://apify.com/one_dollar_store/instagram-profile-data-scraper): Followers, posts and engagement for public profiles.
- [TikTok Hashtag Scraper](https://apify.com/one_dollar_store/tiktok-hashtag-videos-scraper): Videos, views and creators for any hashtag.
- [Pinterest Pin Search Scraper](https://apify.com/one_dollar_store/pinterest-pin-search-scraper): Public pins with images and outbound links.
- [Telegram Channel Scraper](https://apify.com/one_dollar_store/telegram-channel-posts-scraper): Posts, views and media from public channels.
- [Xiaohongshu Scraper](https://apify.com/one_dollar_store/xiaohongshu-explore-feed-scraper): RedNote notes from the public explore feeds.
- [Facebook Ad Library Scraper](https://apify.com/one_dollar_store/facebook-ad-library-scraper): Meta ads by keyword or advertiser page.

**Shopping**

- [Amazon Reviews Scraper](https://apify.com/one_dollar_store/amazon-product-reviews-scraper): Public reviews for any Amazon product.
- [AliExpress Product Scraper](https://apify.com/one_dollar_store/aliexpress-product-search-scraper): Products with prices, orders sold and ratings.
- [Etsy Scraper](https://apify.com/one_dollar_store/etsy-listings-scraper): Listings with prices, shops and badges.
- [Carsales Scraper](https://apify.com/one_dollar_store/carsales-car-listings-scraper): Australian car listings with prices and specs.

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/one_dollar_store/zillow-rentals-scraper): US rentals by city, ZIP or search link.
- [Zillow Sold Homes Scraper](https://apify.com/one_dollar_store/zillow-sold-homes-scraper): Recently sold US homes with prices and dates.
- [Zillow Photos Scraper](https://apify.com/one_dollar_store/zillow-listing-photos-scraper): Every photo of a Zillow listing.

**Jobs**

- [Foundit Jobs Scraper](https://apify.com/one_dollar_store/foundit-jobs-search-scraper): Indian jobs with salary and experience filters.
- [Naukri Jobs Scraper](https://apify.com/one_dollar_store/naukri-job-listings-scraper): Naukri.com jobs by keyword, city and experience.

**Company records**

- [Bundesanzeiger Scraper](https://apify.com/one_dollar_store/bundesanzeiger-filings-scraper): German company filings and notices.
- [US Business Registry Search](https://apify.com/one_dollar_store/us-business-registry-search): Company records from 6 US state registries.

### Changelog

- October 2026: first release.

# Actor input Schema

## `queries` (type: `array`):

Business types or names, one per line, for example "кафе", "стоматология" or "car service". Searches in the local language usually find more businesses.

## `city` (type: `string`):

Name of a city covered by 2GIS, for example Москва, Новосибирск, Алматы, Ташкент or Dubai. A numeric 2GIS region id also works.

## `maxItems` (type: `integer`):

The run stops after this many businesses in total, across all searches. Minimum 10.

## `proxyConfiguration` (type: `object`):

Apify datacenter proxy is the default and works for 2GIS.

## Actor input object example

```json
{
  "queries": [
    "кафе"
  ],
  "city": "Москва",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# 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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "кафе"
    ],
    "city": "Москва",
    "maxItems": 50,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("one_dollar_store/2gis-business-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 '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "queries": ["кафе"],
    "city": "Москва",
    "maxItems": 50,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("one_dollar_store/2gis-business-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 '{
  "queries": [
    "кафе"
  ],
  "city": "Москва",
  "maxItems": 50,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call one_dollar_store/2gis-business-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,one_dollar_store/2gis-business-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 <APIFY_API_TOKEN>` 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/byMcqG1n2Yoe8fEvm/builds/Hgr3HuR9zSnDoHy7j/openapi.json