# Hh Uz Scraper (`unfenced-group/hh-uz-scraper`) Actor

Scrape hh.uz for structured Uzbekistan job listings with salary, location, skills, and full descriptions. No API key needed.

- **URL**: https://apify.com/unfenced-group/hh-uz-scraper.md
- **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community)
- **Categories:** Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.79 / 1,000 job listings

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

## HH.UZ Scraper — Uzbekistan Jobs

![Banner](https://api.apify.com/v2/key-value-stores/lJlifu6C8YQfZMPKE/records/hh-uz-scraper.png)

Extract structured job listings from [hh.uz](https://hh.uz) — Uzbekistan's largest job board with tens of thousands of active vacancies. Returns up to 2,000 results per run across all cities and industries. No API key required.

---

### Why this scraper?

#### 📋 26 structured fields per vacancy
Vacancy ID, title, employer name and ID, city, salary range with currency and gross/net flag, experience level, employment type, work schedule, work format, key skills, full description in HTML/text/Markdown, publication date, and more.

#### 💰 Salary in Uzbekistani som (UZS) and major currencies
Captures salary minimum, maximum, currency (UZS, USD, EUR, RUB), gross/net indicator, and payment frequency (monthly, bi-weekly, weekly).

#### 🔍 Powerful filtering
Filter by keyword, city/region, experience level, employment type, work schedule (including remote), salary presence, and date range. Combine filters freely.

#### 📄 Full job descriptions
Enable `fetchDetails` to retrieve the complete vacancy text in HTML, plain text, and Markdown — plus key skills, exact street address, work format details, and application deadline.

#### 🔄 Repost detection
Enable `skipReposts` to deduplicate across runs. The scraper remembers every vacancy ID for 90 days and skips anything already seen — ideal for daily feeds.

#### 🎯 Direct URL mode
Supply a list of hh.uz vacancy URLs via `startUrls` to scrape specific postings directly, bypassing search entirely.

---

### Input parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `searchQuery` | string | `""` | Keywords to search (job title, skill, etc.). Empty = all vacancies. |
| `areaId` | string | `"97"` | Area code. `97` = all of Uzbekistan. Use city codes for narrower results (e.g. `2603` = Tashkent). |
| `experience` | select | `""` | Experience level: `noExperience`, `between1And3`, `between3And6`, `moreThan6`. |
| `employment` | select | `""` | Employment type: `full`, `part`, `project`, `volunteer`, `probation`. |
| `schedule` | select | `""` | Work schedule: `fullDay`, `shift`, `flexible`, `remote`, `flyInFlyOut`. |
| `workFormat` | select | `""` | Work format: `onsite`, `remote`, `hybrid`. |
| `onlyWithSalary` | boolean | `false` | Return only vacancies with a published salary range. |
| `orderBy` | select | `""` | Sort order: `relevance`, `publication_time`, `salary_desc`, `salary_asc`. |
| `fetchDetails` | boolean | `false` | Fetch full description and all structured fields from each vacancy page. |
| `skipReposts` | boolean | `false` | Skip vacancies already seen in previous runs (90-day memory). |
| `maxResults` | integer | `5` | Maximum results to return. `0` = unlimited (platform cap: 2,000). |
| `daysOld` | integer | — | Only return vacancies posted within this many days. |
| `dateFrom` | string | `""` | Return vacancies posted on or after this date (YYYY-MM-DD). |
| `dateTo` | string | `""` | Return vacancies posted on or before this date (YYYY-MM-DD). |
| `startUrls` | array | `[]` | Specific hh.uz vacancy URLs to scrape directly. Bypasses search. |

---

### Output schema

#### Always present

| Field | Type | Description |
|-------|------|-------------|
| `vacancyId` | string | Unique hh.uz vacancy identifier. |
| `title` | string | Job title as listed by the employer. |
| `url` | string | Direct URL to the vacancy on hh.uz. |
| `employerName` | string\|null | Employer or company name. |
| `employerLogoUrl` | string\|null | URL to employer logo thumbnail. |
| `isTrusted` | boolean | Whether the employer has a trusted employer badge. |
| `city` | string\|null | City extracted from the location field. |
| `country` | string | Always `"UZ"`. |
| `locationRaw` | string\|null | Raw location text (e.g. `"Ташкент, улица Кирк-Киз, 10"`). |
| `salaryFrom` | number\|null | Minimum salary (null if not published by employer). |
| `salaryTo` | number\|null | Maximum salary (null if not published by employer). |
| `salaryCurrency` | string\|null | Salary currency: `UZS`, `USD`, `EUR`, `RUB`, or null. |
| `salaryGross` | boolean\|null | `true` = gross (before tax), `false` = net, `null` = unspecified. |
| `salaryRaw` | string\|null | Raw salary string as displayed (e.g. `"от 8 000 000 до 13 000 000 so'm"`). |
| `salaryFrequency` | string\|null | Payment frequency: `MONTHLY`, `TWICE_PER_MONTH`, `WEEKLY`, or null. |
| `experienceBadge` | string\|null | Experience badge from listing: `noExperience`, `between1And3`, `between3And6`, `moreThan6`. |
| `isRemote` | boolean | Whether the vacancy is remote-eligible (from listing label or work format). |
| `isRepost` | boolean | `true` if this vacancy was seen in a previous run (requires `skipReposts: true`). |
| `originalPublishDate` | string\|null | First publication date if repost; null otherwise. |
| `originalUrl` | string\|null | Original vacancy URL if repost; null otherwise. |
| `source` | string | Always `"hh.uz"`. |
| `scrapedAt` | string | ISO 8601 timestamp of when this record was scraped. |
| `contentHash` | string | MD5 fingerprint of vacancy ID + title for change detection. |

#### With `fetchDetails: true`

| Field | Type | Description |
|-------|------|-------------|
| `employerId` | string\|null | hh.uz internal employer ID. |
| `publishedAt` | string\|null | Publication datetime ISO 8601. |
| `publishDate` | string\|null | Publication date YYYY-MM-DD. |
| `validThrough` | string\|null | Application deadline ISO 8601. |
| `streetAddress` | string\|null | Full street address of the workplace. |
| `addressLocality` | string\|null | City from the structured address schema. |
| `addressCountry` | string | Country code from structured address (usually `"UZ"`). |
| `experienceRaw` | string\|null | Experience requirement as displayed (e.g. `"1–3 года"`). |
| `employmentRaw` | string\|null | Employment type as displayed (e.g. `"Полная занятость"`). |
| `scheduleRaw` | string\|null | Work schedule as displayed (e.g. `"График: 5/2"`). |
| `workFormatRaw` | string\|null | Work format as displayed (e.g. `"на месте работодателя"`). |
| `hiringFormatRaw` | string\|null | Hiring format details from vacancy page. |
| `workingHours` | string\|null | Daily working hours (e.g. `"8"`). |
| `applicantLocReq` | array | Countries eligible to apply (e.g. `["Узбекистан"]`). |
| `descriptionHtml` | string\|null | Full job description in raw HTML. |
| `descriptionText` | string\|null | Full job description as plain text. |
| `descriptionMarkdown` | string\|null | Full job description in Markdown. |
| `keySkills` | array | List of required skills (e.g. `["Python", "Django", "PostgreSQL"]`). |

#### JSON example

```json
{
  "vacancyId": "134750046",
  "title": "Middle Back-end разработчик",
  "url": "https://hh.uz/vacancy/134750046",
  "employerName": "OOO UZGPS",
  "employerId": "8820311",
  "employerLogoUrl": "https://img.hhcdn.ru/employer-logo/8820311.png",
  "isTrusted": false,
  "city": "Ташкент",
  "country": "UZ",
  "locationRaw": "Ташкент, улица Кирк-Киз, 10",
  "streetAddress": "улица Кирк-Киз, 10",
  "addressLocality": "Ташкент",
  "addressCountry": "UZ",
  "salaryFrom": 8000000,
  "salaryTo": 13000000,
  "salaryCurrency": "UZS",
  "salaryGross": true,
  "salaryRaw": "от 8 000 000 до 13 000 000 so'm за месяц до вычета налогов",
  "salaryFrequency": "MONTHLY",
  "experienceBadge": "between1And3",
  "experienceRaw": "1–3 года",
  "employmentRaw": "Полная занятость",
  "scheduleRaw": "График: 5/2",
  "workFormatRaw": "на месте работодателя",
  "hiringFormatRaw": null,
  "workingHours": "8",
  "isRemote": false,
  "applicantLocReq": ["Узбекистан"],
  "publishedAt": "2026-07-01T13:13:07.200+03:00",
  "validThrough": "2026-07-31T13:13:07.219+03:00",
  "publishDate": "2026-07-01",
  "descriptionHtml": "<strong>Обязанности:</strong><ul><li>Проектирование и разработка API...</li></ul>",
  "descriptionText": "Обязанности: Проектирование и разработка API...",
  "descriptionMarkdown": "**Обязанности:**\n\n- Проектирование и разработка API...",
  "keySkills": ["Python", "Django", "PostgreSQL", "Docker", "REST API"],
  "isRepost": false,
  "originalPublishDate": null,
  "originalUrl": null,
  "source": "hh.uz",
  "scrapedAt": "2026-07-01T14:22:00.000Z",
  "contentHash": "a3f9d12e4c7b8e91"
}
````

***

### Examples

**Search for IT vacancies in Tashkent:**

```json
{
  "searchQuery": "разработчик",
  "areaId": "2603",
  "fetchDetails": true,
  "maxResults": 100
}
```

**Remote jobs with salary, sorted by pay:**

```json
{
  "schedule": "remote",
  "onlyWithSalary": true,
  "orderBy": "salary_desc",
  "fetchDetails": true,
  "maxResults": 50
}
```

**Scrape specific vacancies by URL:**

```json
{
  "startUrls": [
    { "url": "https://hh.uz/vacancy/134750046" },
    { "url": "https://hh.uz/vacancy/134663723" }
  ],
  "fetchDetails": true
}
```

**Daily feed — new postings only, no reposts:**

```json
{
  "daysOld": 1,
  "skipReposts": true,
  "fetchDetails": false,
  "maxResults": 0
}
```

***

### 💰 Pricing

**$0.99 per 1,000 results** — you only pay for successfully retrieved listings. Failed retries and filtered reposts are never charged.

| Results | Cost |
|---------|------|
| 100 | ~$0.10 |
| 1,000 | ~$0.99 |
| 10,000 | ~$9.90 |
| 2,000 (max) | ~$1.98 |

> Flat-rate alternatives typically charge $29–$49/month regardless of usage.

Use the **Max results** cap in the input to control your spend exactly.

***

### Performance

| Run size | Estimated time |
|----------|---------------|
| 100 results (list only) | ~30 seconds |
| 500 results (list only) | ~2 minutes |
| 100 results (with fetchDetails) | ~3 minutes |
| 500 results (with fetchDetails) | ~12 minutes |
| 2,000 results (platform max, list only) | ~8 minutes |

***

### Known limitations

- Maximum 2,000 results per search (hh.uz platform limit — 100 pages × 20 results). Use filters or multiple targeted searches to cover broader datasets.
- `publishDate` and full structured fields are only available with `fetchDetails: true`.
- Salary is null when the employer chooses not to disclose it (roughly 40–60% of listings).
- Employer logo URLs may expire or become unavailable over time.

***

### Technical details

- **Source:** hh.uz — Uzbekistan's leading job board (part of the hh.ru network)
- **Memory:** 256 MB
- **Repost storage:** KeyValueStore `hh-uz-scraper-job-dedup`, 90-day TTL
- **Retry:** Automatic retry on network errors and server errors, exponential backoff, 3 attempts per request

***

### Related scrapers

- [HH.KZ Scraper — Kazakhstan Jobs](https://apify.com/unfenced-group/hh-kz-scraper)
- [Headhunter.ru Scraper — Russia Jobs](https://apify.com/unfenced-group/headhunter-ru-scraper)
- [SEEK.com.au Scraper — Australia Jobs](https://apify.com/unfenced-group/seek-com-au-scraper)
- [Naukri.com Scraper — India Jobs](https://apify.com/unfenced-group/naukri-com-scraper)
- [Bayt.com Scraper — Middle East Jobs](https://apify.com/unfenced-group/bayt-scraper)

***

### Need a custom scraper?

**[Unfenced Group](https://www.unfencedgroup.nl)** builds Apify actors for any website — for free.

If the site you need isn't in our portfolio yet, just ask. We scope, build, and publish it at no cost to you. You only pay for results — we absorb the compute and proxy costs ourselves. Same pay-per-result pricing, same quality, same standards as every actor in this portfolio.

**Get in touch:** [www.unfencedgroup.nl](https://www.unfencedgroup.nl)

# Actor input Schema

## `searchQuery` (type: `string`):

Job title, keyword, or skill to search for. Leave empty to return all vacancies in Uzbekistan.

## `areaId` (type: `string`):

Uzbekistan area code. Default: 97 (all of Uzbekistan). Use city-level IDs for targeted results (e.g. 2603 = Tashkent). Full list at api.hh.ru/areas.

## `experience` (type: `string`):

Filter by required experience level. Leave empty for all levels.

## `employment` (type: `string`):

Filter by employment type. Leave empty for all types.

## `schedule` (type: `string`):

Filter by work schedule. Leave empty for all schedules.

## `workFormat` (type: `string`):

Filter by work format. Leave empty for all formats.

## `onlyWithSalary` (type: `boolean`):

Return only vacancies that include a salary range.

## `orderBy` (type: `string`):

Sort results by relevance or publication date.

## `fetchDetails` (type: `boolean`):

Fetch the full job description and all structured fields from each vacancy's detail page. Increases data richness significantly (adds description, key skills, exact salary with gross/net, street address, etc.) at the cost of additional requests.

## `skipReposts` (type: `boolean`):

Skip vacancies already seen in previous runs (90-day memory). Useful for scheduled daily feeds.

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

Maximum number of results to return. Set to 0 for unlimited (up to the 2,000 result platform limit).

## `daysOld` (type: `integer`):

Only return vacancies posted within this many days. Leave empty to return all.

## `dateFrom` (type: `string`):

Return only vacancies posted on or after this date. Format: YYYY-MM-DD.

## `dateTo` (type: `string`):

Return only vacancies posted on or before this date. Format: YYYY-MM-DD.

## `startUrls` (type: `array`):

List of specific hh.uz vacancy URLs to scrape directly (e.g. https://hh.uz/vacancy/12345678). Bypasses search when provided.

## Actor input object example

```json
{
  "searchQuery": "developer",
  "areaId": "97",
  "experience": "",
  "employment": "",
  "schedule": "",
  "workFormat": "",
  "onlyWithSalary": false,
  "orderBy": "",
  "fetchDetails": false,
  "skipReposts": false,
  "maxResults": 5,
  "dateFrom": "",
  "dateTo": "",
  "startUrls": []
}
```

# 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 = {
    "searchQuery": "developer"
};

// Run the Actor and wait for it to finish
const run = await client.actor("unfenced-group/hh-uz-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 = { "searchQuery": "developer" }

# Run the Actor and wait for it to finish
run = client.actor("unfenced-group/hh-uz-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 '{
  "searchQuery": "developer"
}' |
apify call unfenced-group/hh-uz-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.apify.com/?tools=unfenced-group/hh-uz-scraper",
                "--header",
                "Authorization: Bearer <YOUR_API_TOKEN>"
            ]
        }
    }
}

```

## OpenAPI specification

```json
{
    "openapi": "3.0.1",
    "info": {
        "title": "Hh Uz Scraper",
        "description": "Scrape hh.uz for structured Uzbekistan job listings with salary, location, skills, and full descriptions. No API key needed.",
        "version": "0.0",
        "x-build-id": "Txg9reS3Hn4xnbueY"
    },
    "servers": [
        {
            "url": "https://api.apify.com/v2"
        }
    ],
    "paths": {
        "/acts/unfenced-group~hh-uz-scraper/run-sync-get-dataset-items": {
            "post": {
                "operationId": "run-sync-get-dataset-items-unfenced-group-hh-uz-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/unfenced-group~hh-uz-scraper/runs": {
            "post": {
                "operationId": "runs-sync-unfenced-group-hh-uz-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/unfenced-group~hh-uz-scraper/run-sync": {
            "post": {
                "operationId": "run-sync-unfenced-group-hh-uz-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": {
                    "searchQuery": {
                        "title": "Search keywords",
                        "type": "string",
                        "description": "Job title, keyword, or skill to search for. Leave empty to return all vacancies in Uzbekistan.",
                        "default": ""
                    },
                    "areaId": {
                        "title": "Area ID",
                        "type": "string",
                        "description": "Uzbekistan area code. Default: 97 (all of Uzbekistan). Use city-level IDs for targeted results (e.g. 2603 = Tashkent). Full list at api.hh.ru/areas.",
                        "default": "97"
                    },
                    "experience": {
                        "title": "Experience level",
                        "enum": [
                            "",
                            "noExperience",
                            "between1And3",
                            "between3And6",
                            "moreThan6"
                        ],
                        "type": "string",
                        "description": "Filter by required experience level. Leave empty for all levels.",
                        "default": ""
                    },
                    "employment": {
                        "title": "Employment type",
                        "enum": [
                            "",
                            "full",
                            "part",
                            "project",
                            "volunteer",
                            "probation"
                        ],
                        "type": "string",
                        "description": "Filter by employment type. Leave empty for all types.",
                        "default": ""
                    },
                    "schedule": {
                        "title": "Work schedule",
                        "enum": [
                            "",
                            "fullDay",
                            "shift",
                            "flexible",
                            "remote",
                            "flyInFlyOut"
                        ],
                        "type": "string",
                        "description": "Filter by work schedule. Leave empty for all schedules.",
                        "default": ""
                    },
                    "workFormat": {
                        "title": "Work format",
                        "enum": [
                            "",
                            "onsite",
                            "remote",
                            "hybrid"
                        ],
                        "type": "string",
                        "description": "Filter by work format. Leave empty for all formats.",
                        "default": ""
                    },
                    "onlyWithSalary": {
                        "title": "Only with salary",
                        "type": "boolean",
                        "description": "Return only vacancies that include a salary range.",
                        "default": false
                    },
                    "orderBy": {
                        "title": "Sort order",
                        "enum": [
                            "",
                            "relevance",
                            "publication_time",
                            "salary_desc",
                            "salary_asc"
                        ],
                        "type": "string",
                        "description": "Sort results by relevance or publication date.",
                        "default": ""
                    },
                    "fetchDetails": {
                        "title": "Fetch detail pages",
                        "type": "boolean",
                        "description": "Fetch the full job description and all structured fields from each vacancy's detail page. Increases data richness significantly (adds description, key skills, exact salary with gross/net, street address, etc.) at the cost of additional requests.",
                        "default": false
                    },
                    "skipReposts": {
                        "title": "Skip reposts",
                        "type": "boolean",
                        "description": "Skip vacancies already seen in previous runs (90-day memory). Useful for scheduled daily feeds.",
                        "default": false
                    },
                    "maxResults": {
                        "title": "Max results",
                        "minimum": 0,
                        "type": "integer",
                        "description": "Maximum number of results to return. Set to 0 for unlimited (up to the 2,000 result platform limit).",
                        "default": 5
                    },
                    "daysOld": {
                        "title": "Max age (days)",
                        "minimum": 1,
                        "type": "integer",
                        "description": "Only return vacancies posted within this many days. Leave empty to return all."
                    },
                    "dateFrom": {
                        "title": "Date from (YYYY-MM-DD)",
                        "type": "string",
                        "description": "Return only vacancies posted on or after this date. Format: YYYY-MM-DD.",
                        "default": ""
                    },
                    "dateTo": {
                        "title": "Date to (YYYY-MM-DD)",
                        "type": "string",
                        "description": "Return only vacancies posted on or before this date. Format: YYYY-MM-DD.",
                        "default": ""
                    },
                    "startUrls": {
                        "title": "Start URLs",
                        "type": "array",
                        "description": "List of specific hh.uz vacancy URLs to scrape directly (e.g. https://hh.uz/vacancy/12345678). Bypasses search when provided.",
                        "default": [],
                        "items": {
                            "type": "object",
                            "required": [
                                "url"
                            ],
                            "properties": {
                                "url": {
                                    "type": "string",
                                    "title": "URL of a web page",
                                    "format": "uri"
                                }
                            }
                        }
                    }
                }
            },
            "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
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    }
}
```
