# Adzuna Jobs Scraper — Multi-Country Jobs API (`umararshad2/adzuna-jobs-scraper`) Actor

Scrape Adzuna job search results across 16+ country sites (US, UK, AU, CA, DE, FR, NL, …) into JSON. Multi-country Adzuna jobs scraper API. CheerioCrawler. PPE $1.20/1k.

- **URL**: https://apify.com/umararshad2/adzuna-jobs-scraper.md
- **Developed by:** [Umar Arshad](https://apify.com/umararshad2) (community)
- **Categories:** Jobs, Automation, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 job scrapeds

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
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.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

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

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Adzuna Jobs Scraper — Multi-Country Jobs API

Scrapes **[Adzuna](https://www.adzuna.com)** — a multi-country job aggregator spanning the **US, UK, Australia, Canada, Germany, France, Netherlands**, and 10+ more country sites — into clean JSON on Apify.

**Store:** https://apify.com/umararshad2/adzuna-jobs-scraper

### Why this Actor

Adzuna covers **16+ national job boards under one brand**, so recruiters, agencies, and HR-tech teams can pull structured listings without stitching separate scrapers per country. Dedicated Store competitors for Adzuna are thin compared with saturated Reed / Indeed / Glassdoor niches. This Actor is framed as a **global / multi-country Adzuna jobs scraper API** — not a single-country product.

### What it scrapes

1. **Search listings** — `https://{host}/search?q={query}` (+ optional location)
2. **Job detail pages** — `https://{host}/land/ad/{id}` (JSON-LD `JobPosting` when present; listing fields as fallback)
3. **Direct URLs** — pass search or `/land/ad/` links via `searchUrls`

Uses **Crawlee CheerioCrawler** (SSR HTML). Defaults to **Apify RESIDENTIAL proxy**.

#### Supported country codes → hosts

| Code | Host |
| --- | --- |
| `us` | www.adzuna.com |
| `gb` | www.adzuna.co.uk |
| `au` | www.adzuna.com.au |
| `ca` | www.adzuna.ca |
| `de` | www.adzuna.de |
| `fr` | www.adzuna.fr |
| `nl` | www.adzuna.nl |
| `at` | www.adzuna.at |
| `be` | www.adzuna.be |
| `br` | www.adzuna.com.br |
| `in` | www.adzuna.in |
| `it` | www.adzuna.it |
| `mx` | www.adzuna.com.mx |
| `nz` | www.adzuna.co.nz |
| `pl` | www.adzuna.pl |
| `sg` | www.adzuna.com.sg |
| `za` | www.adzuna.co.za |
| `es` | www.adzuna.es |
| `ch` | www.adzuna.ch |

### Pricing (PPE)

**$1.20 / 1,000 jobs** via custom event `job-scraped` ($0.0012 each), plus a small `apify-actor-start`. No usage pass-through. Do **not** enable synthetic `apify-default-dataset-item` alongside `job-scraped` (avoids double billing). Memory: **512–2048 MB** (default 1024).

### Example input

```json
{
  "queries": ["software engineer"],
  "country": "us",
  "location": "New York",
  "maxJobs": 100,
  "includeDescription": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": ["RESIDENTIAL"]
  }
}
```

UK example:

```json
{
  "queries": ["registered nurse"],
  "country": "gb",
  "location": "London",
  "maxJobs": 50
}
```

Direct Adzuna URLs:

```json
{
  "searchUrls": [
    "https://www.adzuna.com/search?q=data+analyst",
    "https://www.adzuna.co.uk/land/ad/1234567890"
  ],
  "maxJobs": 25,
  "includeDescription": true
}
```

### Output fields

| Field | Description |
| --- | --- |
| `jobId` | Adzuna `/land/ad/{id}` identifier |
| `title` | Job title |
| `company` | Hiring organization |
| `location` | City / region text from the card or detail |
| `country` | Country code used for the host (e.g. `us`, `gb`) |
| `salaryRaw` | Raw salary string when shown |
| `salaryMin` / `salaryMax` | Parsed numeric bounds when available |
| `salaryCurrency` | ISO currency guess from country / symbols |
| `description` | Snippet or full detail description |
| `url` | Canonical Adzuna job URL |
| `postedAt` | Date posted (from JSON-LD when present) |
| `category` | Occupational category when present |
| `source` | Always `adzuna` |
| `scrapedAt` | ISO timestamp |

### Proxy notes

Adzuna **search HTML is publicly scrapable** — US listing runs often succeed with Apify Proxy auto (or even `useApifyProxy: false`). Forced **RESIDENTIAL** can occasionally return empty listing shells; if you see `Search: 0 job cards`, retry without a proxy group or with datacenter.

**Detail pages** (`/land/ad/{id}`) and some regions may sit behind bot challenges. For full descriptions:

1. Prefer `apifyProxyGroups: ["RESIDENTIAL"]` with a matching `apifyProxyCountry` (e.g. `US`, `GB`, `AU`)
2. Or try **UNBLOCKER**
3. Or set `includeDescription: false` for fast listing-only scrapes

### Related Actors (same account)

- [Foundit Jobs Scraper](https://apify.com/umararshad2/foundit-jobs-scraper)
- [Instahyre Jobs Scraper](https://apify.com/umararshad2/instahyre-jobs-scraper)
- [Mustakbil Jobs Scraper](https://apify.com/umararshad2/mustakbil-jobs-scraper)
- [Whatmobile Scraper](https://apify.com/umararshad2/whatmobile-scraper)

### SEO keywords

Adzuna scraper, Adzuna jobs API, Adzuna jobs scraper, multi-country jobs scraper, US Adzuna scraper, UK Adzuna scraper, Australia Adzuna scraper, EU Adzuna jobs API, Adzuna.com scraper, Adzuna.co.uk scraper, pay-per-event job scraper, Apify jobs scraper, PPE job-scraped.

### Disclaimer

Unofficial community Actor — not affiliated with Adzuna. Use responsibly and respect the site’s terms and robots rules. For personal / research / permitted commercial use only.

# Actor input Schema

## `queries` (type: `array`):

Keyword queries (e.g. software engineer, nurse, data analyst). Builds /search?q=… on the selected country host. Optional if searchUrls is set.

## `country` (type: `string`):

Adzuna country site: us, gb, au, ca, de, fr, nl, at, be, br, in, it, mx, nz, pl, sg, za, es, ch. Maps to the matching Adzuna host (e.g. us → www.adzuna.com, gb → www.adzuna.co.uk).

## `location` (type: `string`):

Optional location filter passed as Adzuna `w` / where parameter (city, region, or remote).

## `searchUrls` (type: `array`):

Optional full Adzuna search URLs or direct /land/ad/{id} job URLs. When set, these are crawled in addition to (or instead of) query-built searches.

## `maxJobs` (type: `integer`):

Hard cap on jobs written to the dataset (after dedupe). Default 100, maximum 5000.

## `includeDescription` (type: `boolean`):

When true, fetch each /land/ad/{id} detail page (JSON-LD JobPosting when present). When false, emit listing-card fields only (faster, fewer requests).

## `useMockData` (type: `boolean`):

Force fixture mode (no live Adzuna calls). Useful for local CI. Auto-fallback also engages if search pages are blocked.

## `proxyConfiguration` (type: `object`):

Apify Proxy settings. US/UK search HTML often works without proxy or with datacenter. Detail pages and some regions need RESIDENTIAL or UNBLOCKER. Default enables Apify Proxy (auto). Set apifyProxyGroups to \["RESIDENTIAL"] if you see empty listings or challenges.

## Actor input object example

```json
{
  "queries": [
    "software engineer"
  ],
  "country": "us",
  "location": "New York",
  "searchUrls": [
    "https://www.adzuna.com/search?q=software+engineer"
  ],
  "maxJobs": 100,
  "includeDescription": true,
  "useMockData": false,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `jobs` (type: `string`):

Dataset of Adzuna job rows (title, company, location, salary, description, country, URLs).

# 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 = {
    "queries": [
        "software engineer"
    ],
    "country": "us",
    "location": "New York",
    "searchUrls": [
        "https://www.adzuna.com/search?q=software+engineer"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("umararshad2/adzuna-jobs-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 = {
    "queries": ["software engineer"],
    "country": "us",
    "location": "New York",
    "searchUrls": ["https://www.adzuna.com/search?q=software+engineer"],
}

# Run the Actor and wait for it to finish
run = client.actor("umararshad2/adzuna-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "queries": [
    "software engineer"
  ],
  "country": "us",
  "location": "New York",
  "searchUrls": [
    "https://www.adzuna.com/search?q=software+engineer"
  ]
}' |
apify call umararshad2/adzuna-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,umararshad2/adzuna-jobs-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/nfJfY1A3FNVJlnnsK/builds/NMglS8Z4oJDo11gQr/openapi.json