# HelloWork Scraper (France Jobs) (`reventadata/hellowork-scraper`) Actor

Extract French job offers from hellowork.com by keyword and city. Each row has title, employer, location, contract type, published salary split into min, max and period, remote label and link. Filter by contract and date. Optional full description, dates, skills, industry and address.

- **URL**: https://apify.com/reventadata/hellowork-scraper.md
- **Developed by:** [reventadata](https://apify.com/reventadata) (community)
- **Categories:** Jobs, Automation
- **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 results

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

## HelloWork Scraper (DRAFT)

> **Unofficial.** This Actor is not affiliated with, authorised by, endorsed by, or in any
> way officially connected to HelloWork. "HelloWork" is a trademark of its respective owner and
> is used here only to describe what this tool reads. It reads the same public pages a browser does.

HelloWork Scraper turns a job search on hellowork.com (France) into a table: one row per job offer with title, employer, location, contract, the published salary, remote-work label, how long ago it was posted, and a link. Optionally it opens each offer for the full description, exact dates and structured salary.

### What does it do?

- Searches by job keyword and city, one search per keyword and city combination, or lists offers by filters alone.
- Filters by contract type (CDI, CDD, intérim, stage, alternance and the site's other types), by how recently the offer was posted, and sorts by relevance or newest first.
- Splits the salary the card shows ("32 000 - 36 000 € / an") into minimum, maximum, currency and period (year, month or hour), and keeps the original text.
- Optionally fetches each offer's page (`fetchDetails`) for the full description as plain text, exact publication and expiry dates, skills, industry, experience asked for and the workplace address.

### Why use it?

- **Structured columns:** employer, city and department, contract, salary range, remote label and the Super recruteur badge, each in its own field.
- **Clean results:** each offer once per run, even when searches overlap or the site shifts offers between pages.
- **Public data only:** the fields HelloWork shows on its public search and offer pages. Nothing from behind a login.

### How to use it

1. Add job keywords and cities (both optional) and pick the filters you want.
2. Set `maxItems` (and `maxPages` to limit the pages per search).
3. Run the Actor and download the dataset as JSON, CSV, Excel or XML.

#### Input

| Field | Type | Description |
|---|---|---|
| `searchQueries` | array | Job keywords, one search per entry, for example `comptable`. Empty means no keyword. |
| `locations` | array | French cities, one search per entry, for example `Lyon`. Empty means the whole country. |
| `contractType` | string | `any` (default), `CDI`, `CDD`, `Travail_temp` (intérim), `Stage`, `Alternance`, `Independant`, `Franchise`, `Associe`, `Fonctionnaire`, `Freelance`, `Stage_de_lycee`. |
| `datePosted` | string | `all` (default), `h` (last 24 hours), `d` (3 days), `w` (week), `m` (month). |
| `sortBy` | string | `relevance` (default) or `date` (newest first). |
| `fetchDetails` | boolean | One extra request per offer for the full description and exact dates. Default off. |
| `maxItems` | integer | Cap on rows across all searches. |
| `maxPages` | integer | Optional cap on result pages per search (30 offers per page). |
| `proxyConfiguration` | object | Optional proxy. Off by default. |

#### Sample input

```json
{
    "searchQueries": ["comptable"],
    "locations": ["Lyon"],
    "contractType": "CDI",
    "datePosted": "w",
    "sortBy": "date",
    "maxItems": 60,
    "maxPages": 2
}
```

#### Output

Each dataset item contains:

| Field | Type | Description |
|---|---|---|
| `id`, `title`, `url` | string | HelloWork's offer id, title and offer link (no tracking parameters). |
| `company` | string / null | Employer name as the card shows it. |
| `location`, `city`, `department` | string / null | Place as the card shows it ("Nantes - 44"), split into city and department code. |
| `contract` | string / null | Contract label, for example `CDI`. |
| `contractTag` | string / null | Extra tag beside the contract that is not a remote label, for example `1 mois` on a fixed-term contract. |
| `remote` | string / null | Remote label, for example `Télétravail partiel`. |
| `salaryText` | string / null | The salary as the card shows it. Null when the employer does not publish one. |
| `salaryMin`, `salaryMax`, `salaryCurrency`, `salaryPeriod` | number / string / null | The salary split out. `salaryPeriod` is `YEAR`, `MONTH` or `HOUR`. With `fetchDetails`, taken from the offer page's structured salary when it has one. |
| `postedRelative` | string / null | When it was posted, as the card words it ("il y a 2 jours"). The exact date is `datePosted` (needs `fetchDetails`). |
| `superRecruiter` | boolean | The card carries HelloWork's Super recruteur badge. |
| `searchUrl` | string | The search this row came from. |
| `datePosted`, `validThrough`, `employmentTypes`, `description`, `qualifications`, `skills`, `industry`, `occupationalCategory`, `experienceMonths`, `education`, `directApply`, `jobLocationType`, `addressLocality`, `addressRegion`, `addressPostalCode`, `addressCountry`, `companyUrl`, `companyLogoUrl` | mixed / null | Only with `fetchDetails`. |

#### Sample output

One real row (search "comptable", 2026-11-08):

```json
{
    "id": "84132314",
    "title": "Comptable Général Comptable H/F",
    "company": "JDL Conseil et Connexions",
    "url": "https://www.hellowork.com/fr-fr/emplois/84132314.html",
    "location": "Nantes - 44",
    "city": "Nantes",
    "department": "44",
    "contract": "CDI",
    "contractTag": null,
    "remote": "Télétravail occasionnel",
    "salaryText": "32 000 - 36 000 € / an",
    "salaryMin": 32000.0,
    "salaryMax": 36000.0,
    "salaryCurrency": "EUR",
    "salaryPeriod": "YEAR",
    "postedRelative": "il y a 2 jours",
    "superRecruiter": true,
    "searchUrl": "https://www.hellowork.com/fr-fr/emploi/recherche.html?k=comptable&p=1"
}
```

With `fetchDetails`, the same offer also carries (description shortened):

```json
{
    "datePosted": "2026-11-06T00:06:53Z",
    "validThrough": "2026-12-06T00:06:53Z",
    "employmentTypes": ["FULL_TIME"],
    "description": "Les missions du poste\nQui sommes-nous ?\nNotre cabinet JDL Conseil et Connexions est un spécialiste du secteur tertiaire et des fonctions supports (finance, assu...",
    "skills": ["Rapprochement bancaire", "Excel", "Établissement des déclarations fiscales"],
    "industry": "Services aux Entreprises",
    "occupationalCategory": "Comptabilité",
    "addressLocality": "Nantes",
    "addressRegion": "Pays de la Loire",
    "addressPostalCode": "44000"
}
```

### Things to know

- The result card shows only a relative date ("il y a 2 jours"). For the exact publication date, turn on `fetchDetails`.
- Salary appears only where the employer published one; the other rows have the salary fields empty.
- HelloWork's totals and order shift while a run goes on; each offer is returned once, but a very long run can miss offers that moved between pages.
- A search with no keyword and no city lists the whole site (hundreds of thousands of offers); use `maxItems` and `maxPages`.

For current pricing and details, see the Store page.

### Privacy & Compliance

This Actor reads only publicly accessible pages and returns the public data they show. It sends no login.

# Actor input Schema

## `searchQueries` (type: `array`):

Optional. Job titles or keywords, one search per entry, for example "comptable" or "infirmier". Leave empty to list jobs by location and filters only.

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

Optional. French cities, one search per entry, for example Lyon or Nantes. Leave empty for the whole country. A place the site does not know returns no results.

## `contractType` (type: `string`):

Only jobs with this contract. Any keeps every contract. Intérim is the site's Travail_temp value.

## `datePosted` (type: `string`):

Only jobs published within this period, as the site's own date filter. Any keeps every job.

## `sortBy` (type: `string`):

Order of the results: the site's relevance ranking, or newest first. Offers can shift between pages while a run goes on; each is pushed once.

## `fetchDetails` (type: `boolean`):

Open each job's page for the full description, publication and expiry dates, structured salary, skills, industry and address. One extra request per job, so the run is slower.

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

Hard cap on rows pushed across all searches.

## `maxPages` (type: `integer`):

Optional cap on result pages per search (30 jobs each). Without it a search walks every page the site reports, or stops at Maximum rows.

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

Optional proxy settings. Turn on only if you see request failures.

## Actor input object example

```json
{
  "searchQueries": [
    "comptable"
  ],
  "locations": [],
  "contractType": "any",
  "datePosted": "all",
  "sortBy": "relevance",
  "fetchDetails": false,
  "maxItems": 10,
  "maxPages": 1,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

Items scraped from the target website.

# 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 = {
    "searchQueries": [
        "comptable"
    ],
    "maxItems": 10,
    "maxPages": 1
};

// Run the Actor and wait for it to finish
const run = await client.actor("reventadata/hellowork-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 = {
    "searchQueries": ["comptable"],
    "maxItems": 10,
    "maxPages": 1,
}

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

```

## MCP server setup

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