Adzuna Jobs Search Scraper

Collect normalized public job listings from Adzuna country sites. The Actor searches by keyword and optional location, follows result pagination, opens job detail pages, and stores only complete job records in the default dataset. It is intended for job-market research, recruitment analysis, and integrations that need consistent records across Adzuna regions.

Input

• query is the job title or search phrase.
• location is an optional city or region.
• country chooses one of the supported Adzuna country domains.
• maxItems limits stored jobs from 1 to 100; the default is 10.
• salaryMin and salaryMax add source-side salary filters when supplied.
• proxyConfiguration is optional. Direct access is the safe, no-proxy-cost default. Enable an authorized proxy only when your account supports it and the target permits that access.

Example:

{
  "query": "software engineer",
  "location": "London",
  "country": "gb",
  "maxItems": 10,
  "proxyConfiguration": { "useApifyProxy": false }
}

Output

The default dataset contains job records only. Core fields include id, title, jobUrl, postedDate, descriptionText, structured company and location, employment/workplace data, salary, skills, benefits, search context, and scrapedAt. Records without a stable identifier, title, URL, useful description, company, or location are not emitted. IDs are deduplicated across pages.

Run metadata is separate from jobs:

• KVS OUTPUT contains status and counters.
• KVS DIAGNOSTICS explains a truthful empty or blocked run.

SUCCEEDED means at least one complete job was stored. NO_DATA means the public search returned no complete matching records. BLOCKED means the source presented a challenge. Diagnostic objects never contaminate the job dataset.

Reliability and cost

Pagination, request count, concurrency, retries, and item count are bounded. Detail extraction enriches search-card data, while a complete card can be retained if its detail request fails. Browser crawling consumes more compute than an HTTP-only scraper; start with 5-10 records. Proxy traffic can add separate charges, so it is disabled by default.

Responsible use

Collect only publicly available job information. Respect Adzuna terms, robots directives, privacy obligations, and applicable law. Do not use the Actor for authenticated pages, personal-data harvesting, access-control bypass, or excessive traffic. Source markup and regional availability can change; use OUTPUT and DIAGNOSTICS when monitoring production runs.