# Trudvsem.ru Scraper: Russia Government Jobs (Работа России) (`santamaria-automations/trudvsem-ru-scraper`) Actor

Scrape official job listings from trudvsem.ru (Работа России) — Russia's national employment database by Rostrud. Returns job title, company, region, salary in RUB, OKPDTR code, education, experience, and recruiter contacts for all 89 federal subjects.

- **URL**: https://apify.com/santamaria-automations/trudvsem-ru-scraper.md
- **Developed by:** [NanoScrape](https://apify.com/santamaria-automations) (community)
- **Categories:** Jobs, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

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?

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

## Trudvsem.ru Scraper: Russia Government Jobs (Работа России)

Collect official job listings from [trudvsem.ru](https://trudvsem.ru) (Работа России) — Russia's national employment database operated by Rostrud (Федеральная служба по труду и занятости, Federal Labour Service). Russian law requires employers to register every vacancy with the state employment service before filling it, making this the most authoritative and complete source of open positions across all 89 federal subjects of the Russian Federation.

The actor uses the official open government API at [opendata.trudvsem.ru](https://opendata.trudvsem.ru) — no authentication required, no anti-bot protection, plain HTTP.

### What you get

Each result contains:

- **Job**: title, trudvsem vacancy UUID, direct URL, creation date, last modified date
- **Occupation code**: OKPDTR code (Общероссийский классификатор профессий рабочих, должностей служащих и тарифных разрядов) for cross-referencing occupational statistics
- **Employer**: registered company name, INN (ИНН), OGRN (ОГРН), KPP (КПП), employer email, HR agency flag, trudvsem company profile URL
- **Location**: work address with office number, latitude/longitude, city, federal subject (region), country code RU
- **Compensation**: salary min/max in RUB, human-readable salary string (e.g. "от 60000 руб. в месяц")
- **Employment details**: employment type (full-time/part-time/remote/seasonal), work schedule, shift pattern, planned hire date, open positions count, quota flag (for disability quotas), foreign/special workplace flags
- **Requirements**: minimum education, required experience in years, specific qualification
- **Content**: duties, requirements text, skills list
- **Benefits**: employer-provided benefits, working conditions classification, medical document requirements, detailed medical certificate requirements, allowances/compensation text (term\_text)
- **Contacts**: recruiter name, email address, phone number from the posting
- **Social protection**: flags for vacancies reserved for protected categories (disabilities, veterans, etc.)

### Use cases

- Russian labor market research: identify which sectors and regions have the most open positions
- Salary benchmarking: compare RUB salaries across occupations and federal subjects
- HR analytics: track demand by OKPDTR occupation code, education level, and employment type
- Government procurement intelligence: identify which companies are actively hiring via Rostrud
- Academic research: analyze Russia's formal labor market using the official government registry
- Disability employment: filter quota positions reserved for people with disabilities
- Regional economic analysis: compare hiring activity across 89 federal subjects
- JobFeed aggregation: source for the nanoscrape job-feed service covering the RU market

### Pricing

This actor uses Pay-Per-Event (PPE) pricing:

| Event | Cost |
|---|---|
| Actor start | $0.001 |
| Job result (SERP mode) | $0.003 |
| Full job detail (all contact fields) | $0.005 |

**$5 free monthly credit** is included with every Apify account: enough for roughly 1,600 standard job results or 1,000 detail fetches per month.

Enable `includeJobDetails: true` to charge the detail-result event rate. The trudvsem API returns all fields including contacts in a single request regardless, so there is no extra HTTP cost.

### Input

```json
{
  "searchQueries": ["программист", "бухгалтер"],
  "location": "Москва",
  "maxResults": 100,
  "maxResultsPerQuery": 50,
  "includeJobDetails": true
}
```

| Field | Type | Default | Description |
|---|---|---|---|
| `searchQueries` | string\[] | | Job keywords in Russian. Examples: `программист`, `бухгалтер`, `водитель`, `инженер`, `медсестра`, `сварщик`. Leave empty to browse all open vacancies. |
| `location` | string | | Federal subject or major city. Examples: `Москва`, `Санкт-Петербург`, `Екатеринбург`, `Краснодар`, `Новосибирск`, `Казань`. Leave empty for all of Russia. |
| `regionCode` | string | | Trudvsem 2-digit region prefix (e.g. `77` for Moscow, `78` for St Petersburg, `66` for Sverdlovsk). Takes priority over `location`. |
| `includeJobDetails` | boolean | false | Charges `job-detail-result` event. Fields are identical since the API returns all data in one request. |
| `maxResults` | integer | 5 | Total results cap across all queries. |
| `maxResultsPerQuery` | integer | 5 | Cap per search keyword. |
| `maxConcurrency` | integer | 3 | Parallel requests. Keep at 3-5 to be respectful to the government API. |

### Output sample

```json
{
  "_type": "job",
  "id": "5862d8e8-8a82-11f0-8356-efc3bb2eec02",
  "title": "Программист",
  "job_url": "https://trudvsem.ru/vacancy/card/1197746306383/5862d8e8-8a82-11f0-8356-efc3bb2eec02",
  "source_url": "https://trudvsem.ru/vacancy/card/1197746306383/5862d8e8-8a82-11f0-8356-efc3bb2eec02",
  "source_platform": "trudvsem.ru",
  "company_name": "ООО \"ВИРМАНИ ИНТЕРНЕЙШНЛ\"",
  "company_code": "1197746306383",
  "company_inn": "7727418682",
  "company_ogrn": "1197746306383",
  "company_website": null,
  "company_url": "https://trudvsem.ru/company/1197746306383",
  "is_hr_agency": false,
  "is_direct_employer": true,
  "location": "г Москва, Город Москва",
  "country": "RU",
  "region": "Город Москва",
  "region_code": "7700000000000",
  "address": "г Москва, Большая Юшуньская улица, 1А, корп.4, 117303",
  "latitude": "55.651003",
  "longitude": "37.596273",
  "posted_at_text": "2025-09-05",
  "posted_at_datetime": "2025-09-05T00:00:00Z",
  "updated_at": "2026-07-31T11:27:52Z",
  "employment_type": "Full-time",
  "schedule": "Полный рабочий день",
  "work_places": 1,
  "is_remote": false,
  "is_quota": false,
  "salary_text": "от 60000 руб. в месяц",
  "salary_min": 60000,
  "salary_max": 65000,
  "salary_currency": "RUB",
  "salary_period": "month",
  "industry": "Информационные технологии, телекоммуникации, связь",
  "okpdtr_code": "203191",
  "typical_position": "Программист",
  "education": "Высшее образование — специалитет, магистратура",
  "experience_years": 5,
  "qualification": "(программист) \"1С\"",
  "requirements": "Знание бух программы 1С. Дисциплинированность",
  "duties": "Разрабатывать технологию решения задачи по всем этапам обработки информации.",
  "skills": [],
  "benefits": "Оплата питания",
  "conditions": "Оптимальные",
  "medical_documents": "Медицинская книжка",
  "contact_person": "ЧАВЛА ПАРАС",
  "contact_emails": ["chawla1605@rambler.ru"],
  "contact_phones": ["+7(903) 202-36-54"],
  "social_protected": null,
  "company_kpp": "772701001",
  "company_email": "chawal.paras@mail.ru",
  "term_text": "Питание. Транспорт",
  "shift": [],
  "hire_date": null,
  "medical_certificate": null,
  "address_office": "1601",
  "is_foreign_workplace": false,
  "is_special_workplace": false,
  "source": "Вакансия работодателя",
  "search_query": "программист в Москва",
  "scraped_at": "2026-08-25T10:00:00Z"
}
```

### Russia-specific notes

**Salary currency**: All salaries are in RUB (Russian ruble). The 2026 federal minimum wage is approximately 22,440 RUB/month gross. Regional minimum wages (МРОТ) vary significantly and are often higher, particularly in Moscow (approximately 29,389 RUB) and other major cities. Most salaries on trudvsem.ru are quoted as gross ("грязными").

**89 federal subjects**: Russia is divided into 89 federal subjects including 22 republics, 9 krais (края), 46 oblasts (области), 4 autonomous okrugs (автономные округа), 1 autonomous oblast (Еврейская АО), and 3 federal cities (Москва, Санкт-Петербург, Севастополь). The `region` field returns the official administrative name. Results are emitted exactly as returned by the API for all regions.

**Employment types** in Russian:

- полная занятость = full-time
- частичная занятость = part-time
- стажировка = internship
- сезонная работа = seasonal
- удаленная работа = remote
- вахтовый метод = rotational shift (common in oil/gas regions)

**OKPDTR codes**: Russia's national occupational classification system for workers' professions, employees' positions, and wage grades. The `okpdtr_code` enables cross-referencing with Rosstat (Russian Federal State Statistics Service) labor market data.

**Quota positions**: The `is_quota` flag marks vacancies that employers are legally required to maintain for workers with disabilities (as per Russian disability employment quota law). These positions are filled from the state disability register.

**Direct employer vs HR agency**: The `is_direct_employer` flag distinguishes postings from the hiring organization itself vs. postings placed by staffing agencies (кадровые агентства).

### Related actors

- [job-feed](https://apify.com/nanoscrape/job-feed) - Aggregate job data from multiple platforms into one unified feed
- [career-site-jobs-scraper](https://apify.com/nanoscrape/career-site-jobs-scraper) - Extract jobs from any company career page
- [website-job-extractor](https://apify.com/nanoscrape/website-job-extractor) - Structured job extraction from any URL
- [indeed-scraper](https://apify.com/nanoscrape/indeed-scraper) - Global job listings from Indeed
- [anofm-ro-scraper](https://apify.com/nanoscrape/anofm-ro-scraper) - Romania official employment agency (ANOFM)
- [sepe-es-scraper](https://apify.com/nanoscrape/sepe-es-scraper) - Spain official employment service (SEPE)

### Issues

Found a bug or have a question? Open an issue in the [Issues tab](../../issues) or email contact@nanoscrape.com.

# Actor input Schema

## `searchQueries` (type: `array`):

One or more job keywords to search on trudvsem.ru. Each runs as a separate query. Examples: 'программист', 'бухгалтер', 'водитель', 'инженер', 'медсестра'. Leave empty to browse all open vacancies.

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

Russian federal subject or major city to filter results. Examples: 'Москва', 'Санкт-Петербург', 'Екатеринбург', 'Краснодар', 'Новосибирск', 'Казань'. Leave empty for all of Russia.

## `regionCode` (type: `string`):

Trudvsem 2-digit region prefix (e.g. '77' for Moscow, '78' for St Petersburg, '66' for Sverdlovsk Oblast). Takes priority over Location field.

## `includeJobDetails` (type: `boolean`):

When enabled, charges the higher job-detail-result PPE event. The trudvsem API returns all fields (duties, requirements, skills, contacts) in the same request regardless — this flag simply adjusts billing.

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

Total results cap across all search queries. The API has 500,000+ active vacancies.

## `maxResultsPerQuery` (type: `integer`):

Maximum results returned per individual search keyword.

## `maxConcurrency` (type: `integer`):

Maximum parallel requests. Keep low (3-5) to be respectful to the government API.

## Actor input object example

```json
{
  "searchQueries": [
    "программист"
  ],
  "location": "Москва",
  "regionCode": "77",
  "includeJobDetails": false,
  "maxResults": 5,
  "maxResultsPerQuery": 5,
  "maxConcurrency": 3
}
```

# Actor output Schema

## `jobListings` (type: `string`):

Dataset containing scraped trudvsem.ru job listings. Each row includes title, company (with INN, OGRN, KPP, email), region, address (with office number), salary in RUB, employment type, shift schedule, OKPDTR code, education, experience, skills, benefits (including term\_text allowances), medical requirements, hire date, foreign/special workplace flags, and recruiter contacts.

# 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 = {
    "searchQueries": [
        "программист"
    ],
    "includeJobDetails": false,
    "maxResults": 5,
    "maxResultsPerQuery": 5,
    "maxConcurrency": 3
};

// Run the Actor and wait for it to finish
const run = await client.actor("santamaria-automations/trudvsem-ru-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 = {
    "searchQueries": ["программист"],
    "includeJobDetails": False,
    "maxResults": 5,
    "maxResultsPerQuery": 5,
    "maxConcurrency": 3,
}

# Run the Actor and wait for it to finish
run = client.actor("santamaria-automations/trudvsem-ru-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 '{
  "searchQueries": [
    "программист"
  ],
  "includeJobDetails": false,
  "maxResults": 5,
  "maxResultsPerQuery": 5,
  "maxConcurrency": 3
}' |
apify call santamaria-automations/trudvsem-ru-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,santamaria-automations/trudvsem-ru-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/3e4PddEW7aA72eRr1/builds/AlcExbsPefhmIfW7l/openapi.json