# France Jobs & Salaries: HelloWork Hiring Data (`precious_bathmat/hellowork-job-scraper`) Actor

For recruiters and HR teams in France: HelloWork jobs with company, city, department, contract (CDI, CDD, intérim, alternance), salary, remote work and date, optional description and skills, plus a hiring report with salary ranges and contract mix.

- **URL**: https://apify.com/precious_bathmat/hellowork-job-scraper.md
- **Developed by:** [Mariam Ahmed](https://apify.com/precious_bathmat) (community)
- **Categories:** Jobs, Lead generation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.00 / 1,000 jobs

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

## France Jobs & Salaries: HelloWork Hiring Data

Scrape **jobs in France from HelloWork** (hellowork.com), one of France's biggest job sites, with no login and no API key, and get a **hiring report for every search**:

- **Every job**: title, company, city, department, **contract** (CDI, CDD, intérim, alternance, stage, freelance ...), contract length, **remote work**, **salary as shown** ("35 000 - 40 000 € / an") **and per year**, posted date, link
- **Job details** (optional): full description, candidate profile, **skills**, exact posting and closing dates, experience in months, education, industry, postcode, direct apply
- **Filters**: city, department, region or postcode, contract, remote policy, experience, full-time or part-time, **minimum yearly salary**, posted in the last 24 hours / 3 / 7 / 30 days
- **Report per search**: **every matching job by contract type and remote policy**, new jobs in the last 24 hours, **yearly salary ranges**, top companies, cities, departments and skills, freshness

### What does this HelloWork scraper do?

```
HelloWork · "comptable" (accountant) · 33,365 jobs in France · 1,802 new in 24 h
 CDI 84% · intérim 5% · partial remote 37%
 Salary shown on 88% · median 37,500 € a year (32,500 – 42,500)
```

1. Enter **keywords** (French or English) and optional **locations**: each keyword is searched in each place.
2. Pick filters: **contract**, **remote**, **experience**, **hours**, **minimum salary**, **posted within**.
3. Turn on **job details** for full descriptions and skills.
4. You get **one row per job** and **one report per search**.

```mermaid
flowchart LR
    A[Keywords,<br/>places,<br/>filters] --> B[HelloWork<br/>search<br/>30 per page]
    B --> C[Jobs<br/>contract, salary,<br/>remote, city]
    C --> D[Job pages<br/>description,<br/>skills, dates<br/>optional]
    A --> E[Counts per<br/>contract and<br/>remote policy]
    C --> F[Report<br/>salary ranges,<br/>contract mix,<br/>top companies]
    D --> F
    E --> F
```

### Who is it for?

- **Recruiters, staffing and interim agencies in France**: who is hiring for a role, where, on which contract, and at what pay
- **Sales teams selling to employers**: companies hiring now, by city and department
- **Job seekers and career coaches**: every open job for a role with salary and remote policy, in one sheet
- **HR and compensation teams**: what other employers pay for the same role in the same city
- **Analysts, economists and journalists**: contract mix (CDI vs intérim), remote work and pay across French occupations

### What data do you get?

**Jobs** (dataset, one row per job)

| Field | What it tells you |
|---|---|
| `id`, `title`, `url`, `company`, `anonymousEmployer` | The job and the employer (some stay anonymous) |
| `location`, `city`, `department` | Where, as HelloWork shows it ("Lyon 8e - 69") |
| `contract`, `contractDuration`, `remote` | CDI / CDD / intérim ..., length, remote policy |
| `salaryText`, `salaryMin`, `salaryMax`, `salaryPeriod` | Pay as the ad shows it |
| `salaryYearlyMin`, `salaryYearlyMax` | Pay per year, for comparing |
| `postedAgoText`, `approxPostedAt`, `applicationTracking` | When it was posted, and whether the recruiter shares application progress |
| `description`, `profile`, `skills` | With job details: the full ad |
| `datePosted`, `validThrough`, `experienceMonths`, `education`, `industry`, `occupation`, `postalCode`, `region`, `remoteAllowed`, `companyUrl`, `directApply` | With job details: the rest |

**Report** (`REPORTS`, one per search)

| Field | What it tells you |
|---|---|
| `totalOnHellowork`, `jobsRead`, `newLast24h` | Every matching job, how many were read, how many are new today |
| `allJobsByContract`, `allJobsByRemote` | Counts over **every** matching job |
| `salary` | Share with a salary, 25th / median / 75th percentile yearly midpoint, highest, and by period |
| `topCompanies`, `topCities`, `topDepartments`, `topSkills` | Who hires, where, and the skills asked (skills with details on) |
| `contractsRead`, `remoteRead`, `medianExperienceMonths`, `freshness` | Among the jobs read |

### Example: 20 October 2026

Five keywords across France, 1,000 newest jobs each: **5,000 jobs and 5 reports in 137 seconds**.

| Keyword | Jobs in France | New in 24 h | Main contract | Salary shown | Median yearly salary |
|---|---|---|---|---|---|
| commercial (sales) | 79,661 | 5,575 | CDI 56% | 52% | 27,000 € |
| comptable (accountant) | 33,365 | 1,802 | CDI 84% | 88% | 37,500 € |
| infirmier (nurse) | 27,404 | 1,795 | Intérim 40% | 83% | 29,300 € |
| développeur (developer) | 18,450 | 1,692 | CDI 62% | 53% | 43,000 € |
| chauffeur (driver) | 18,033 | 1,288 | Intérim 68% | 84% | 20,900 € |

- **Nurses and drivers are hired mostly through interim agencies** (Adecco Medical posted 370 of the 1,000 newest nurse jobs).
- **Remote work is a white-collar thing**: 37% of accountant jobs offer partial remote, under 1% of nurse and driver jobs.
- With job details, **data analyst** jobs in Paris, Lyon and Bordeaux (162 jobs) asked for **SQL, Python and Power BI** first and 12 months of experience; the Lyon median salary was 47,500 €.

### Pricing

**$0.001 per job**, **$0.001 per job details** (only when turned on) and **$0.02 per search report**.

- 200 jobs with a report: **$0.22**
- 200 jobs with details and a report: **$0.42**
- The run above (5,000 jobs, 5 reports): **$5.10**

### Good to know

- **Salary**: most HelloWork ads show one. The yearly figures convert months ×12, days ×218 and hours ×1,607 (the French full-time references), for comparison; part-time and alternance pay pull medians down.
- **Dates**: result pages say "il y a 3 jours", so `approxPostedAt` is approximate; with details on, it is the exact date.
- **Report counts** over every matching job take one extra search per contract type and remote policy (11 pages per search).
- **Search matching** is HelloWork's own and fairly broad: a keyword also finds related jobs.
- **Locations** are free text as on hellowork.com: city, department, region or postcode. Each keyword is searched in each place.
- Data comes from **HelloWork's public job search and job pages**. **Not affiliated with HelloWork.**

### Input

| Field | Meaning |
|---|---|
| **Keywords** | One search each; empty = every job |
| **Locations** | City, department, region or postcode; empty = all of France |
| **Contract** | CDI, CDD, intérim, alternance, stage, freelance, indépendant, fonctionnaire, franchise |
| **Remote work** | Full, partial, occasional, none |
| **Experience** | Beginners welcome, under 1 year, 2–3, 4–5, 6–10, over 10 years |
| **Working hours** | Full-time or part-time |
| **Minimum yearly salary** | e.g. 40000 |
| **Posted within** | 24 hours, 3, 7 or 30 days |
| **Sort** | Newest first or most relevant |
| **Jobs per search** | 1 to 20,000 (default 200) |
| **Job details** | Off by default |
| **Reports** | On by default |

### Integrations

Export to JSON, CSV, Excel or Google Sheets, or connect through the Apify API, webhooks, Make, Zapier and n8n. **Schedule it daily** with "Last 24 hours" for a feed of new jobs, or **monthly** with reports on to follow pay and hiring for a role. For more of Europe, see the [Welcome to the Jungle Jobs Scraper](https://apify.com/precious_bathmat/welcome-to-the-jungle-jobs-scraper).

### Related tools

Other tools from the same publisher that pair well with this one:

- [Welcome to the Jungle Jobs: Salaries, Remote & Employers](https://apify.com/precious_bathmat/welcome-to-the-jungle-jobs-scraper)
- [Denmark Jobs & Hiring Trends: Jobindex Employer Data](https://apify.com/precious_bathmat/jobindex-job-scraper)
- [UK Jobs & Salaries: Reed Hiring Data and Day Rates](https://apify.com/precious_bathmat/reed-job-scraper)
- [German Jobs & Salaries: Arbeitsagentur Hiring Data](https://apify.com/precious_bathmat/arbeitsagentur-job-scraper)

# Actor input Schema

## `keywords` (type: `array`):

Job titles or skills, one search each, in French or English, e.g. "comptable", "développeur", "infirmier", "commercial". Empty = every job (with the filters below).

## `locations` (type: `array`):

Optional places, one search each (combined with every keyword): a city ("Lyon"), a department ("Gironde"), a region ("Nouvelle-Aquitaine") or a postcode ("33000"). Empty = all of France.

## `contracts` (type: `array`):

Optional: only these contracts.

## `remote` (type: `array`):

Optional: only these remote policies.

## `experience` (type: `array`):

Optional: only jobs asking for this experience.

## `hours` (type: `string`):

Full-time or part-time only.

## `minSalary` (type: `integer`):

Optional: only jobs paying at least this much a year, e.g. 40000.

## `postedWithinDays` (type: `string`):

Only jobs posted in this period.

## `sort` (type: `string`):

Which jobs are read first when a search has more than the maximum.

## `maxJobsPerSearch` (type: `integer`):

Most jobs to read per search (1 to 20,000), 30 per page.

## `includeDetails` (type: `boolean`):

Open each job page for the full description, candidate profile, skills, exact posting date, closing date, experience in months, education, industry and postcode. One extra page per job, charged per job.

## `includeReports` (type: `boolean`):

One report per search: every matching job by contract type and remote policy, new jobs in the last 24 hours, plus yearly salary ranges, top companies, cities and departments, skills (with details) and freshness of the jobs read.

## Actor input object example

```json
{
  "keywords": [
    "comptable"
  ],
  "hours": "any",
  "postedWithinDays": "any",
  "sort": "date",
  "maxJobsPerSearch": 200,
  "includeDetails": false,
  "includeReports": true
}
```

# Actor output Schema

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

One row per job: title, company, city, department, contract, duration, remote, salary (as shown and per year), posted date, link; with details also description, profile, skills, closing date, experience, education, industry and postcode.

## `reports` (type: `string`):

Per search: every matching job by contract and remote policy, new in the last 24 hours, yearly salary ranges, top companies, cities, departments and skills, freshness.

## `reportsCsv` (type: `string`):

One flat row per search.

## `summary` (type: `string`):

Requests, problems and the limits of the data.

# 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 = {
    "keywords": [
        "comptable"
    ]
};

// Run the Actor and wait for it to finish
const run = await client.actor("precious_bathmat/hellowork-job-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 = { "keywords": ["comptable"] }

# Run the Actor and wait for it to finish
run = client.actor("precious_bathmat/hellowork-job-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 '{
  "keywords": [
    "comptable"
  ]
}' |
apify call precious_bathmat/hellowork-job-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,precious_bathmat/hellowork-job-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/tZDOnYruwR6IpDVgl/builds/drrJbdAgn8pccnsyA/openapi.json
