# Jooble Jobs Scraper - Salaries & Descriptions (`datascraperes/jooble-jobs-api`) Actor

Scrape Jooble jobs by keyword, location and country. Collect unique listings with company details, salary text, posting dates, tags and available full descriptions. Search multiple keywords per run and export structured JSON or CSV for recruiting and job market research.

- **URL**: https://apify.com/datascraperes/jooble-jobs-api.md
- **Developed by:** [DataScraperES](https://apify.com/datascraperes) (community)
- **Features:** Limited permissions
- **Stats:** 3 total users, 2 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.13 / 1,000 job offers

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

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

Collect Jooble job offers by keyword, city or region and country. Export unique listings with employer information, salary text, dates, tags and available descriptions as JSON or CSV.

### What this Actor does

The Actor searches one Jooble country site per run and saves one Dataset row per unique offer. You can supply several keywords for the same location. Offers already saved in the run are not saved again when another page or keyword returns them.

Choose from the country sites listed in the input. Availability and the number of offers depend on the country, keyword and location. Salary, employer details and descriptions are included when the source publishes them.

### Use cases

- Build a local job feed for a particular role or skill.
- Compare published roles, employers and salary text across separate country searches.
- Refresh a job board or prepare structured employment data for analysis.
- Collect several related job titles without duplicate listings in the same run.

### How to use

1. Enter at least one keyword and select the country.
2. Add a city or region, or leave the location empty for a country search.
3. Set the maximum number of offers and start the Actor.
4. Review the Dataset and the collection summary, then export the results.

For example, this input collects up to 20 offers in Barcelona:

```json
{
  "searches": [
    "camarero"
  ],
  "location": "Barcelona",
  "country": "es",
  "maxItems": 20,
  "includeFullDescription": true
}
```

### Input

```json
{
  "searches": [
    "camarero"
  ],
  "location": "Barcelona",
  "country": "es",
  "maxItems": 20,
  "includeFullDescription": true
}
```

| Field | Required | Description |
|---|---|---|
| `searches` | Yes | Up to 20 job titles, skills or keywords. Each keyword is limited to 200 characters. Repeated keywords are searched once. |
| `location` | No | City or region, up to 200 characters. Empty searches the selected country. |
| `country` | No | Country site from the input list. Defaults to Spain (`es`). |
| `maxItems` | No | Maximum unique offers across all keywords, from 1 to 5,000. Defaults to 200. |
| `includeFullDescription` | No | Include available full description text. Defaults to `true`; when disabled, `full_content` is `null`. |

Use keywords and location names appropriate for the selected country. Each keyword is checked in order until the global offer limit is reached. Results can be fewer than the maximum when the source runs out of offers or collection stops early.

### Output

The Dataset contains one row per offer, with the following complete representative item from the example search:

```json
{
  "uid": "9206494491054732168",
  "url": "https://es.jooble.org/away/9206494491054732168?p=1&pos=1&rgn=5444&pageType=8&ckey=camarero&avi=-8014850990566602765&jobAge=1161&relb=15&brelb=15&scr=19999.798747349607&bscr=19999.798747349607&elckey=-8119706352451250525&searchTestGroup=2_2_1&iid=4551452942169324726",
  "position": "Ayudante Camarero/a",
  "company": "Catalonia Hotels & Resorts",
  "company_verified": false,
  "company_logo": null,
  "location": "Barcelona",
  "region_id": 5444,
  "salary": null,
  "estimated_salary": null,
  "date_updated": "2026-09-16T00:00:00",
  "date_caption": "Hace un mes",
  "content": "... Desde CATALONIA HOTELS & RESORTS precisamos incorporar AYUDANTES DE CAMAREROS/ AS para nuestros hoteles de Barcelona.\nLas principales tareas a desarrollar son las siguientes:\n• Realizar un servicio de calidad a los clientes.\n• Preparar áreas de trabajo para el ...",
  "full_content": "Desde CATALONIA HOTELS & RESORTS precisamos incorporar AYUDANTES DE CAMAREROS/AS para nuestros hoteles de Barcelona.\nLas principales tareas a desarrollar son las siguientes:\n• Realizar un servicio de calidad a los clientes.\n• Preparar áreas de trabajo para el servicio.\n• Atender y servir las mesas siguiendo los procesos establecidos.\n• Conocer y asesorar sobres los diferentes productos de la carta de alimentos y vinos.\n• Limpiar y remontar para el siguiente servicio.\n• Estar pendiente de las necesidades de los clientes en los servicios.\nREQUISITOS\n• Experiencia previa en hoteles/restaurante\n• Residir en la provincia del puesto vacante.\n• Inglés nivel avanzado.\nSE OFRECE\n• Contrato de 40h semanales con turnos rotativos.\n• Salario competitivo.\n• Crecimiento profesional.\n• Incorporación inmediata.",
  "job_type": null,
  "tags": [
    "Contrato",
    "Inicio inmediato",
    "Turno rotativo"
  ],
  "is_remote": false,
  "is_premium": false,
  "is_easy_apply": false,
  "is_new": false,
  "search_query": "camarero",
  "search_location": "Barcelona",
  "country": "es",
  "source_page": 1,
  "scraped_at": "2026-11-03T08:17:53+00:00"
}
```

`uid` identifies the offer. `position`, `company`, `location`, `salary` and `estimated_salary` contain source information. `content` and `full_content` are plain text. Tags, dates, employer verification and listing flags help describe the offer; optional source values can be absent.

`search_query`, `search_location`, `country`, `source_page` and `scraped_at` describe how the offer was collected. The `SUMMARY` record in the default key-value store reports saved offers, collection completeness and the stopping reason. A Dataset with some rows does not by itself mean every requested search finished.

### Pricing

The billable event is `job`: one event for each unique offer saved and confirmed in the Dataset. There is no start fee. Empty pages, duplicate offers and full descriptions do not create additional billable events. The event price includes the Actor's operating costs.

| Apify plan | Price per offer (USD) | Equivalent per 1,000 offers (USD) |
|---|---:|---:|
| FREE | 0.0015 | 1.50 |
| BRONZE | 0.00135 | 1.35 |
| SILVER | 0.0012 | 1.20 |
| GOLD | 0.001125 | 1.125 |
| PLATINUM | 0.001125 | 1.125 |
| DIAMOND | 0.001125 | 1.125 |

Billing is per delivered offer; 1,000 offers is a comparison equivalent. Check the Actor's **Pricing** tab for the current tariff for your plan.

Collection stops when the run spending limit cannot fund another offer. That outcome is marked incomplete, and already saved offers remain available. Budget reservations can use the highest configured tier price, so collection can stop before the entire spending allowance is consumed.

### Related Actors

| Actor | Best for |
|---|---|
| [InfoJobs Jobs Scraper | Spanish Job Data](https://apify.com/datascraperes/infojobs-jobs-scraper) | Collect public InfoJobs Spain jobs with keyword, location, work-condition, experience, study, and salary filters |
| [Glassdoor Jobs Scraper | Global Job Listings](https://apify.com/datascraperes/glassdoor-jobs-scraper) | Scrape public Glassdoor job listings worldwide with keyword, country, location, date, job type, remote, and Easy Apply filters |
| [Indeed Jobs Scraper | Worldwide Job Data](https://apify.com/datascraperes/indeed-jobs-scraper) | Scrape public Indeed job listings worldwide with keyword, country, location, date, job type, remote status, and Indeed Apply filters |
| [LinkedIn Jobs Scraper – No Login](https://apify.com/datascraperes/linkedin-jobs-scraper) | Scrape public LinkedIn jobs by keyword and location |

### Limits and data quality

- One country and one location per run; up to 20 keywords share the same offer limit.
- A long search can reach the collection time limit. The Actor then ends with a warning and keeps the confirmed results; `SUMMARY` reports `complete: false` and `stop_reason: "time_limit"`. Reduce `maxItems` or narrow the search for a smaller run.
- Each keyword is checked up to 50 result pages. If this boundary is reached before the requested work finishes, the summary reports an incomplete collection.
- Reaching a pagination safety limit also ends with a warning and preserves the confirmed results. This does not mean that every matching offer was collected.
- The collection time budget is approximately three minutes. Source availability and response times can reduce the delivered quantity.
- Salaries are published text, rather than normalized compensation figures. Missing salaries and descriptions are not invented.
- Source restrictions or unusable responses can leave a partial or empty Dataset. The Actor ends with a warning and an incomplete `SUMMARY`, preserving confirmed output. Check the summary even when the run succeeds. Storage, integrity or billing failures can still fail the run.
- Restarting the same run with its original storage checks previously saved identities. Inconsistent or unconfirmed records stop collection for review rather than silently creating more rows.
- Separate new runs may contain the same offer. Deduplication applies within a run and its preserved restart state.

### Frequently asked questions

#### Can I search several countries at once?

Use a separate run for each country. Every row includes the selected country code so exports can be combined later.

#### Why did I receive fewer offers than requested?

The maximum is a cap, not a guaranteed quantity. Check `SUMMARY` to distinguish exhausted results, the spending limit and an incomplete collection.

If the source remains unavailable, the Actor warns you and preserves offers already collected; an incomplete collection is not reported as completed.

#### What happens if my input needs correction or no offers match?

If the Actor detects invalid input after starting, it logs a warning explaining what to correct and ends normally without collecting additional offers or requesting new offer charges. Unsupported fields are handled the same way. A valid search with no matching offers also ends with a warning and no offer charges. Check the warning and collection summary before running again.

Apify also validates input in the form and API before starting the Actor. Some invalid requests are rejected at that stage, so no run or Actor log is created.

#### Does the Actor include full job descriptions?

It includes available full descriptions by default. Disable `includeFullDescription` for a smaller export containing the short snippet.

#### Are salaries and job types always available?

No. These fields depend on what Jooble publishes for each listing. Missing optional values remain empty.

### Responsible use

Use the data in accordance with the source's terms and applicable rules. Collect the data you need and choose reasonable workload limits.

### Support

Open the Actor's **Issues** tab and include the run ID, input and the observed result so the issue can be investigated.

[Python, JavaScript and CSV integration examples](https://github.com/datacrawler-edu/jooble-jobs-scraper-python)

# Actor input Schema

## `searches` (type: `array`):

One or more job titles, skills or keywords, as you would type them on Jooble (for example "camarero", "programador" or "driver"). Duplicates are collected once.

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

City or region to search in, as Jooble names it in that country (for example "Barcelona", "London" or "Berlin"). Leave empty to search the whole country.

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

Jooble country site to search.

## `maxItems` (type: `integer`):

Maximum unique offers to save, up to 5,000. Collection can end earlier when results are exhausted, the spending limit is reached or a search cannot be completed.

## `includeFullDescription` (type: `boolean`):

Include the complete job description text in each offer. Disable to keep only the short snippet and reduce output size.

## Actor input object example

```json
{
  "searches": [
    "camarero"
  ],
  "location": "Barcelona",
  "country": "es",
  "maxItems": 20,
  "includeFullDescription": true
}
```

# Actor output Schema

## `dataset` (type: `string`):

One row per job offer, including title, company, location, salary, dates, tags, flags and description.

# 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 = {
    "searches": [
        "camarero"
    ],
    "location": "Barcelona",
    "country": "es",
    "maxItems": 20,
    "includeFullDescription": true
};

// Run the Actor and wait for it to finish
const run = await client.actor("datascraperes/jooble-jobs-api").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 = {
    "searches": ["camarero"],
    "location": "Barcelona",
    "country": "es",
    "maxItems": 20,
    "includeFullDescription": True,
}

# Run the Actor and wait for it to finish
run = client.actor("datascraperes/jooble-jobs-api").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 '{
  "searches": [
    "camarero"
  ],
  "location": "Barcelona",
  "country": "es",
  "maxItems": 20,
  "includeFullDescription": true
}' |
apify call datascraperes/jooble-jobs-api --silent --output-dataset

```

## MCP server setup

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

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/POU2PdSGWNwTzC6vu/builds/X5ui5pgEBdzET5KYI/openapi.json
