# Jooble Scraper โ€” 70+ Countries, Remote, Full Descriptions (`unfenced-group/jooble-html-scraper`) Actor Scrape 2M+ jobs from Jooble across 70+ countries. Remote filter, full descriptions, salary parsing, quality signals. $1.50/1k. - **URL**: https://apify.com/unfenced-group/jooble-html-scraper.md - **Developed by:** [Unfenced Group](https://apify.com/unfenced-group) (community) - **Categories:** Jobs, Automation, Developer tools - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 1 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 results 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. Actors are written with capital "A". ## 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. The best way to integrate Actors is as follows. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use the [REST API](https://docs.apify.com/api/v2.md). For usage examples, see the [API](#api) section below. For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt). # README ## Jooble Scraper ![Jooble Scraper](https://i.imgur.com/SIwXrQ2.png) Scrape structured job listings from [Jooble](https://jooble.org) โ€” Global. 2,000,000+ active listings. No API key required. --- ### Why this scraper? #### ๐ŸŒ Global job aggregator โ€” 70+ countries Jooble aggregates job listings from thousands of sources across 70+ countries and multiple languages. #### ๐Ÿ“„ Full job descriptions Enable `fetchDetails` to retrieve complete job descriptions in all three formats. #### ๐Ÿ’ฐ Multi-currency salary data Salary ranges parsed in the local currency where published. #### ๐Ÿ”„ Repost detection Cross-run deduplication with a 90-day TTL. Use `skipReposts: true` for new-only feeds. #### ๐ŸŒ Multi-country, multi-language Configure `country` and `language` inputs to target specific markets. #### โš™๏ธ No API key required Runs without any third-party credentials. --- ### Input parameters | Parameter | Type | Description | Default | |---|---|---|---| | `keywords` | string | Job title, keyword, or skill to search for. | โ€” | | `location` | string | City or region to filter by. Leave empty to search all locations. | โ€” | | `country` | string | Target country code (e.g. AR, CO, MX). Required for multi-country actors. | โ€” | | `maxResults` | integer | Maximum number of results to return. | `5` | | `daysOld` | integer | Only return listings published within the last N days. | โ€” | | `skipReposts` | boolean | Skip listings already seen in previous runs (90-day deduplication window). | `true` | | `startUrls` | array | List of specific URLs to scrape. Bypasses the search input. | โ€” | | `proxyConfiguration` | string | Residential proxy recommended for best results. | `{'useApifyProxy': True, 'apifyProxyGroups': ['RESIDENTIAL']}` | --- ### Output schema Each result contains the following fields. | Field | Type | Description | |---|---|---| | `id` | string | Unique job listing ID from the source platform. | | `url` | string | Direct URL to the job listing. | | `title` | string | Job title as published. | | `company` | string | Employer / company name. | | `location` | string | Full location string as published. | | `city` | string | City of the work location. | | `country` | string | Country code (ISO 3166-1 alpha-2). | | `contractType` | string | Contract type (permanent, contract, temporary, etc.). | | `workSchedule` | string | Work schedule (full-time, part-time, etc.). | | `salaryMin` | number | Minimum salary (null if not published by employer). | | `salaryMax` | number | Maximum salary (null if not published by employer). | | `salaryCurrency` | string | ISO 4217 currency code (null if no salary published). | | `salaryPeriod` | string | Salary period: YEAR / MONTH / WEEK / DAY / HOUR. | | `publishDate` | string | Publication date (YYYY-MM-DD). | | `publishDateISO` | string | Publication date in ISO 8601 format. | | `source` | string | Source domain name. | | `scrapedAt` | string | ISO 8601 timestamp of when this item was scraped. | | `contentHash` | string | MD5 hash of key fields for change detection (16 chars). | | `summary` | string | Human-readable one-line summary of the listing. | | `changeStatus` | string | Change status: NEW / MODIFIED / UNCHANGED. | | `isRepost` | boolean | True if this listing was seen in a previous run (90-day window). | | `originalPublishDate` | string | Original publish date if this is a repost (null otherwise). | | `originalUrl` | string | Original URL if this is a repost (null otherwise). | | `language` | string | Language code for the listing. | **Example output record:** ```json { "id": "123456", "url": "https://jooble.org/jobs/senior-developer/123456", "title": "Software Developer", "company": "Booking.com", "location": "Amsterdam", "city": "Amsterdam", "country": null, "contractType": "Permanent", "workSchedule": "Full-time", "salaryMin": 45000, "salaryMax": 60750, "salaryCurrency": "EUR", "salaryPeriod": "YEAR", "publishDate": "2026-04-15", "publishDateISO": "2026-04-15", "source": "jooble.org", "scrapedAt": "2026-04-24T09:00:00.000Z", "contentHash": "a3f1b2c4d5e67890", "summary": "Software Developer ยท Booking.com ยท Amsterdam", "changeStatus": "NEW", "isRepost": false, "originalPublishDate": null, "originalUrl": null, "language": null } ```` *** ### Examples #### 1 โ€” Search for Software Developer roles in Amsterdam ```json { "searchQuery": "developer", "location": "Amsterdam", "maxResults": 100 } ``` #### 2 โ€” All listings without filters ```json { "searchQuery": "", "maxResults": 500 } ``` #### 3 โ€” Scrape a specific search page directly via startUrls ```json { "startUrls": [ { "url": "https://jooble.org/jobs?q=developer" } ], "maxResults": 50 } ``` #### 4 โ€” Daily feed โ€” new listings only, past 24 hours, no reposts ```json { "searchQuery": "", "daysOld": 1, "skipReposts": true, "maxResults": 1000 } ``` *** ### ๐Ÿ’ฐ Pricing **$1.50 per 1,000 results** โ€” you only pay for successfully retrieved listings. Failed retries and filtered reposts are never charged. | Results | Cost | |---|---| | 100 | ~$0.15 | | 1,000 | ~$1.50 | | 10,000 | ~$15.00 | | 100,000 | ~$150.00 | > Flat-rate alternatives typically charge $29โ€“$49/month regardless of usage. Use the **Max results** cap in the input to control your spend exactly. *** ### Performance | Run size | Approx. time | |---|---| | 100 listings | ~2 min | | 1,000 listings | ~15 min | | 10,000 listings | ~2.5 hours | *** ### Known limitations - **Salary:** Not all employers publish salary information โ€” `salaryMin` and `salaryMax` may be `null`. - **fetchDetails:** Setting `fetchDetails: false` returns list-page fields only; description fields will be `null`. *** ### Technical details - **Source:** jooble.org โ€” Global's job market - **Memory:** 256 MB - **Repost storage:** KeyValueStore `jooble-html-job-dedup`, 90-day TTL - **Retry:** Automatic retry on network errors, exponential backoff, 3 attempts per request *** ### Additional services Need a custom actor, additional filters, scheduled runs, or integration support? Send an email to โ€” we build on request. *** *Part of the [Unfenced Group](https://apify.com/unfenced-group) European job board scraper portfolio โ€” 50+ job markets covered.* *Built by [unfenced-group](https://apify.com/unfenced-group) ยท Issues? Open a ticket or send a message.* # Actor input Schema ## `keywords` (type: `string`): Job title or keywords to search for. Example: 'software developer', 'marketing manager'. ## `location` (type: `string`): City, region or country to search in. Example: 'Amsterdam', 'Netherlands', 'Berlin'. ## `country` (type: `string`): Country-specific Jooble domain to use. Leave empty for global (jooble.org). ## `maxResults` (type: `integer`): Maximum number of job listings to return. Set to 0 for no limit. ## `daysOld` (type: `integer`): Only return jobs posted within the last N days. Leave empty for all results. ## `skipReposts` (type: `boolean`): Skip duplicate listings seen in this run (same title + company + location). ## `startUrls` (type: `array`): Optional. Specific Jooble search URLs to scrape instead of building from keywords/location. Example: \[{"url": "https://nl.jooble.org/jobs-developer/Amsterdam"}]. ## `proxyConfiguration` (type: `object`): Residential proxy recommended for best results. ## Actor input object example ```json { "keywords": "", "location": "", "country": "", "maxResults": 5, "skipReposts": true, "startUrls": [], "proxyConfiguration": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } ``` # Actor output Schema ## `OUTPUT` (type: `string`): No 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 '' with your token const client = new ApifyClient({ token: '', }); // Prepare Actor input const input = {}; // Run the Actor and wait for it to finish const run = await client.actor("unfenced-group/jooble-html-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 '' with your token. client = ApifyClient("") # Prepare the Actor input run_input = {} # Run the Actor and wait for it to finish run = client.actor("unfenced-group/jooble-html-scraper").call(run_input=run_input) # Fetch and print Actor results from the run's dataset (if there are any) print("๐Ÿ’พ Check your data here: https://console.apify.com/storage/datasets/" + run["defaultDatasetId"]) for item in client.dataset(run["defaultDatasetId"]).iterate_items(): print(item) # ๐Ÿ“š Want to learn more ๐Ÿ“–? Go to โ†’ https://docs.apify.com/api/client/python/docs/quick-start ``` ## CLI example ```bash echo '{}' | apify call unfenced-group/jooble-html-scraper --silent --output-dataset ``` ## MCP server setup ```json { "mcpServers": { "apify": { "command": "npx", "args": [ "mcp-remote", "https://mcp.apify.com/?tools=unfenced-group/jooble-html-scraper", "--header", "Authorization: Bearer " ] } } } ``` ## OpenAPI specification ```json { "openapi": "3.0.1", "info": { "title": "Jooble Scraper โ€” 70+ Countries, Remote, Full Descriptions", "description": "Scrape 2M+ jobs from Jooble across 70+ countries. Remote filter, full descriptions, salary parsing, quality signals. $1.50/1k.", "version": "0.0", "x-build-id": "pdSKrt29sxBJChfOe" }, "servers": [ { "url": "https://api.apify.com/v2" } ], "paths": { "/acts/unfenced-group~jooble-html-scraper/run-sync-get-dataset-items": { "post": { "operationId": "run-sync-get-dataset-items-unfenced-group-jooble-html-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for its completion, and returns Actor's dataset items in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } }, "/acts/unfenced-group~jooble-html-scraper/runs": { "post": { "operationId": "runs-sync-unfenced-group-jooble-html-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor and returns information about the initiated run in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/runsResponseSchema" } } } } } } }, "/acts/unfenced-group~jooble-html-scraper/run-sync": { "post": { "operationId": "run-sync-unfenced-group-jooble-html-scraper", "x-openai-isConsequential": false, "summary": "Executes an Actor, waits for completion, and returns the OUTPUT from Key-value store in response.", "tags": [ "Run Actor" ], "requestBody": { "required": true, "content": { "application/json": { "schema": { "$ref": "#/components/schemas/inputSchema" } } } }, "parameters": [ { "name": "token", "in": "query", "required": true, "schema": { "type": "string" }, "description": "Enter your Apify token here" } ], "responses": { "200": { "description": "OK" } } } } }, "components": { "schemas": { "inputSchema": { "type": "object", "properties": { "keywords": { "title": "Keywords", "type": "string", "description": "Job title or keywords to search for. Example: 'software developer', 'marketing manager'.", "default": "" }, "location": { "title": "Location", "type": "string", "description": "City, region or country to search in. Example: 'Amsterdam', 'Netherlands', 'Berlin'.", "default": "" }, "country": { "title": "Country", "enum": [ "", "nl", "de", "be", "fr", "gb", "at", "ch", "pl", "es", "it", "us", "au", "ca", "in" ], "type": "string", "description": "Country-specific Jooble domain to use. Leave empty for global (jooble.org).", "default": "" }, "maxResults": { "title": "Max Results", "minimum": 0, "type": "integer", "description": "Maximum number of job listings to return. Set to 0 for no limit.", "default": 5 }, "daysOld": { "title": "Days Old", "minimum": 1, "type": "integer", "description": "Only return jobs posted within the last N days. Leave empty for all results." }, "skipReposts": { "title": "Skip Reposts", "type": "boolean", "description": "Skip duplicate listings seen in this run (same title + company + location).", "default": true }, "startUrls": { "title": "Start URLs", "type": "array", "description": "Optional. Specific Jooble search URLs to scrape instead of building from keywords/location. Example: [{\"url\": \"https://nl.jooble.org/jobs-developer/Amsterdam\"}].", "default": [] }, "proxyConfiguration": { "title": "Proxy Configuration", "type": "object", "description": "Residential proxy recommended for best results.", "default": { "useApifyProxy": true, "apifyProxyGroups": [ "RESIDENTIAL" ] } } } }, "runsResponseSchema": { "type": "object", "properties": { "data": { "type": "object", "properties": { "id": { "type": "string" }, "actId": { "type": "string" }, "userId": { "type": "string" }, "startedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "finishedAt": { "type": "string", "format": "date-time", "example": "2025-01-08T00:00:00.000Z" }, "status": { "type": "string", "example": "READY" }, "meta": { "type": "object", "properties": { "origin": { "type": "string", "example": "API" }, "userAgent": { "type": "string" } } }, "stats": { "type": "object", "properties": { "inputBodyLen": { "type": "integer", "example": 2000 }, "rebootCount": { "type": "integer", "example": 0 }, "restartCount": { "type": "integer", "example": 0 }, "resurrectCount": { "type": "integer", "example": 0 }, "computeUnits": { "type": "integer", "example": 0 } } }, "options": { "type": "object", "properties": { "build": { "type": "string", "example": "latest" }, "timeoutSecs": { "type": "integer", "example": 300 }, "memoryMbytes": { "type": "integer", "example": 1024 }, "diskMbytes": { "type": "integer", "example": 2048 } } }, "buildId": { "type": "string" }, "defaultKeyValueStoreId": { "type": "string" }, "defaultDatasetId": { "type": "string" }, "defaultRequestQueueId": { "type": "string" }, "buildNumber": { "type": "string", "example": "1.0.0" }, "containerUrl": { "type": "string" }, "usage": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "integer", "example": 1 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } }, "usageTotalUsd": { "type": "number", "example": 0.00005 }, "usageUsd": { "type": "object", "properties": { "ACTOR_COMPUTE_UNITS": { "type": "integer", "example": 0 }, "DATASET_READS": { "type": "integer", "example": 0 }, "DATASET_WRITES": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_READS": { "type": "integer", "example": 0 }, "KEY_VALUE_STORE_WRITES": { "type": "number", "example": 0.00005 }, "KEY_VALUE_STORE_LISTS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_READS": { "type": "integer", "example": 0 }, "REQUEST_QUEUE_WRITES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_INTERNAL_GBYTES": { "type": "integer", "example": 0 }, "DATA_TRANSFER_EXTERNAL_GBYTES": { "type": "integer", "example": 0 }, "PROXY_RESIDENTIAL_TRANSFER_GBYTES": { "type": "integer", "example": 0 }, "PROXY_SERPS": { "type": "integer", "example": 0 } } } } } } } } } } ```