ilia/Jobber
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Jobber/docs-site/docs/extractors/adzuna.md
Shaheer Sarfaraz 19266fe5eb
City search (#217) 
* wave 1, jobspy only

* combine usa/ca to united states

* strict city location filter

* hide and show based on focus

* UI changes

* allow clicking cross!

* pill animate in

* animate out, uggo fix

* animate out

* framer motion

* animate component height

* adzuna

* hiring cafe implementation

* refactor: centralize shared search-city parsing and matching

* feat: migrate city setting to searchCities with legacy fallback

* docs: update pipeline and extractor city-search wording

* fix(orchestrator): normalize tokenized paste behavior

* fix(shared): tighten city matching semantics

* docs(extractors): document city-location knobs and geocoding note
2026-02-21 00:42:09 +00:00

2.4 KiB
Raw Blame History

id, title, description, sidebar_position
id title description sidebar_position
adzuna Adzuna Extractor API-based Adzuna extraction with orchestrator ingestion and progress updates. 6

What it is

Original website: adzuna.com

Adzuna is an API-backed extractor implemented in two lean pieces:

  1. extractors/adzuna/src/main.ts fetches paginated Adzuna search results and writes jobs.json.
  2. orchestrator/src/server/services/adzuna.ts runs the extractor, parses progress lines, and maps rows into CreateJobInput.

It de-duplicates in the existing repository path using sourceJobId fallback to jobUrl.

Why it exists

Adzuna provides stable API discovery for countries that are not covered by UK-only sources. It adds a lower-maintenance source without introducing new API routes or UI sections.

How to use it

  1. Create an Adzuna developer account.
  2. Open Adzuna Access Details.
  3. Copy your App ID and App Key.
  4. In Job Ops, open Settings and paste them into Adzuna App ID and Adzuna App Key under Environment & Accounts.
  5. In Pipeline Run (Automatic tab), select a compatible country and enable Adzuna in Sources.
  6. Start the run; Adzuna progress appears in the existing crawl progress stream.

City behavior:

  • If Search cities are set in Automatic advanced settings, Adzuna runs once per city.
  • City runs use strict post-filtering (job.location contains requested city) to avoid broad country-level spillover.

Default controls:

  • ADZUNA_APP_ID
  • ADZUNA_APP_KEY
  • ADZUNA_MAX_JOBS_PER_TERM (default 50)
  • ADZUNA_LOCATION_QUERY (optional city/location text)

Supported countries in this integration:

  • United Kingdom, United States, Austria, Australia, Belgium, Brazil, Canada, Switzerland, Germany, Spain, France, India, Italy, Mexico, Netherlands, New Zealand, Poland, Singapore, South Africa.

Common problems

Adzuna is disabled in source selection

  • Adzuna App ID and Adzuna App Key are missing from Settings (or env).

Adzuna is skipped for my selected country

  • The selected country is not in the supported list above.

Adzuna fails with authorization errors

  • Verify ADZUNA_APP_ID and ADZUNA_APP_KEY are valid and active in your Adzuna account.

Related pages