## HelloWork Jobs Scraper
**💰 $2.20 / 1 000 results** · pay only for results · no credit card to try
*We do the dirty work so your dataset stays clean.* 😈
Scrape French job offers from hellowork.com by keyword and city. One row per job: title, company, city and department, contract type, salary when disclosed, working hours, remote policy, posting date and apply method. We handle blocks and retries.
***
### 🎯 What this scrapes
HelloWork is France's biggest jobs board, but it has no public API and its search page is built for browsers. This Actor reads the same result pages and returns clean, deduplicated rows for every keyword and city you give it, with salary parsed into numbers and left empty when the employer did not disclose one.
### 🔥 What we handle for you
- 🛡️ **We send browser-grade requests** (curl-cffi Chrome impersonation) so HelloWork sees a real browser, not Python.
- 🔁 **We retry failed pages automatically** with exponential backoff, up to 5 attempts per page, honouring Retry-After.
- 🧹 **We parse the messy parts** — salary ranges, per-day rates and anonymous employers become clean fields.
- 🧊 **We keep the dataset clean** — Pydantic-validated rows, deduped by job id, ISO dates.
- 💰 **You pay only for results that land.** No jobs, no charge — only the small actor-start fee.
### 💡 Use cases
- **Recruiting pipelines** — pull fresh French openings for the roles and cities you hire in, on a schedule.
- **Salary and demand benchmarking** — track disclosed pay, contract types and remote policy across French cities.
- **Job aggregators** — feed clean, deduplicated French listings into your own board.
- **Labour-market research** — measure hiring volume by role, contract and city over time.
### ⚙️ How to use it
1. Click **Try for free** at the top of the page.
2. Fill in the input form — most fields have sensible defaults.
3. Click **Start**. Output streams into the run's dataset.
4. Export from **Storage → Dataset** as JSON, CSV, or Excel — or fetch via the API.
### 📥 Input
| Field | Type | Required | Default | Notes |
|---|---|:--:|---|---|
| `queries` | `array` | no | \['python', 'comptable'] | Job titles or keywords, for example python or comptable. Each query is searched separately. |
| `locations` | `array` | no | \['Paris'] | Optional French cities, for example Paris or Lyon. Each query runs once per city. Leave empty to search all of France. |
| `maxItems` | `integer` | no | 60 | Maximum job rows for each query and city combination. Each page holds 30 jobs. |
| `proxyConfiguration` | `object` | no | {'useApifyProxy': False} | Optional Apify Proxy. HelloWork answers without one, so the default is off. When a proxy is on, exits are pinned to… |
#### Example input
```json
{
"queries": [
"python"
],
"locations": [
"Paris"
],
"maxItems": 5
}
```
### 📤 Output
Every row is one dataset item.
| Field | Type | Notes |
|---|---|---|
| `jobId` | `string` | HelloWork job id; dedup key. |
| `title` | `string` | Job title. |
| `companyName` | `['string', 'null']` | Hiring company; null when anonymous. |
| `location` | `['string', 'null']` | Location as shown, e.g. Paris 1er - 75. |
| `city` | `['string', 'null']` | City part of the location. |
| `departmentCode` | `['string', 'null']` | French department code, e.g. 75. |
| `contractType` | `['string', 'null']` | Contract type as shown, e.g. CDI, CDD, Freelance, Intérim, Stage, Alternance. |
| `workingTime` | `['string', 'null']` | temps plein or temps partiel when stated. |
| `remotePolicy` | `['string', 'null']` | Remote policy as shown, e.g. Télétravail partiel or Télétravail occasionnel; null when absent. |
| `salaryText` | `['string', 'null']` | Salary as shown on the site with plain spaces; null when undisclosed. |
| `salaryMin` | `['integer', 'null']` | Minimum salary; equals salaryMax for a single value. |
| `salaryMax` | `['integer', 'null']` | Maximum salary. |
| `salaryCurrency` | `['string', 'null']` | Salary currency, e.g. EUR. |
| `salaryPeriod` | `['string', 'null']` | Salary period: year, day, month or hour. |
| `postedText` | `['string', 'null']` | Relative posting time, e.g. il y a 6 jours. |
| `postedAt` | `['string', 'null']` | ISO date derived from postedText and the run time. |
| `applyMethod` | `['string', 'null']` | How candidates apply, e.g. ATS, Mail, UrlWithForm. |
| `isSuperRecruiter` | `boolean` | Super recruiter badge. |
| `isApproximateMatch` | `boolean` | True when HelloWork marks the card as an approximate (non-exact) match for your query. |
| `isSponsored` | `boolean` | Promoted listing marker (best effort; we have not seen a sponsored card yet). |
| `companyLogoUrl` | `['string', 'null']` | Company logo URL. |
| `url` | `string` | HelloWork job page URL. |
| `query` | `string` | Search query that produced the row. |
| `searchLocation` | `['string', 'null']` | City filter used; null means all France. |
| `scrapedAt` | `string` | ISO-8601 UTC scrape time. |
#### Example output
```json
{
"jobId": "80459780",
"title": "Python Developer - Paris H/F",
"companyName": "Approach People Recruitment",
"location": "Paris - 75",
"city": "Paris",
"departmentCode": "75",
"contractType": "CDI",
"workingTime": "temps plein",
"remotePolicy": null,
"salaryText": "45 000 - 90 000 € / an",
"salaryMin": 45000,
"salaryMax": 90000,
"salaryCurrency": "EUR",
"salaryPeriod": "year",
"postedText": "il y a 5 heures",
"postedAt": "2026-10-08",
"applyMethod": "UrlWithForm",
"isSuperRecruiter": false,
"isApproximateMatch": false,
"isSponsored": false,
"companyLogoUrl": "https://f.hellowork.com/img/entreprises/192636.png",
"url": "https://www.hellowork.com/fr-fr/emplois/80459780.html",
"query": "python",
"searchLocation": "Paris",
"scrapedAt": "2026-10-08T09:30:00Z"
}
```
### 💰 Pricing
Pay-Per-Event — you pay only when these events fire:
| Event | USD | What it is |
|---|---:|---|
| `actor-start` | $0.2 | One-off warm-up charge per run |
| `result` | $0.002 | Per dataset item |
Example: 1 000 results at the rates above ≈ **$2.20**. No subscription, no minimum, no card to start — Apify gives every new account $5 of free credit.
### 🚧 Limitations
Version 1 returns listing data only: full job descriptions, filters such as contract or salary, and company pages are not included. Each search returns up to the pages HelloWork serves for it, 30 jobs per page, and never more than your Max jobs per search. isSponsored is best effort: we have not yet seen a sponsored card, so treat it as informational. Approximate matches are flagged with isApproximateMatch, not removed.
### ❓ FAQ
**Do I need a HelloWork account or API key?**
No. Give us keywords and optionally cities and we do the rest.
**How much does a run cost?**
Each job row costs $0.002, so 1 000 jobs cost $2.00, plus a one-off $0.20 start fee per run (about $2.20 for a 1 000-job run). A search that finds nothing only pays the start fee.
**Why is salary empty on many rows?**
Many employers do not disclose pay. We leave salary empty rather than returning a misleading 0. When pay is shown we give you the raw text plus min, max, currency and period (year, month, day or hour).
**Do I get full job descriptions?**
Not yet. Rows carry the listing data: title, company, location, contract, salary, remote policy, posting date and apply method, plus a link to the job page.
**What does isApproximateMatch mean?**
HelloWork mixes in near matches after the exact ones. We flag them instead of hiding them, so you can filter either way.
**Is the data in French?**
Yes. HelloWork is a French market: titles, contract names (CDI, CDD, Intérim) and remote labels stay as the site writes them, and salaries are in EUR.
**How is postedAt calculated?**
HelloWork shows relative ages such as il y a 5 jours. We keep that text in postedText and convert it to an ISO date from the run time in postedAt. A month counts as 30 days.
### 💬 Your feedback
Spotted a bug, hit a weird edge case, or need a new field? Open an
issue on the Actor's **Issues** tab on Apify Console — we ship
fixes weekly and we read every report.
***
Built by **[Devil Scrapes](https://apify.com/DevilScrapes)** 😈 — a small fleet of
opinionated public-data Actors. Honest pricing, real engineering, zero fine print.
# Changelog
This Actor's version history is a separate document: https://apify.com/devilscrapes/hellowork-jobs-scraper/changelog.md
# Actor input Schema
## `queries` (type: `array`):
Job titles or keywords, for example python or comptable. Each query is searched separately.
## `locations` (type: `array`):
Optional French cities, for example Paris or Lyon. Each query runs once per city. Leave empty to search all of France.
## `maxItems` (type: `integer`):
Maximum job rows for each query and city combination. Each page holds 30 jobs.
## `proxyConfiguration` (type: `object`):
Optional Apify Proxy. HelloWork answers without one, so the default is off. When a proxy is on, exits are pinned to France.
## Actor input object example
```json
{
"queries": [
"python",
"comptable"
],
"locations": [
"Paris"
],
"maxItems": 60,
"proxyConfiguration": {
"useApifyProxy": false
}
}
```
# Actor output Schema
## `datasetItems` (type: `string`):
All dataset items as JSON.
## `datasetItemsCsv` (type: `string`):
Same data exported to CSV.
## `datasetView` (type: `string`):
Open the run dataset in the Console.
# 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 '