# 2GIS Jobs Scraper - Парсер вакансий: зарплаты и контакты (`zen-studio/2gis-jobs-scraper`) Actor

Извлекайте вакансии из 2ГИС по любому городу России, СНГ и Ближнего Востока. Зарплаты, должности, адреса, контакты работодателей и ссылки для отклика — вструктурированном JSON. Фильтрация по категории и зарплате. Без браузера, прямой доступ к API. Экспорт в CSV, Excel, JSON.

- **URL**: https://apify.com/zen-studio/2gis-jobs-scraper.md
- **Developed by:** [Zen Studio](https://apify.com/zen-studio) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Stats:** 11 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.99 / 1,000 job 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/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

## Парсер вакансий 2ГИС — 2GIS Jobs Scraper | Зарплаты, компании, контакты (2026)

<table style="width:100%">
<tr>
<td colspan="4" style="padding:10px 14px;background:#0AB335;border:none;border-radius:4px 4px 0 0">
<span style="color:#FFFFFF;font-size:14px;font-weight:700;letter-spacing:0.5px">2GIS Scraper Suite</span>
<span style="color:#D4F5DB;font-size:13px">&nbsp;&nbsp;&bull;&nbsp;&nbsp;Full 2GIS data extraction toolkit</span>
</td>
</tr>
<tr>
<td style="background:#E8F5E9;padding:10px 14px;border:1px solid #E7E5E4;border-radius:0 0 0 4px;border-right:none;border-top:none;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-NBmcHCtkUEhA0DNP3-SrXbUedsVm-2gis-scraper-api-logo.png" width="20" height="20" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/2gis-places-scraper-api" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Places Scraper</a><br>
<span style="color:#78716C;font-size:11px">Phones, emails &amp; business data</span>
</td>
<td style="background:#E8F5E9;padding:10px 14px;border:1px solid #E7E5E4;border-right:none;border-top:none;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-NBmcHCtkUEhA0DNP3-SrXbUedsVm-2gis-scraper-api-logo.png" width="20" height="20" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/2gis-reviews-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Reviews Scraper</a><br>
<span style="color:#78716C;font-size:11px">All reviews &amp; business replies</span>
</td>
<td style="padding:10px 14px;border:1px solid #E7E5E4;border-right:none;border-top:none;background:#D3EDD9;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-NBmcHCtkUEhA0DNP3-SrXbUedsVm-2gis-scraper-api-logo.png" width="20" height="20" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/2gis-jobs-scraper" style="color:#0AB335;text-decoration:none;font-weight:700;font-size:13px">Jobs Scraper</a><br>
<span style="color:#0AB335;font-size:11px;font-weight:600">&#10148; You are here</span>
</td>
<td style="background:#E8F5E9;padding:10px 14px;border:1px solid #E7E5E4;border-radius:0 0 4px 0;border-top:none;vertical-align:top;width:25%">
<img src="https://apify-image-uploads-prod.s3.us-east-1.amazonaws.com/NWYsOG96fMDy8ycdf-actor-6PKMF3OW9OZ1ecUuL-R9g0koZQA2-2gis-property-scraper-logo.png" width="20" height="20" style="vertical-align:middle"> &nbsp;<a href="https://apify.com/zen-studio/2gis-property-scraper" style="color:#1C1917;text-decoration:none;font-weight:700;font-size:13px">Property Scraper</a><br>
<span style="color:#78716C;font-size:11px">Apartments, rentals &amp; commercial</span>
</td>
</tr>
</table>

Парсер вакансий с 2ГИС — название, зарплата, описание, компания, адрес, координаты, ссылка для отклика. **224 категории профессий**, фильтр по зарплате. 207 городов, 20 стран. Без браузера, без логина.

2GIS job vacancies scraper — title, salary, description, company, address, GPS, apply link. 224 job categories, salary filter. 207 cities, 20 countries.

> **Try it free** — new Apify users get $5 in platform credits. That's ~**1,600 vacancies** at no cost.

<table><tr>
<td style="border-left:4px solid #0AB335;padding:12px 16px;font-weight:600">1,000 vacancies in under 60 seconds — hands down the richest output on Apify.</td>
</tr></table>

#### Copy to your AI assistant

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

```
zen-studio/2gis-jobs-scraper on Apify. Call: ApifyClient("TOKEN").actor("zen-studio/2gis-jobs-scraper").call(run_input={...}), then client.dataset(run["defaultDatasetId"]).list_items().items for results. Key inputs: location (string, required, city name e.g. "Moscow"), categoryId (string, optional, job category filter). Full actor spec (input schema with all params/enums/defaults, output dataset fields, README): GET https://api.apify.com/v2/acts/zen-studio~2gis-jobs-scraper/builds/default (Bearer TOKEN) → inputSchema, actorDefinition.storages.dataset, readme. Pricing: pay-per-event, $0.003/vacancy. Get token: https://console.apify.com/account/integrations
```

***

### Что вы получите

**31 поле на каждую вакансию** — название позиции, категория профессии, зарплата (текстовый лейбл от 2ГИС), полное описание, компания (название, ID), здание (ID), полный адрес и его части (улица, дом, ID улицы), город и его алиас, район, микрорайон, населённый пункт, регион, страна, координаты (lat/lon), ссылка для отклика, тип отклика, платформы отклика, провайдер (hh.ru, SuperJob и др.), код и иконка провайдера, текст об источнике данных, логотип компании.

**224 категории** — от «Разработчик» и «Аналитик» до «Бариста», «Курьер» и «Сварщик». Фильтруйте по конкретной профессии или собирайте все вакансии города.

**Фильтр по зарплате** — задайте минимум и/или максимум. Получайте только вакансии в нужном диапазоне.

### Ключевые возможности — Key Capabilities

- **Чистый API** — без браузера, без Selenium. Прямые запросы, высокая скорость
- **224 категории** — полный список профессий 2ГИС с точной фильтрацией
- **Диапазон зарплат** — фильтр по минимальной и максимальной зарплате
- **207 городов, 20 стран** — Россия, Казахстан, ОАЭ, Саудовская Аравия и другие

***

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

#### Минимальный — все вакансии города

```json
{
    "location": "Moscow",
    "maxResults": 100
}
```

#### С фильтром по категории — разработчики

```json
{
    "location": "Saint Petersburg",
    "categoryId": "160",
    "maxResults": 500
}
```

#### С фильтром по зарплате

```json
{
    "location": "Moscow",
    "salaryMin": 100000,
    "salaryMax": 300000,
    "maxResults": 200
}
```

#### Полная конфигурация — Full Configuration

```json
{
    "location": "Moscow",
    "country": "RU",
    "language": "ru",
    "categoryId": "160",
    "salaryMin": 80000,
    "salaryMax": 250000,
    "maxResults": 1000,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}
```

***

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

#### Местоположение (Location)

| Параметр | Тип | Описание | По умолчанию |
|----------|-----|----------|--------------|
| `location` | string | Город для поиска вакансий. City to search vacancies in. Примеры: Moscow, Saint Petersburg, Dubai, Novosibirsk | — (обязательный / required) |
| `country` | string | Страна для уточнения города. Country code to disambiguate city names (RU, KZ, AE, etc.) | Авто |
| `language` | string | Язык результатов. Language: `ru`, `en`, `kk`, `uz`, `ky`, `ar`, `cs` | `ru` |

#### Фильтры (Filters)

| Параметр | Тип | Описание | По умолчанию |
|----------|-----|----------|--------------|
| `categoryId` | string | Категория профессии. Job category — 224 categories available (see full list in Actor UI). Leave empty for all | Все |
| `salaryMin` | integer | Минимальная зарплата. Minimum salary filter | — |
| `salaryMax` | integer | Максимальная зарплата. Maximum salary filter | — |
| `maxResults` | integer | Макс. вакансий. Max vacancies to scrape. `0` or empty = unlimited | `1000` |

#### Система (System)

| Параметр | Тип | Описание | По умолчанию |
|----------|-----|----------|--------------|
| `proxyConfiguration` | object | Настройка прокси. Proxy configuration | Apify Residential |

***

### Категории профессий — Job Categories

224 категории. В интерфейсе Apify категория выбирается из выпадающего списка — ID подставляется автоматически. Для API-интеграций (Python/JS) используйте `categoryId` из таблицы ниже.

In the Apify Console UI, pick a category from the dropdown. For API usage, use the `categoryId` values below.

#### Популярные категории — Common Categories

| categoryId | Категория | Category |
|------------|-----------|----------|
| `"160"` | Разработчик | Developer |
| `"223"` | DevOps-инженер | DevOps Engineer |
| `"195"` | Тестировщик | QA Engineer |
| `"180"` | Системный администратор | Sysadmin |
| `"8"` | Аналитик | Analyst |
| `"9"` | Аналитик данных | Data Analyst |
| `"19"` | Бизнес-аналитик | Business Analyst |
| `"41"` | Дизайнер | Designer |
| `"110"` | Менеджер по продажам | Sales Manager |
| `"93"` | Маркетолог | Marketer |
| `"224"` | SMM-специалист | SMM Specialist |
| `"85"` | Копирайтер | Copywriter |
| `"90"` | Курьер | Courier |
| `"26"` | Водитель | Driver |
| `"142"` | Повар | Cook |
| `"16"` | Бариста | Barista |
| `"136"` | Официант | Waiter |
| `"29"` | Врач | Doctor |
| `"103"` | Медсестра/медбрат | Nurse |
| `"60"` | Инженер | Engineer |
| `"176"` | Сварщик | Welder |
| `"23"` | Бухгалтер | Accountant |
| `"109"` | Менеджер по персоналу | HR Manager |
| `"38"` | Грузчик | Loader |
| `"137"` | Охранник | Security Guard |
| `"159"` | Разнорабочий | General Worker |
| `"0"` | Другое | Other |

Полный список (224 категории) доступен в выпадающем меню интерфейса актора.

***

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

Каждая вакансия — отдельная строка. Плоский формат, готов для CSV:

```json
{
  "id": "1784933",
  "name": "Бармен/бариста (м. Теплый Стан)",
  "categoryId": "136",
  "categoryName": "Официант",
  "salaryLabel": "от 80 000 ₽ в месяц на руки",
  "description": "JOKI JOYA — это парки развлечений для всей семьи.\nСегодня бренд Joki Joya является лидером индустрии детских развлечений в России и состоит из 33 парков в 3 городах: 22 в Москве и МО, 10 в Санкт-Петербурге и 1 в Твери.\nСемейный ресторан Joki Joya в ТРК Спектр (м. Теплый Стан, Новоясеневский пр., д. 1) приглашает сотрудников на позицию Бармен/бариста.\nМы предлагаем:\n\n– Фиксированную ставку – 4100 руб. за смену + 10% от чая официантов + премии; \n– График работы: 2/2 или 3/3; \n– Смены с 9:30 до 22:00 по будням дням, с 9:00 до 22:00 по выходным; \n– Бесплатное стафф-питание (завтрак, обед и ужин); \n– Фирменную одежду; \n– Выплаты 2 раза в месяц; \n– Удобное расположение Парка у метро «Теплый Стан», 2 мин. пешком (или подберем другой парк поближе к дому индивидуально для каждого); \n– Работу в парках активного отдыха являющимися лидером индустрии детских развлечений в России на протяжении уже 10-ти лет! \n\nЧем предстоит заниматься:\n\n– Подготовкой ресторана к открытию и закрытию, поддержанием чистоты на рабочем месте; \n– Принятием заказов, осуществлением расчета гостей, соблюдением кассовой дисциплины; \n– Приготовлением чая, кофе, молочных коктейлей, соков, розливом слабоалкогольных напитков (пиво, вино). \n\nМы будем рады видеть Вас на собеседовании, если:\n\n– Вы имеете опыт в данной сфере от 3-х месяцев; \n– Вы умеете и готовы быть частью большой команды, поддерживать коллег и здоровую атмосферу в команде. \n\nПрисоединившись к нашей команде, Вы станете тем, кто создает наш Парк и делает его с каждым днем все лучше!\nВырасти до руководящих позиций в наших парках – Реально!",
  "orgId": "70000001027103850",
  "orgName": "Joki Joya, парк развлечений",
  "branchId": "70000001034678933",
  "buildingId": "70030076184162496",
  "address": "Новоясеневский проспект 1",
  "addressComponents": [
    {
      "street": "Новоясеневский проспект",
      "number": "1",
      "streetId": "4504338361745846",
      "type": "street_number",
      "comment": null
    }
  ],
  "city": "Москва",
  "cityAlias": "moscow",
  "district": "Ясенево",
  "districtArea": null,
  "livingArea": null,
  "settlement": null,
  "region": "Москва",
  "country": "Россия",
  "lat": 55.619571,
  "lon": 37.509461,
  "applyUrl": "https://hh.ru/vacancy/129877432?utm_campaign=dm_ru_paid_fix_applicant_feed&utm_content=2475500&utm_medium=ppc&utm_source=2gis&utm_vacancy=129877432",
  "applyType": "link",
  "ctaPlatforms": ["ios", "android", "online"],
  "provider": "hh.ru",
  "providerCode": "hh",
  "providerIconUrl": "https://outsource.api.2gis.com/assets/v1/vacancies/icons/hh.png",
  "legalText": "Информация о вакансии предоставлена hh.ru",
  "logoUrl": null,
  "scrapedAt": "2026-02-10T13:02:56.606920+00:00"
}
```

***

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

Прозрачная тарификация за каждую вакансию. Платите только за то, что извлекаете.

#### Событие

| Event | Что тарифицируется | Free | Bronze | Silver | Gold |
|-------|-------------------|------|--------|--------|------|
| **vacancy\_scraped** | Каждая извлечённая вакансия | $2.99 / 1,000 | $2.79 / 1,000 | $2.49 / 1,000 | $1.99 / 1,000 |

#### Калькулятор стоимости

**Обзор рынка труда — 500 вакансий одного города:**

| Что | Количество | Стоимость |
|-----|-----------|-----------|
| Вакансии | 500 | $1.50 |
| **Итого** | | **$1.50** |

**Мониторинг конкурентов — все IT-вакансии Москвы (~2,000):**

| Что | Количество | Стоимость |
|-----|-----------|-----------|
| Вакансии | 2,000 | $5.98 |
| **Итого** | | **$5.98** |

**Полный сбор — все вакансии города (~5,000):**

| Что | Количество | Стоимость |
|-----|-----------|-----------|
| Вакансии | 5,000 | $14.95 |
| **Итого** | | **$14.95** |

***

### Использование через API — Python

```python
from apify_client import ApifyClient

client = ApifyClient("YOUR_API_TOKEN")

run = client.actor("zen-studio/2gis-jobs-scraper").call(run_input={
    "location": "Moscow",
    "categoryId": "160",
    "salaryMin": 100000,
    "maxResults": 500,
})

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(f"{item['name']} — {item['salaryLabel']} — {item['orgName']}")
```

### Использование через API — JavaScript

```javascript
import { ApifyClient } from 'apify-client';

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

const run = await client.actor('zen-studio/2gis-jobs-scraper').call({
    location: 'Moscow',
    categoryId: '160',
    salaryMin: 100000,
    maxResults: 500,
});

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

***

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

#### Все вакансии разработчиков в Казахстане

```json
{
    "location": "Almaty",
    "country": "KZ",
    "categoryId": "160",
    "language": "ru",
    "maxResults": 0
}
```

#### Высокооплачиваемые вакансии Петербурга

```json
{
    "location": "Saint Petersburg",
    "salaryMin": 200000,
    "maxResults": 0
}
```

#### Вакансии курьеров в Дубае

```json
{
    "location": "Dubai",
    "country": "AE",
    "categoryId": "90",
    "language": "en",
    "maxResults": 500
}
```

#### Все вакансии поваров Новосибирска

```json
{
    "location": "Novosibirsk",
    "categoryId": "142",
    "maxResults": 0
}
```

***

### Поддерживаемые города — 207 городов, 20 стран

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

**Казахстан (19)** — Almaty, Astana, Shymkent, Karaganda, Aktobe и другие.

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

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

***

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

Русский, English, العربية (Arabic), Қазақша (Kazakh), O'zbek (Uzbek), Кыргызча (Kyrgyz), Čeština (Czech).

***

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

Экспортируйте результаты в любом формате из платформы Apify:

- **JSON** — структурированные данные для API-интеграций и баз данных
- **CSV** — плоские таблицы для Excel, Google Sheets, импорта в CRM
- **Excel (.xlsx)** — готово для отчётов и визуализации
- **XML** — для интеграции с legacy-системами

***

### Прокси — Proxy Configuration

Резидентные прокси рекомендуются для стабильного извлечения. Конфигурация по умолчанию работает из коробки:

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

***

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

**Q: Сколько вакансий можно собрать?**
A: Установите `maxResults` в `0` для неограниченного извлечения. Парсер соберёт все доступные вакансии в указанном городе.

**Q: Нужен ли аккаунт 2ГИС?**
A: Нет. Без логина, без cookies, без браузера. Работает сразу.

**Q: Откуда берутся вакансии?**
A: 2ГИС агрегирует вакансии с нескольких платформ: hh.ru, SuperJob и других. Поле `provider` указывает источник каждой вакансии.

**Q: Можно ли фильтровать по профессии?**
A: Да. Используйте `categoryId` — 224 категории профессий. Полный список доступен в выпадающем меню интерфейса актора.

**Q: Как работает фильтр по зарплате?**
A: `salaryMin` и `salaryMax` фильтруют вакансии на стороне сервера. Можно задать только минимум, только максимум или оба значения.

**Q: Чем отличается от парсера мест (Places Scraper)?**
A: [2gis Places парсер](/zen-studio/2gis-places-scraper-api) собирает данные организаций (70+ полей). Jobs Scraper специализируется на вакансиях: должность, зарплата, описание, ссылка для отклика. Разные API, разные данные.

**Q: Нужны отзывы о компаниях, а не вакансии?**
A: Используйте [2gis Reviews парсер](/zen-studio/2gis-reviews-scraper) — парсер отзывов с 7 фильтрами (тональность, дата, тема, источник). Плоский формат: один отзыв = одна строка.

**Q: Ищете недвижимость вместо вакансий?**
A: Используйте [2gis Property парсер](/zen-studio/2gis-property-scraper) — парсер объявлений недвижимости с 12 фильтрами. Продажа и аренда жилой/коммерческой недвижимости.

**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 other 2GIS regions.

**Q: What does the output include?**
A: 20 fields per vacancy: job title, category, salary label, full description, company name/ID, address, district, city, region, GPS coordinates, apply URL, provider (hh.ru, etc.), company logo, and scraping timestamp.

**Q: Can I combine category and salary filters?**
A: Yes. Set both `categoryId` and `salaryMin`/`salaryMax` to narrow results. For example, find all developer jobs paying over 150,000.

**Q: Что если в городе нет вакансий?**
A: Парсер просто завершит работу с нулевым результатом. Никаких ошибок, никаких лишних расходов.

***

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

#### 1. Создайте аккаунт Apify

[Зарегистрируйтесь бесплатно](https://console.apify.com/sign-up) — новые пользователи получают $5 кредитов.

#### 2. Выберите город

Введите название города на русском или английском. 207 городов в 20 странах.

#### 3. Настройте фильтры

Выберите категорию профессии и диапазон зарплат. Начните с небольшого `maxResults` (50–100) для предпросмотра.

#### 4. Запустите и экспортируйте

Запустите парсер, дождитесь результатов, скачайте в JSON/CSV/Excel. Или используйте API для автоматизации.

***

### 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.

***

[**Начать парсинг вакансий 2ГИС — Start Scraping Jobs**](https://console.apify.com/actors/oKNKkOkXy4cbqHYGY)

***

*Вакансии, зарплаты и контакты работодателей из крупнейшего справочника России, СНГ и Ближнего Востока — в структурированном формате за минуты.*

# Actor input Schema

## `location` (type: `string`):

City to search vacancies in. Examples: Moscow, Saint Petersburg, Dubai, Novosibirsk.

## `country` (type: `string`):

Narrow location to a specific country if the city name is ambiguous.

## `language` (type: `string`):

Language for results.

## `categoryId` (type: `string`):

Filter by job category. Leave empty for all categories.

## `salaryMin` (type: `integer`):

Minimum salary filter. Leave empty for no lower bound.

## `salaryMax` (type: `integer`):

Maximum salary filter. Leave empty for no upper bound.

## `maxResults` (type: `integer`):

Maximum number of vacancies to scrape. 0 or empty = unlimited.

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

Proxy configuration.

## Actor input object example

```json
{
  "location": "Saint Petersburg",
  "country": "",
  "language": "ru",
  "categoryId": "",
  "maxResults": 1000,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}
```

# Actor output Schema

## `results` (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 = {
    "location": "Saint Petersburg",
    "maxResults": 1000,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ]
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("zen-studio/2gis-jobs-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 = {
    "location": "Saint Petersburg",
    "maxResults": 1000,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
    },
}

# Run the Actor and wait for it to finish
run = client.actor("zen-studio/2gis-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print("💾 Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"])
for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "location": "Saint Petersburg",
  "maxResults": 1000,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ]
  }
}' |
apify call zen-studio/2gis-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=zen-studio/2gis-jobs-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/oKNKkOkXy4cbqHYGY/builds/Roepv8DqMPZoVDrso/openapi.json
