# Robota.ua CV/Resume Database Scraper (`blackfalcondata/robota-ua-cv-scraper`) Actor

Scrape robota.ua candidate/CV database (CVDB) with 40+ filters including keywords, city, industry, experience, education, and salary. Returns structured career profiles with work history, skills, and languages for 5M+ Ukrainian job seekers. Incremental tracking.

- **URL**: https://apify.com/blackfalcondata/robota-ua-cv-scraper.md
- **Developed by:** [Black Falcon Data](https://apify.com/blackfalcondata) (community)
- **Categories:** Jobs, Lead generation
- **Stats:** 4 total users, 2 monthly users, 95.0% runs succeeded, NaN bookmarks
- **User rating**: No ratings yet

## Pricing

from $2.00 / 1,000 results

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/platform/actors/running/actors-in-store#pay-per-event

## What's an Apify Actor?

Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases.
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.

In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md):

```bash
npm install apify-client
```

In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md):

```bash
pip install apify-client
```

In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md):

````bash
# MacOS / Linux
curl -fsSL https://apify.com/install-cli.sh | bash
# Windows
irm https://apify.com/install-cli.ps1 | iex
```bash

In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md).

If your project is in a different language, use 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

### What does robota.ua CV/Resume Database Scraper do?

robota.ua CV/Resume Database Scraper extracts structured candidate profiles from [robota.ua](https://robota.ua)'s CVDB — including career history, education, skills, languages, salary expectations, and demographic data. It supports 40+ search filters mirroring the employer-cabinet UI, so you can query by keywords, city, industry, experience, education, salary, and more.

### Key features

- **Incremental mode** — recurring runs emit and charge only for CVs that are new or whose tracked content changed. First run builds the baseline state; subsequent runs emit only new or changed records.
- **Compact mode** — AI-agent and MCP-friendly payloads with core fields only.

### What data can you extract from robota.ua?

Each result includes identity fields (`resumeId`, `firstName`, `patronymic`, `age`, `sex`, `photoUrl`, `cityName`), career fields (`speciality`, `salaryExpected`, `experiences[]` with position/company/dates/description), education (`educations[]` with institution/speciality/year, `educationLevel`), skills and languages (`skillsText`, `languages[]` with proficiency level), and metadata (`addedAt`, `updatedAt`, `contentQuality`, `changeType`). In standard mode, all fields are always present — unavailable data points are returned as `null`, never omitted. In compact mode, only identity and summary fields are returned.

Enable detail enrichment (`fetchDetail: true`, default) to get career history, education, skills, and language proficiency from individual CV pages.

### Input

The main inputs are search keywords and a result limit. Additional filters and options are available in the input schema.

Key parameters:

- **`keywords`** — Free-text search across CV fields (speciality, skills, experience descriptions). Leave empty to browse all CVs.
- **`cityId`** — Filter by candidate's city. 0 = all cities. Common IDs: 1=Kyiv, 2=Lviv, 3=Odesa, 4=Dnipro, 6=Donetsk, 9=Zaporizhzhia, 21=Kharkiv. Full list: `GET https://api.robota.ua/dictionary/city`. (default: `0`)
- **`rubricIds`** — Filter by industry rubrics from /values/rubrics. Example: [1] = IT. (default: `[]`)
- **`branchIds`** — Filter by business branch from /dictionary/branch. (default: `[]`)
- **`scheduleIds`** — Work schedule filter. 1=full-time, 2=part-time, 3=shift, 4=internship, 5=remote. (default: `[]`)
- **`experienceIds`** — 0=no experience, 1=up to 1yr, 2=1-2yr, 3=2-5yr, 4=5-10yr, 5=10+yr. (default: `[]`)
- **`educationIds`** — Education filter from /dictionary/education. (default: `[]`)
- **`languages`** — Language requirements from /values/languagelist. 1=English, 4=German, etc. (default: `[]`)
- **`ageFrom`** — Filter candidates at or above this age.
- **`ageTo`** — Filter candidates at or below this age.
- **`sex`** — Gender filter. (default: `"Any"`)
- **`salaryFrom`** — Minimum salary expectation (in selected currency).
- ...and 24 more parameters

#### Input examples

**IT candidates in Kyiv with salary filter** — Find software engineers in Kyiv expecting 30k-80k UAH.

→ Returns full career profiles with experiences, educations, skills, and languages.

```json
{
  "keywords": "software engineer",
  "cityId": 1,
  "salaryFrom": 30000,
  "salaryTo": 80000,
  "maxResults": 100
}
````

**Experienced accountants, full-time only** — Search for accountants with 2-10 years experience, filtered by schedule and industry.

→ Uses experience, schedule, and keyword filters together.

```json
{
  "keywords": "бухгалтер",
  "experienceIds": [3, 4],
  "scheduleIds": [1],
  "branchIds": [8],
  "maxResults": 50
}
```

**Daily monitoring with incremental tracking** — Track new and changed CVs in Dnipro across all industries.

→ First run builds baseline state. Subsequent runs only emit and charge for new or changed CVs.

```json
{
  "keywords": "",
  "cityId": 4,
  "period": "Week",
  "maxResults": 500,
  "incrementalMode": true,
  "stateKey": "dnipro-weekly"
}
```

### Output

Each run produces a dataset of structured CV records. Results can be downloaded as JSON, CSV, or Excel from the Dataset tab in Apify Console.

#### Example job record

```json
{
  "resumeId": 25379811,
  "userId": 8004200,
  "sourceUrl": "https://robota.ua/candidates/25379811",
  "source": "robota.ua",
  "firstName": "Ольга",
  "patronymic": null,
  "age": "41",
  "birthDate": "1985-04-08T00:00:00",
  "sex": 0,
  "photoUrl": null,
  "cityId": 4,
  "cityName": "Дніпро",
  "districtIds": [],
  "relocationCityIds": [],
  "speciality": "HR-менеджер",
  "salaryExpected": 35000,
  "salaryCurrency": "грн.",
  "salaryDisplay": "35000 грн.",
  "scheduleIds": [
    1
  ],
  "scheduleNames": [
    "повна зайнятість"
  ],
  "branchIds": [],
  "branchNames": [],
  "rubrics": [
    {
      "id": 30,
      "name": "Студенти - Початок кар'єри - Без досвіду"
    }
  ],
  "experienceSummary": [
    {
      "company": "АТ \"ВСТ БАНК\"",
      "position": "Старший инспектор по кадрам",
      "startDate": "вер 2024",
      "endDate": "до сьогодні",
      "datesDiff": "1 рік 7 міс",
      "beginWork": "2024-09-01T00:00:00+03:00",
      "finishWork": null
    }
  ],
  "experiences": [
    {
      "position": "Старший инспектор по кадрам",
      "company": "АТ \"ВСТ БАНК\"",
      "companySite": null,
      "branchId": 8,
      "branchName": "Банки",
      "description": "Прийом, переведення і звільнення працівників відповідно до вимог чинного законодавства та внутрішніх регламентів. Ведення особових справ, внесення змін, пов’язаних із трудовою діяльністю працівників. Формування наказів з особового складу, внесення інформації щодо відсутності працівників. Виконання розпоряджень керівника стосовно кадрової роботи.\n\n- Адаптація до нових умов роботи\n\n- Здійснення контролю за якістю виконуваних робіт та процесів\n\n- Дотримання корпоративної культури та цінностей\n\n- Встановлення пріоритетів для ефективного виконання завдань\n\n- Дотримання корпоративної культури та цінностей",
      "descriptionHtml": "<p>Прийом, переведення і звільнення працівників відповідно до вимог чинного законодавства та внутрішніх регламентів. Ведення особових справ, внесення змін, пов’язаних із трудовою діяльністю працівників. Формування наказів з особового складу, внесення інформації щодо відсутності працівників. Виконання розпоряджень керівника стосовно кадрової роботи.</p><ul><li>Адаптація до нових умов роботи</li></ul><ul><li>Здійснення контролю за якістю виконуваних робіт та процесів</li></ul><ul><li>Дотримання корпоративної культури та цінностей</li></ul><ul><li>Встановлення пріоритетів для ефективного виконання завдань</li></ul><ul><li>Дотримання корпоративної культури та цінностей</li></ul>",
      "startDate": "2024-09-01T00:00:00",
      "endDate": null,
      "period": "1 {1} 7 {0}"
    }
  ],
  "experienceYears": null,
  "educations": [],
  "educationLevelId": null,
  "educationLevel": null,
  "skillsHtml": "<ul><li>Відповідальність</li></ul><ul><li>Організованість</li></ul><ul><li>Комунікаційні навички</li></ul><ul><li>Вміння мотивувати</li></ul><ul><li>Кадрове діловодство</li></ul><ul><li>Підбір ІТ перс...",
  "skillsText": "- Відповідальність\n\n- Організованість\n\n- Комунікаційні навички\n\n- Вміння мотивувати\n\n- Кадрове діловодство\n\n- Підбір ІТ персоналу\n\n- Підбір персоналу",
  "additionals": [],
  "languages": [],
  "professionLevelId": 0,
  "activityLevel": "None",
  "skype": null,
  "diiaCertificate": null,
  "isAnonymous": false,
  "isOnline": true,
  "isVerified": false,
  "isStudent": false,
  "isDisabled": false,
  "isVeteran": false,
  "hasOwnCar": false,
  "hasFile": false,
  "hasPhone": true,
  "isHasTextSection": false,
  "fillingPercentage": 65,
  "fillingTypeId": 3,
  "fillingTypeName": "Розширене",
  "addedAt": "2026-04-12T11:12:46.99",
  "updatedAt": "2026-04-12T11:12:46.99",
  "lastActivityAt": "2026-04-12T08:16:07.291",
  "matchedKeywords": [],
  "matchedIn": {
    "speciality": false,
    "keywords": false,
    "description": false,
    "experiencePosition": false,
    "experienceCompany": false,
    "fullName": false
  },
  "searchFingerprint": "266bd3dc8ff62d32",
  "contentQuality": "full",
  "detailFetched": true,
  "scrapedAt": "2026-04-12T08:24:47.165Z",
  "changeType": "NEW"
}
```

### Limitations

- **No contact information** — surnames, email addresses, and phone numbers are paywalled by robota.ua. Accessing contact details requires a paid employer subscription purchased directly from robota.ua. This actor cannot bypass that restriction.
- **Uploaded-only CVs (~0.5%)** — some candidates upload a PDF without filling in structured fields. These return `contentQuality: "thin"` with empty career arrays. Filtered out by default (`excludeUploadedOnly: true`).
- **No file downloads** — uploaded PDF/DOC files are not downloadable via the API.

### How to scrape robota.ua's CV database

1. Go to [robota.ua CV/Resume Database Scraper](https://apify.com/blackfalcondata/robota-ua-cv-scraper) in Apify Console.
2. Enter search keywords (or leave empty to browse all CVs).
3. Set `maxResults` to control how many CVs you need.
4. Enable `fetchDetail` if you need full career history, skills, and education data.
5. Click **Start** and wait for the run to finish.
6. Export the dataset as JSON, CSV, or Excel.

### Use cases

- Source candidates from Ukraine's largest job board for recruitment and talent mapping.
- Track salary expectations across regions, industries, and experience levels over time.
- Monitor new and changed CVs on scheduled runs without processing the full database every time.
- Build talent pipelines using structured career data, skills, and language proficiency.
- Research labor market dynamics — education levels, relocation willingness, and industry distribution.
- Feed structured candidate data into AI agents, MCP tools, and automated pipelines using compact mode.
- Export clean, structured data to dashboards, spreadsheets, or data warehouses.
- Analyze skill supply across the Ukrainian job market using structured skill tags.

### How much does it cost to scrape robota.ua?

robota.ua CV/Resume Database Scraper uses [pay-per-event](https://docs.apify.com/platform/actors/paid-actors/pay-per-event) pricing. You pay a small fee when the run starts and then for each result that is actually produced.

- **Run start:** $0.01 per run
- **Per result:** $0.002 per CV record

Example costs:

- 10 results: **$0.03**
- 100 results: **$0.21**
- 500 results: **$1.01**

#### Example: recurring monitoring savings

These examples compare full re-scrapes with incremental runs at different churn rates. Churn is the share of listings that are new or whose tracked content changed since the previous run. Actual churn depends on your query breadth, source activity, and polling frequency — the scenarios below are examples, not predictions.

Example setup: 250 results per run, daily polling (30 runs/month). Event-pricing examples scale linearly with result count.

| Churn rate | Full re-scrape run cost | Incremental run cost | Savings vs full re-scrape | Monthly cost after baseline |
|---|---:|---:|---:|---:|
| 5% — stable niche query | $0.51 | $0.04 | $0.47 (93%) | $1.05 |
| 15% — moderate broad query | $0.51 | $0.08 | $0.43 (83%) | $2.55 |
| 30% — high-volume aggregator | $0.51 | $0.16 | $0.35 (69%) | $4.80 |

Full re-scrape monthly cost at daily polling: $15.30. First month with incremental costs $1.53 / $2.97 / $5.15 for the 5% / 15% / 30% scenarios because the first run builds baseline state at full cost before incremental savings apply.

Platform usage (compute and proxies) is billed separately by Apify based on actual consumption. Incremental runs consume less on result processing, though fixed per-run overhead stays the same.

### FAQ

#### How many CVs can I get from robota.ua?

robota.ua's CVDB contains 5M+ candidate profiles. The number of results depends on your search filters. Use the `maxResults` parameter to control how many CVs are returned per run.

#### Can I get contact information (email, phone, surname)?

No. Surnames, email addresses, and phone numbers are paywalled by robota.ua and require an employer account purchase. This actor only extracts publicly accessible data (first name, patronymic, career data).

#### What are "uploaded-only" CVs?

About 0.5% of CVs on robota.ua are uploaded as PDF/DOC without filling in structured fields. These return `contentQuality: "thin"` with empty career arrays. By default, they are filtered out (`excludeUploadedOnly: true`).

#### Does robota.ua CV/Resume Database Scraper support recurring monitoring?

Yes. Enable incremental mode to only receive new or changed CVs on subsequent runs. This is ideal for scheduled monitoring where you want to track talent market changes over time without re-processing the full dataset.

#### Can I integrate robota.ua CV/Resume Database Scraper with other apps?

Yes. robota.ua CV/Resume Database Scraper works with Apify's [integrations](https://apify.com/integrations) to connect with tools like Zapier, Make, Google Sheets, Slack, and more. You can also use webhooks to trigger actions when a run completes.

#### Can I use robota.ua CV/Resume Database Scraper with the Apify API?

Yes. You can start runs, manage inputs, and retrieve results programmatically through the [Apify API](https://docs.apify.com/api/v2). Client libraries are available for JavaScript, Python, and other languages.

#### Can I use robota.ua CV/Resume Database Scraper through an MCP Server?

Yes. Apify provides an [MCP Server](https://apify.com/apify/actors-mcp-server) that lets AI assistants and agents call this actor directly. Use compact mode to keep payloads manageable for LLM context windows.

#### Is it legal to scrape robota.ua?

This actor extracts publicly available data from robota.ua. Web scraping of public information is generally considered legal, but you should always review the target site's terms of service and ensure your use case complies with applicable laws and regulations, including GDPR where relevant.

#### Personal data and data processing responsibilities

This actor extracts personal data as defined under GDPR (names, age, career history, education, location, and other profile information). **You are the data controller** for any personal data you collect using this actor. It is your responsibility to:

- Have a valid legal basis for processing (e.g. legitimate interest under Art. 6(1)(f) GDPR for recruitment purposes).
- Comply with data subject rights (access, erasure, rectification) if contacted by individuals whose data you process.
- Implement appropriate technical and organizational measures to protect the data.
- Conduct a Data Protection Impact Assessment (DPIA) if processing at scale.
- Ensure compliance with Ukrainian data protection law (Law on Personal Data Protection) in addition to GDPR where applicable.

Neither the actor developer nor Apify acts as a data processor on your behalf — the data is delivered directly to your Apify dataset, and you control its storage, use, and deletion.

#### Your feedback

If you have questions, need a feature, or found a bug, please [open an issue](https://apify.com/blackfalcondata/robota-ua-cv-scraper/issues) on the actor's page in Apify Console. Your feedback helps us improve.

### You might also like

- [Adzuna Job Scraper](https://apify.com/blackfalcondata/adzuna-scraper) — Scrape adzuna.com — the global job board with 20+ country markets. Structured salary.
- [Arbeitsagentur Scraper — German Jobs](https://apify.com/blackfalcondata/arbeitsagentur-scraper) — Scrape arbeitsagentur.de — Germany’s official employment portal with 1M+ listings. Contact data,.
- [Bayt.com Scraper — Jobs from the Middle East](https://apify.com/blackfalcondata/bayt-scraper) — Scrape bayt.com — the leading Middle East job board. Salary data, experience requirements.
- [Bumeran Scraper](https://apify.com/blackfalcondata/bumeran-scraper) — Scrape bumeran.com.ar — the largest job board across 8 LATAM countries. Work modality, contract.
- [Cadremploi Job Scraper](https://apify.com/blackfalcondata/cadremploi-scraper) — Scrape cadremploi.fr — French management and executive jobs. Salary ranges, apply links.
- [Dice.com Job Scraper — U.S. Tech Jobs](https://apify.com/blackfalcondata/dice-com-job-scraper) — Scrape dice.com — the leading U.S. tech job board. Structured salary (min/max/currency),.
- [Drushim Scraper — Israel Job Listings](https://apify.com/blackfalcondata/drushim-scraper) — Scrape drushim.co.il — Israel’s leading job board. Geo-coordinates per listing, multi-filter search.
- [Duunitori Scraper — Finland Job Listings](https://apify.com/blackfalcondata/duunitori-scraper) — Scrape duunitori.fi — Finland’s largest job board with 22,000+ listings. Salary ranges, employment.

# Actor input Schema

## `keywords` (type: `string`):

Free-text search across CV fields (speciality, skills, experience descriptions). Leave empty to browse all CVs.

## `cityId` (type: `integer`):

Filter by candidate's city. 0 = all cities. Common IDs: 1=Kyiv, 2=Lviv, 3=Odesa, 4=Dnipro, 6=Donetsk, 9=Zaporizhzhia, 21=Kharkiv. Full list: GET https://api.robota.ua/dictionary/city

## `rubricIds` (type: `array`):

Filter by industry rubrics from /values/rubrics. Example: \[1] = IT.

## `branchIds` (type: `array`):

Filter by business branch from /dictionary/branch.

## `scheduleIds` (type: `array`):

Work schedule filter. 1=full-time, 2=part-time, 3=shift, 4=internship, 5=remote.

## `experienceIds` (type: `array`):

0=no experience, 1=up to 1yr, 2=1-2yr, 3=2-5yr, 4=5-10yr, 5=10+yr.

## `educationIds` (type: `array`):

Education filter from /dictionary/education.

## `languages` (type: `array`):

Language requirements from /values/languagelist. 1=English, 4=German, etc.

## `ageFrom` (type: `integer`):

Filter candidates at or above this age.

## `ageTo` (type: `integer`):

Filter candidates at or below this age.

## `sex` (type: `string`):

Gender filter.

## `salaryFrom` (type: `integer`):

Minimum salary expectation (in selected currency).

## `salaryTo` (type: `integer`):

Maximum salary expectation.

## `currencyId` (type: `integer`):

1=UAH (default), 2=USD, 3=EUR.

## `showCvWithoutSalary` (type: `boolean`):

Include candidates who haven't declared a salary expectation.

## `period` (type: `string`):

Only include CVs active within this period.

## `sort` (type: `string`):

How to sort results.

## `searchType` (type: `string`):

Keyword matching strategy.

## `ukrainian` (type: `boolean`):

Search using Ukrainian language variant.

## `inside` (type: `boolean`):

When cityId is set, also include candidates from the surrounding oblast.

## `moveability` (type: `boolean`):

Include candidates from other cities willing to relocate. When used with cityId, results may include candidates not currently in that city. Set to false for strict city-only results.

## `onlyMoveability` (type: `boolean`):

Only candidates willing to relocate.

## `hasPhoto` (type: `boolean`):

Only include CVs with a profile photo.

## `onlyStudents` (type: `boolean`):

Only include student candidates.

## `onlyDisabled` (type: `boolean`):

Only include candidates with disability status.

## `onlyVeterans` (type: `boolean`):

Only include veteran candidates.

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

Maximum total CVs to return. 0 = unlimited. Critical: default queries match 190,000+ CVs.

## `maxPages` (type: `integer`):

Alternative cap by listing pages (20 CVs per page). 0 = unlimited, capped by maxResults.

## `fetchDetail` (type: `boolean`):

Fetch /resume/{id} for each CV to get experiences, educations, skills, languages. Disable for listing-only mode (faster, less data).

## `excludeUploadedOnly` (type: `boolean`):

Filter out CVs that only have an uploaded PDF (no structured data in JSON). Affects ~0.5% of results.

## `minFillingPercentage` (type: `integer`):

Only include CVs with at least N% completion (0-100). Higher = richer data quality.

## `compact` (type: `boolean`):

Strip heavy HTML description fields. Returns identity + summary only (for AI-agent/MCP workflows).

## `incrementalMode` (type: `boolean`):

Only emit new/updated CVs since last run. Requires stateKey.

## `stateKey` (type: `string`):

Stable identifier for incremental state. State is automatically scoped per search filter combination.

## `emitUnchanged` (type: `boolean`):

In incremental mode, also emit CVs that haven't changed (with changeType='unchanged').

## `emitExpired` (type: `boolean`):

In incremental mode, also emit CVs that disappeared from results (with changeType='expired').

## Actor input object example

```json
{
  "keywords": "software engineer",
  "cityId": 0,
  "rubricIds": [],
  "branchIds": [],
  "scheduleIds": [],
  "experienceIds": [],
  "educationIds": [],
  "languages": [],
  "sex": "Any",
  "currencyId": 1,
  "showCvWithoutSalary": true,
  "period": "ThreeMonths",
  "sort": "UpdateDate",
  "searchType": "WithSynonyms",
  "ukrainian": true,
  "inside": false,
  "moveability": true,
  "onlyMoveability": false,
  "hasPhoto": false,
  "onlyStudents": false,
  "onlyDisabled": false,
  "onlyVeterans": false,
  "maxResults": 20,
  "maxPages": 0,
  "fetchDetail": true,
  "excludeUploadedOnly": true,
  "minFillingPercentage": 0,
  "compact": false,
  "incrementalMode": false,
  "emitUnchanged": false,
  "emitExpired": false
}
```

# 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 = {
    "keywords": "software engineer",
    "maxResults": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("blackfalcondata/robota-ua-cv-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 = {
    "keywords": "software engineer",
    "maxResults": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("blackfalcondata/robota-ua-cv-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 '{
  "keywords": "software engineer",
  "maxResults": 20
}' |
apify call blackfalcondata/robota-ua-cv-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=blackfalcondata/robota-ua-cv-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Robota.ua CV/Resume Database Scraper",
        "description": "Scrape robota.ua candidate/CV database (CVDB) with 40+ filters including keywords, city, industry, experience, education, and salary. Returns structured career profiles with work history, skills, and languages for 5M+ Ukrainian job seekers. Incremental tracking.",
        "version": "0.1",
        "x-build-id": "VD1fy3c50rQcdWNVh"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/blackfalcondata~robota-ua-cv-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-blackfalcondata-robota-ua-cv-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        },
        "/acts/blackfalcondata~robota-ua-cv-scraper/runs": {
            "post": {
                "operationId": "runs-sync-blackfalcondata-robota-ua-cv-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor and returns information about the initiated run in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "$ref": "#/components/schemas/runsResponseSchema"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/acts/blackfalcondata~robota-ua-cv-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-blackfalcondata-robota-ua-cv-scraper",
                "x-openai-isConsequential": false,
                "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.",
                "tags": [
                    "Run Actor"
                ],
                "requestBody": {
                    "required": true,
                    "content": {
                        "application/json": {
                            "schema": {
                                "$ref": "#/components/schemas/inputSchema"
                            }
                        }
                    }
                },
                "parameters": [
                    {
                        "name": "token",
                        "in": "query",
                        "required": true,
                        "schema": {
                            "type": "string"
                        },
                        "description": "Enter your Apify token here"
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK"
                    }
                }
            }
        }
    },
    "components": {
        "schemas": {
            "inputSchema": {
                "type": "object",
                "properties": {
                    "keywords": {
                        "title": "Keywords",
                        "type": "string",
                        "description": "Free-text search across CV fields (speciality, skills, experience descriptions). Leave empty to browse all CVs."
                    },
                    "cityId": {
                        "title": "City ID",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Filter by candidate's city. 0 = all cities. Common IDs: 1=Kyiv, 2=Lviv, 3=Odesa, 4=Dnipro, 6=Donetsk, 9=Zaporizhzhia, 21=Kharkiv. Full list: GET https://api.robota.ua/dictionary/city",
                        "default": 0
                    },
                    "rubricIds": {
                        "title": "Industry Rubric IDs",
                        "type": "array",
                        "description": "Filter by industry rubrics from /values/rubrics. Example: [1] = IT.",
                        "items": {
                            "type": "integer"
                        },
                        "default": []
                    },
                    "branchIds": {
                        "title": "Branch IDs",
                        "type": "array",
                        "description": "Filter by business branch from /dictionary/branch.",
                        "items": {
                            "type": "integer"
                        },
                        "default": []
                    },
                    "scheduleIds": {
                        "title": "Schedule IDs",
                        "type": "array",
                        "description": "Work schedule filter. 1=full-time, 2=part-time, 3=shift, 4=internship, 5=remote.",
                        "items": {
                            "type": "integer"
                        },
                        "default": []
                    },
                    "experienceIds": {
                        "title": "Experience Level IDs",
                        "type": "array",
                        "description": "0=no experience, 1=up to 1yr, 2=1-2yr, 3=2-5yr, 4=5-10yr, 5=10+yr.",
                        "items": {
                            "type": "integer"
                        },
                        "default": []
                    },
                    "educationIds": {
                        "title": "Education Level IDs",
                        "type": "array",
                        "description": "Education filter from /dictionary/education.",
                        "items": {
                            "type": "integer"
                        },
                        "default": []
                    },
                    "languages": {
                        "title": "Language IDs",
                        "type": "array",
                        "description": "Language requirements from /values/languagelist. 1=English, 4=German, etc.",
                        "items": {
                            "type": "integer"
                        },
                        "default": []
                    },
                    "ageFrom": {
                        "title": "Minimum Age",
                        "minimum": 14,
                        "type": "integer",
                        "description": "Filter candidates at or above this age."
                    },
                    "ageTo": {
                        "title": "Maximum Age",
                        "maximum": 100,
                        "type": "integer",
                        "description": "Filter candidates at or below this age."
                    },
                    "sex": {
                        "title": "Sex Filter",
                        "enum": [
                            "Any",
                            "Male",
                            "Female"
                        ],
                        "type": "string",
                        "description": "Gender filter.",
                        "default": "Any"
                    },
                    "salaryFrom": {
                        "title": "Minimum Expected Salary",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Minimum salary expectation (in selected currency)."
                    },
                    "salaryTo": {
                        "title": "Maximum Expected Salary",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum salary expectation."
                    },
                    "currencyId": {
                        "title": "Salary Currency ID",
                        "type": "integer",
                        "description": "1=UAH (default), 2=USD, 3=EUR.",
                        "default": 1
                    },
                    "showCvWithoutSalary": {
                        "title": "Include CVs Without Salary",
                        "type": "boolean",
                        "description": "Include candidates who haven't declared a salary expectation.",
                        "default": true
                    },
                    "period": {
                        "title": "Activity Period",
                        "enum": [
                            "Day",
                            "Week",
                            "Month",
                            "ThreeMonths",
                            "Year",
                            "All"
                        ],
                        "type": "string",
                        "description": "Only include CVs active within this period.",
                        "default": "ThreeMonths"
                    },
                    "sort": {
                        "title": "Sort Order",
                        "enum": [
                            "UpdateDate",
                            "Relevance",
                            "Age",
                            "Salary"
                        ],
                        "type": "string",
                        "description": "How to sort results.",
                        "default": "UpdateDate"
                    },
                    "searchType": {
                        "title": "Search Type",
                        "enum": [
                            "WithSynonyms",
                            "Exact",
                            "Expanded"
                        ],
                        "type": "string",
                        "description": "Keyword matching strategy.",
                        "default": "WithSynonyms"
                    },
                    "ukrainian": {
                        "title": "Ukrainian Language Search",
                        "type": "boolean",
                        "description": "Search using Ukrainian language variant.",
                        "default": true
                    },
                    "inside": {
                        "title": "Include Surrounding Region",
                        "type": "boolean",
                        "description": "When cityId is set, also include candidates from the surrounding oblast.",
                        "default": false
                    },
                    "moveability": {
                        "title": "Include Relocatable",
                        "type": "boolean",
                        "description": "Include candidates from other cities willing to relocate. When used with cityId, results may include candidates not currently in that city. Set to false for strict city-only results.",
                        "default": true
                    },
                    "onlyMoveability": {
                        "title": "Only Relocatable",
                        "type": "boolean",
                        "description": "Only candidates willing to relocate.",
                        "default": false
                    },
                    "hasPhoto": {
                        "title": "Only With Photo",
                        "type": "boolean",
                        "description": "Only include CVs with a profile photo.",
                        "default": false
                    },
                    "onlyStudents": {
                        "title": "Only Students",
                        "type": "boolean",
                        "description": "Only include student candidates.",
                        "default": false
                    },
                    "onlyDisabled": {
                        "title": "Only Disabled",
                        "type": "boolean",
                        "description": "Only include candidates with disability status.",
                        "default": false
                    },
                    "onlyVeterans": {
                        "title": "Only Veterans",
                        "type": "boolean",
                        "description": "Only include veteran candidates.",
                        "default": false
                    },
                    "maxResults": {
                        "title": "Max Results",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum total CVs to return. 0 = unlimited. Critical: default queries match 190,000+ CVs.",
                        "default": 100
                    },
                    "maxPages": {
                        "title": "Max Pages",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Alternative cap by listing pages (20 CVs per page). 0 = unlimited, capped by maxResults.",
                        "default": 0
                    },
                    "fetchDetail": {
                        "title": "Fetch Full CV Detail",
                        "type": "boolean",
                        "description": "Fetch /resume/{id} for each CV to get experiences, educations, skills, languages. Disable for listing-only mode (faster, less data).",
                        "default": true
                    },
                    "excludeUploadedOnly": {
                        "title": "Exclude Uploaded-Only CVs",
                        "type": "boolean",
                        "description": "Filter out CVs that only have an uploaded PDF (no structured data in JSON). Affects ~0.5% of results.",
                        "default": true
                    },
                    "minFillingPercentage": {
                        "title": "Minimum Filling %",
                        "minimum": 0,
                        "maximum": 100,
                        "type": "integer",
                        "description": "Only include CVs with at least N% completion (0-100). Higher = richer data quality.",
                        "default": 0
                    },
                    "compact": {
                        "title": "Compact Output",
                        "type": "boolean",
                        "description": "Strip heavy HTML description fields. Returns identity + summary only (for AI-agent/MCP workflows).",
                        "default": false
                    },
                    "incrementalMode": {
                        "title": "Incremental Mode",
                        "type": "boolean",
                        "description": "Only emit new/updated CVs since last run. Requires stateKey.",
                        "default": false
                    },
                    "stateKey": {
                        "title": "State Key",
                        "type": "string",
                        "description": "Stable identifier for incremental state. State is automatically scoped per search filter combination."
                    },
                    "emitUnchanged": {
                        "title": "Emit Unchanged",
                        "type": "boolean",
                        "description": "In incremental mode, also emit CVs that haven't changed (with changeType='unchanged').",
                        "default": false
                    },
                    "emitExpired": {
                        "title": "Emit Expired",
                        "type": "boolean",
                        "description": "In incremental mode, also emit CVs that disappeared from results (with changeType='expired').",
                        "default": false
                    }
                }
            },
            "runsResponseSchema": {
                "type": "object",
                "properties": {
                    "data": {
                        "type": "object",
                        "properties": {
                            "id": {
                                "type": "string"
                            },
                            "actId": {
                                "type": "string"
                            },
                            "userId": {
                                "type": "string"
                            },
                            "startedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "finishedAt": {
                                "type": "string",
                                "format": "date-time",
                                "example": "2025-01-08T00:00:00.000Z"
                            },
                            "status": {
                                "type": "string",
                                "example": "READY"
                            },
                            "meta": {
                                "type": "object",
                                "properties": {
                                    "origin": {
                                        "type": "string",
                                        "example": "API"
                                    },
                                    "userAgent": {
                                        "type": "string"
                                    }
                                }
                            },
                            "stats": {
                                "type": "object",
                                "properties": {
                                    "inputBodyLen": {
                                        "type": "integer",
                                        "example": 2000
                                    },
                                    "rebootCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "restartCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "resurrectCount": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "computeUnits": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "options": {
                                "type": "object",
                                "properties": {
                                    "build": {
                                        "type": "string",
                                        "example": "latest"
                                    },
                                    "timeoutSecs": {
                                        "type": "integer",
                                        "example": 300
                                    },
                                    "memoryMbytes": {
                                        "type": "integer",
                                        "example": 1024
                                    },
                                    "diskMbytes": {
                                        "type": "integer",
                                        "example": 2048
                                    }
                                }
                            },
                            "buildId": {
                                "type": "string"
                            },
                            "defaultKeyValueStoreId": {
                                "type": "string"
                            },
                            "defaultDatasetId": {
                                "type": "string"
                            },
                            "defaultRequestQueueId": {
                                "type": "string"
                            },
                            "buildNumber": {
                                "type": "string",
                                "example": "1.0.0"
                            },
                            "containerUrl": {
                                "type": "string"
                            },
                            "usage": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "integer",
                                        "example": 1
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            },
                            "usageTotalUsd": {
                                "type": "number",
                                "example": 0.00005
                            },
                            "usageUsd": {
                                "type": "object",
                                "properties": {
                                    "ACTOR_COMPUTE_UNITS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATASET_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "KEY_VALUE_STORE_WRITES": {
                                        "type": "number",
                                        "example": 0.00005
                                    },
                                    "KEY_VALUE_STORE_LISTS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_READS": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "REQUEST_QUEUE_WRITES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_INTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "DATA_TRANSFER_EXTERNAL_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_RESIDENTIAL_TRANSFER_GBYTES": {
                                        "type": "integer",
                                        "example": 0
                                    },
                                    "PROXY_SERPS": {
                                        "type": "integer",
                                        "example": 0
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```