HH.kz Scraper

Scrape job vacancies from hh.kz — Kazakhstan's largest job platform with 50,000+ active listings in Russian and English. Filter by keyword, city, and recency. No API key required. No proxy needed — runs at zero proxy cost.

---

Why this scraper?

⚡ No proxy — zero extra cost

HH.kz is accessible directly from Apify datacenter IPs. No residential proxy is required, which means lower cost per result and faster throughput across Kazakhstan's largest vacancy database.

🌐 Russian and English keyword support

Search in Cyrillic ("менеджер", "бухгалтер") or Latin characters ("developer", "engineer"). HH.kz indexes vacancies in both languages — use the script that matches the job market segment you're targeting.

📄 Three description formats

When fetchDetails is enabled, full job descriptions are delivered in three formats:

Field	Format	Use case
descriptionHtml	Raw HTML	Rendering in web apps
descriptionText	Plain text	ATS import, full-text search
descriptionMarkdown	Markdown	RAG pipelines, LLM agents

🔄 Repost detection

Vacancies on HH.kz are regularly renewed by employers to maintain visibility. The scraper tracks each listing across runs (90-day window). Set skipReposts: true to receive only genuinely new postings.

📍 City-level location filtering

Search within specific Kazakhstan cities — Алматы (Almaty), Астана (Astana), Shymkent, Atyrau, and others — or leave empty to search all of Kazakhstan.

---

Input parameters

Parameter	Type	Description	Default
keywords	string	Search keywords in Russian or English, e.g. "developer", "менеджер", "бухгалтер".	""
location	string	City name in Russian or English, e.g. "Алматы", "Астана", "Shymkent". Leave empty for all Kazakhstan.	""
maxResults	integer	Maximum number of vacancies to scrape. Set 0 for unlimited (up to 2,000 per search).	100
fetchDetails	boolean	Fetch full job description, skills list, and apply URL from each vacancy page.	true
skipReposts	boolean	Skip vacancies already seen in previous runs.	false

---

Output schema

{
  "title":               "Frontend Developer",
  "company":             "Kaspi Bank",
  "location":            "Алматы",
  "salary":              "600,000 – 900,000 KZT",
  "skills":              ["React", "TypeScript", "CSS"],
  "descriptionHtml":     "<p>Kaspi Bank is looking for a Frontend Developer...</p>",
  "descriptionText":     "Kaspi Bank is looking for a Frontend Developer...",
  "descriptionMarkdown": "**Kaspi Bank** is looking for a Frontend Developer...",
  "publishedAt":         "2026-04-20T00:00:00.000Z",
  "applyUrl":            "https://hh.kz/vacancy/123456789",
  "jobUrl":              "https://hh.kz/vacancy/123456789",
  "isRepost":            false,
  "originalPublishDate": null,
  "originalUrl":         null,
  "source":              "hh.kz"
}

---

Examples

IT jobs in Almaty:

{ "keywords": "developer", "location": "Алматы", "maxResults": 200 }

All vacancies in Astana:

{ "location": "Астана", "maxResults": 500 }

Finance roles — new postings only:

{ "keywords": "финансовый аналитик", "skipReposts": true, "maxResults": 100 }

---

💰 Pricing

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

Results	Cost
100	~$0.15
1,000	~$1.49
10,000	~$14.90
100,000	~$149.00

Flat-rate alternatives typically charge $29–$49/month regardless of usage. At 10,000 results/month, this scraper costs significantly less with no commitment.

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

---

Performance

Run	Time
100 vacancies	~1 min
1,000 vacancies	~6 min
5,000 vacancies	~30 min

---

Known limitations

• Salary: HH.kz salary data is in Kazakhstani Tenge (KZT) or USD, as specified by the employer. salary is null when not published. Salary values are raw strings (e.g. "600,000 – 900,000 KZT").
• Result cap: HH.kz search pagination caps at 2,000 results per search query. Use multiple targeted keyword searches to exceed this limit.
• Language: Listings are primarily in Russian. International companies may post in English.

---

Technical details

• Source: hh.kz — Kazakhstan's largest job platform (part of HH Group)
• Method: HTTP direct — no browser required
• Memory: 256 MB
• Proxy: None — $0 proxy cost
• Repost storage: KeyValueStore hh-kz-job-dedup, 90-day TTL
• Retry: Automatic retry on network errors, exponential backoff

---

Additional services

Need a custom actor, additional filters, scheduled runs, or integration support? Send an email to info@unfencedgroup.nl — we build on request.

---

Built by unfenced-group · Issues? Open a ticket or send a message.