Skip to content

BlackFalconData-org/work-ua-scraper

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

1 Commit
 
 

Repository files navigation

Work.ua Job Scraper

Extract structured data from work.ua — Ukrainian job listings from work.ua with full description, salary, company, location, and employment type. Incremental mode and structured export included.

Work.ua Job Scraper on Apify →


🚀 How to use this actor

💚 $5 free Apify credits — every month

No credit card required. No commitment. Cancel anytime.

  1. Click sign up — pick GitHub, Google, or email; takes ~30 seconds
  2. Open this actor — input is pre-filled with a working example
  3. Click Start — export results as JSON, CSV, or Excel

Your $5 monthly platform credit is enough to run this actor right away — and again every month — scraping typically several hundred to several thousand results per run, depending on your input.

Key features

Search with filters — Search by keyword and location. Filter by country, description format, and more.

Multiple input modes — search by keyword or browse all recent listings. Switch modes without re-scraping.

Detail enrichment — Fetch full job descriptions, salary data, employer profiles, contact information for each listing.

Incremental mode — Only get new or changed listings since your last run. Content hash per listing — no duplicates, no re-processing.

Change classification — Track unchanged, expired, cross-run repost detection across runs. Build audit trails of how listings evolve over time.

Compact output — Emit core fields only (AI-agent / MCP-friendly). Keeps response size small for LLM workflows.

Description truncation — Cap description length per listing to control output size and cost.

Result cap — Stop after N listings (up to 5.000). Set to 0 for the full catalog.

Export anywhere — Download as JSON, CSV, or Excel. Stream via Apify API, webhooks, or integrations with Make, Zapier, Airbyte, Keboola.

Structured data — Every listing returns the same schema with consistent field naming. All fields always present — null when unavailable, never omitted.


Use cases

Data pipeline automation Integrate with your ETL pipeline to collect structured listings from work.ua on a schedule. Export to CSV, JSON, or directly to your database. Use compact mode to control output size.

Market research Monitor listings, track trends, and analyze market dynamics with structured, deduplicated data from work.ua.

Change monitoring Run daily or hourly in incremental mode to capture only new, updated, or expired listings. Perfect for price-tracking, churn analysis, and alerting pipelines.

Compensation benchmarking Aggregate salary ranges across roles, industries, and locations on work.ua to inform pricing decisions, hiring plans, or candidate negotiations.

Lead generation Extract employer contact details alongside listings to build outreach lists for recruiters, staffing agencies, or B2B sales teams.

AI / LLM training data Structured JSON per listing is ready for RAG pipelines, embeddings, and agent workflows. Compact mode trims tokens for LLM context windows.


Quick start

"{\"mode\":\"search\",\"query\":\"developer\",\"maxResults\":5,\"includeDetails\":true}"

Input parameters

Parameter Type Default Description
mode enum "search" search: keyword-based browse. sitemap: crawl all recent listings (no keyword required).
query string Job search keywords. Required when mode = search and no Start URLs are provided. Supports JSON array for multi-query.
startUrls array [] Paste search URLs (e.g. https://www.work.ua/jobs-developer/). Each URL becomes its own search task; results are merged and deduped.
country enum "UA" Region market.
location string Optional city or region name filter (free text matched in results).
regionId integer Optional numeric work.ua region ID (e.g. Kyiv=39, Lviv=2). Leave empty for all regions.
categoryIds array [] Optional comma-separated category IDs (e.g. "1,23"). Leave empty for all categories.
salary integer Optional minimum monthly salary in UAH (e.g. 30000).
experience string Optional experience filter ID.
employment string Optional employment-type filter ID.
daysAgo integer Limit to listings created in the last N days. Leave empty for all.
maxResults integer 50 Maximum total results (0 = unlimited).
includeDetails boolean true Fetch full description, skills, languages, and contact info per result.
descriptionMaxLength integer 0 Truncate description to N chars. 0 = no truncation.
compact boolean false Core fields only (for AI-agent / MCP workflows).
descriptionFormat enum "all" Which description variants to emit. all keeps description + descriptionText + descriptionHtml + descriptionMarkdown.
excludeEmptyFields boolean false Drop null / empty fields from each output record.
includeKeywords array [] Filter to results whose title/description contains ANY of these keywords (case-insensitive).
excludeKeywords array [] Drop results whose title/description contains ANY of these keywords.
fromDate string Only include results posted on or after this date (YYYY-MM-DD).
toDate string Only include results posted on or before this date (YYYY-MM-DD).
maxAgeMinutes integer Only include results posted within the last N minutes.
includeRunMetadata boolean false Embed search keyword + total counts in outbound webhook / Telegram messages.
incrementalMode boolean false Compare against previous run state. Emits only NEW / UPDATED / REAPPEARED results; lifecycle metadata added per record.
stateKey string Optional. Stable identifier for the tracked search universe. Leave empty to auto-generate.
emitUnchanged boolean false Also emit results that have not changed since the last run.
emitExpired boolean false Also emit results that have disappeared since the last run.
skipReposts boolean false When incremental, skip results whose content matches an expired entry from a prior run.
telegramToken string Telegram bot token (from @BotFather). Required for Telegram notifications.
telegramChatId string Telegram chat or channel ID. Required when telegramToken is set.
discordWebhookUrl string Discord incoming webhook URL.
slackWebhookUrl string Slack incoming webhook URL.
whatsappAccessToken string WhatsApp Cloud API permanent access token (Meta Business).
whatsappPhoneNumberId string Your WhatsApp Business phone-number ID (numeric).
whatsappTo string Recipient phone in E.164 format without + (e.g. 380501234567).
webhookUrl string Receives a JSON POST with {metadata, items} after each run.
webhookHeaders object Optional JSON object of custom headers.
notificationLimit integer 5 Maximum number of results included in each notification message (1-20).
notifyOnlyChanges boolean false When incremental mode is on, only send notifications for NEW and UPDATED results.

Output fields

Every listing returns the same 75-field schema. Missing values are null — never omitted.

  • jobId
  • jobKey
  • title
  • company
  • companyId
  • companyLogo
  • companyWebsite
  • companyIsVip
  • companyIsAgency
  • companyIsConfirmed
  • companyIsAnonymous
  • location
  • city
  • street
  • latitude
  • longitude
  • regionId
  • categoryIds
  • jobTypeIds
  • experienceTypeId
  • educationTypeId
  • description
  • descriptionText
  • descriptionHtml
  • descriptionMarkdown
  • salaryText
  • salaryMin
  • salaryMax
  • salaryCurrency
  • salaryPeriod
  • salaryType
  • isSalaryAboveMarketAverage
  • isHot
  • isUrgent
  • isVip
  • isRemote
  • isNoResume
  • isShow
  • isAnonymous
  • employmentType
  • isDisabilityFriendly
  • isStudentFriendly
  • isVeteranFriendly
  • isRetiredFriendly
  • isDefermentEligible
  • experienceRequired
  • skills
  • languages
  • postedAt
  • validThrough
  • scrapedAt
  • url
  • applyUrl
  • canonicalUrl
  • contactPerson
  • contactPhone
  • extractedEmails
  • extractedPhones
  • extractedUrls
  • socialProfiles
  • searchQuery
  • source
  • sourceDomain
  • sourceCountry
  • contentQuality
  • detailFetched
  • contentHash
  • changeType
  • firstSeenAt
  • lastSeenAt
  • previousSeenAt
  • expiredAt
  • isRepost
  • repostOfId
  • repostDetectedAt

Sample output

One object per listing. Here is a real example from a production run:

{
  "jobId": "7e2fe712cc81d3f2cc740954e1b1d9fa5129e1831d40652b392f3582ca90ceaf",
  "jobKey": "6752329",
  "title": "Інженер-програміст, розробник 1C",
  "company": "Aсris Agro",
  "companyId": "371244",
  "companyLogo": "https://i.work.ua/employer_design/2/4/4/371244_company_logo_7.png",
  "companyWebsite": "https://www.acris-agro.com/",
  "companyIsVip": false,
  "companyIsAgency": false,
  "companyIsConfirmed": true,
  "companyIsAnonymous": false,
  "location": "Киев, вулиця Жилянська, 106Б"
}

Truncated — full records contain 75 fields. See Output fields for the complete schema.

Try Work.ua Job Scraper now — $5 free credit, no credit card →


FAQ

How do I scrape work.ua? Use this actor on Apify to extract structured data from work.ua. Configure your search query and filters in the input, then click Start — no coding required.

How do I get work.ua data as JSON, CSV, or Excel? The actor writes each listing to Apify's dataset. Download as JSON, CSV, or Excel from the Console, stream via the API, or push to Make, Zapier, Airbyte, or Keboola.

Is it legal to scrape work.ua? Web scraping of publicly available data is generally legal. This actor only accesses publicly visible information. Always check work.ua's terms of service for your specific use case.

How much does it cost? Pay-per-event pricing — you only pay for listings extracted. Apify's free $5 credit is enough to run thousands of results before you pay anything.

How does incremental mode work? Each listing gets a content hash. On subsequent runs, only new or changed listings are emitted — saving time, compute, and storage. Expired listings can be tracked separately.

Do I need an API key or credentials? No. Just sign up for Apify, paste your input, and click Start. No credit card required.


Related products by Black Falcon Data


Getting started with Apify

New to Apify? Create a free account with $5 credit — no credit card required.

  1. Sign up — $5 platform credit included
  2. Open Work.ua Job Scraper and configure your input
  3. Click Start — export results as JSON, CSV, or Excel

Need more later? See Apify pricing.


About Black Falcon Data

Black Falcon Data builds production-grade web scrapers for job boards and marketplace data. Browse our full actor catalog at www.blackfalcondata.com.


Last updated: 2026 05

About

Extract Ukrainian job listings from work.ua with full description, salary, company, location, and employment type. Incremental mode and structured export included.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors