# HelloWork FR Scraper: French Job Listings (`santamaria-automations/hellowork-fr-scraper`) Actor

Scrape job listings from HelloWork (hellowork.com), France's leading job board with 64M monthly visits. Returns title, company, location, French region and departement, contract type (CDI/CDD/Freelance/Alternance/Stage/Interim), salary, remote type (telework), experience level, and full description.

- **URL**: https://apify.com/santamaria-automations/hellowork-fr-scraper.md
- **Developed by:** [NanoScrape](https://apify.com/santamaria-automations) (community)
- **Categories:** Jobs, Lead generation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

Pay per event

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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — 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

## HelloWork FR Scraper: French Job Listings

Extract job listings from [HelloWork](https://www.hellowork.com) (hellowork.com), France's largest generalist job board with 64 million monthly visits. Formerly known as RegionsJob, HelloWork covers CDI, CDD, Stage, Alternance, Interim, and Freelance positions across all French regions, departements, and sectors.

No login required. No captcha. HTTP-only, no browser under the hood.

### What it does

Pulls live job listings from HelloWork by keyword, location, and contract type. Results include French-specific fields: departement code, administrative region, contract type in French (CDI/CDD/etc.), working time (temps plein/partiel), and remote type (teletravail integral, hybride, sur site).

Filter by:

- **Keywords**: job title, skill, or profession in French (e.g. "comptable", "infirmier", "developpeur")
- **Location**: French city or region (e.g. "Paris", "Lyon", "Bordeaux")
- **Contract type**: CDI, CDD, Interim, Stage, Alternance, Freelance
- **Remote only**: return only telework-eligible positions

### Sample output

```json
{
  "_type": "job",
  "id": "82639894",
  "title": "Coordinateur Caisse Accueil 35H H/F",
  "job_url": "https://www.hellowork.com/fr-fr/emplois/82639894.html",
  "source_url": "https://www.hellowork.com/fr-fr/emplois/82639894.html",
  "source_platform": "hellowork.com",
  "company_name": "Lidl",
  "company_website": null,
  "company_logo_url": "https://f.hellowork.com/img/entreprises/199012.png",
  "location": "Gardanne - 13",
  "country": "FR",
  "region": "Provence-Alpes-Cote d'Azur",
  "departement": "13",
  "posted_at_text": "25/08/2026",
  "posted_at_datetime": "2026-08-25T00:00:00Z",
  "employment_type": "full-time",
  "contract_type_fr": "CDI",
  "working_time": "temps plein",
  "experience_level": null,
  "remote_type": "sur site",
  "salary_min": 2214,
  "salary_max": 2319,
  "salary_currency": "EUR",
  "salary_period": "month",
  "salary_text": "2 214 - 2 319 EUR / mois",
  "description": "Gerer les operations de caisse et accueil client, superviser les equipes polyvalentes...",
  "description_full": "Gerer les operations de caisse...\n\nMissions:\n- Superviser les equipes polyvalentes\n- Gerer les flux de caisse\n- Assurer la conformite alimentaire",
  "description_html": "<p>Gerer les operations de caisse...</p>",
  "description_md": "Gerer les operations de caisse...\n\n- Superviser les equipes polyvalentes\n- Gerer les flux de caisse",
  "contact_emails": [],
  "contact_phones": [],
  "contact_urls": [],
  "apply_url": null,
  "search_query": "developpeur",
  "scraped_at": "2026-08-25T10:30:00Z"
}
```

### Pricing

| Event | Price |
|---|---|
| Actor start | $0.001 |
| SERP result (`includeJobDetails=false`) | $0.003 per job |
| Detail result (`includeJobDetails=true`) | $0.005 per job |

Typical cost: **$3 per 1,000 jobs** in SERP mode. Detail mode ($5/1,000) adds full HTML descriptions, salary details, and remote type.

**New to Apify?** Every account gets a $5 free monthly platform credit, enough for around 1,000 results before you pay anything.

### Input

| Field | Type | Default | Description |
|---|---|---|---|
| `searchQueries` | array of strings | - | French keywords: "developpeur", "comptable", "infirmier". Each runs as a separate search. |
| `searchUrls` | array of strings | - | Direct HelloWork search URLs. Wins over `searchQueries`. |
| `startUrls` | array of strings | - | Direct job detail page URLs to scrape (e.g. `https://www.hellowork.com/fr-fr/emplois/82639894.html`). |
| `location` | string | - | French city or region filter: "Paris", "Lyon", "Bordeaux", "Ile-de-France". |
| `contractType` | select | any | Filter by contract type: CDI, CDD, Interim, Stage, Alternance, Freelance. |
| `remoteOnly` | boolean | false | Only return telework-eligible positions. |
| `includeJobDetails` | boolean | false | Fetch full detail page: description\_full, description\_html, salary, remote\_type. Charges `job-detail-result`. |
| `includeCompanyDetails` | boolean | false | Surface company logo URL from detail page. |
| `maxResults` | integer | 5 | Total cap across all queries (max 5000). |
| `maxResultsPerQuery` | integer | 5 | Cap per individual keyword or URL. |
| `maxConcurrency` | integer | 5 | Parallel detail page fetches when includeJobDetails=true. |

### Output fields

**Identity**

- `id`: HelloWork job ID from URL
- `title`: position title
- `job_url`, `source_url`: canonical HelloWork listing URL

**Company**

- `company_name`: hiring company
- `company_website`: company URL (when available)
- `company_logo_url`: logo from HelloWork CDN

**Location (France-specific)**

- `location`: display string (city + departement code, e.g. "Paris - 75")
- `country`: always "FR"
- `region`: French administrative region (Ile-de-France, Auvergne-Rhone-Alpes, etc.)
- `departement`: departement number ("75", "69", "13", etc.)

**Contract and schedule (France-specific)**

- `contract_type_fr`: French contract label (CDI, CDD, Interim, Stage, Alternance, Freelance)
- `employment_type`: normalized English equivalent (full-time, fixed-term, internship, etc.)
- `working_time`: "temps plein" or "temps partiel"
- `remote_type`: "teletravail integral", "hybride", "teletravail", or "sur site"
- `experience_level`: Debutant, Junior, Confirme, Senior, Expert (inferred from description)

**Salary**

- `salary_min`, `salary_max`: numeric values when disclosed
- `salary_currency`: always "EUR"
- `salary_period`: year, month, hour, day
- `salary_text`: raw salary string from page

**Dates**

- `posted_at_text`: raw date (DD/MM/YYYY or relative, e.g. "il y a 2 jours")
- `posted_at_datetime`: ISO 8601 UTC

**Description (requires includeJobDetails=true)**

- `description`: ~500 character plain-text snippet
- `description_full`: full plain text with line breaks preserved
- `description_html`: raw HTML of job description
- `description_md`: Markdown rendering

**Contacts (requires includeJobDetails=true)**

- `contact_emails`: emails found in description
- `contact_phones`: phone numbers found in description
- `contact_urls`: external URLs found in description
- `apply_url`: external application URL when present

### Related actors

**Job aggregation**

- [Job Feed](https://apify.com/nanoscrape/job-feed) - Unified job feed combining multiple French and global sources into one normalized stream

**Career site scrapers**

- [Career Site Jobs Scraper](https://apify.com/nanoscrape/career-site-jobs-scraper) - Extract jobs from any company career page
- [Website Job Extractor](https://apify.com/nanoscrape/website-job-extractor) - Generic job extraction from any website

**French market peers**

- [Welcome to the Jungle Scraper](https://apify.com/santamaria-automations/wttj-jobs-scraper) - Tech and startup jobs from France's modern job board
- [Michael Page Scraper](https://apify.com/santamaria-automations/michaelpage-jobs-scraper) - Executive and specialist roles from Michael Page France
- [France Travail Scraper](https://apify.com/santamaria-automations/france-travail-scraper) - Official French government job board (Pole Emploi)

**General job boards**

- [Indeed Scraper](https://apify.com/santamaria-automations/indeed-camoufox-scraper) - Indeed France and global indeed.com listings

### Questions and support

Contact us at <contact@nanoscrape.com> or use the actor's Issues tab.

# Actor input Schema

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

One or more job titles or keywords to search on HelloWork. Each entry runs as a separate search. Examples: 'developpeur', 'comptable', 'infirmier'. Use French keywords for best results.

## `searchUrls` (type: `array`):

Direct HelloWork search URLs to crawl. Example: https://www.hellowork.com/fr-fr/emploi/metier\_developpeur-informatique.html

## `startUrls` (type: `array`):

Direct HelloWork job detail page URLs to scrape. Example: https://www.hellowork.com/fr-fr/emplois/82639894.html

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

French city or region to filter results. Examples: 'Paris', 'Lyon', 'Bordeaux', 'Ile-de-France'. Leave empty for all of France.

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

Filter by French contract type. Select a specific type or leave as 'any' for all.

## `remoteOnly` (type: `boolean`):

When enabled, only return jobs with remote work (telework) options.

## `includeJobDetails` (type: `boolean`):

When enabled, fetches the full job detail page for each listing to populate description\_full, description\_html, description\_md, salary, experience\_level, and contact fields. Charges the job-detail-result PPE event instead of job-serp-result.

## `includeCompanyDetails` (type: `boolean`):

Surface company logo URL and website from the job detail page. Requires a detail page fetch per listing.

## `maxResults` (type: `integer`):

Total cap across all search queries.

## `maxResultsPerQuery` (type: `integer`):

Maximum results per individual search keyword or URL.

## `maxConcurrency` (type: `integer`):

Maximum number of parallel detail page fetches (when includeJobDetails=true).

## Actor input object example

```json
{
  "searchQueries": [
    "developpeur"
  ],
  "location": "Paris",
  "contractType": "any",
  "remoteOnly": false,
  "includeJobDetails": false,
  "includeCompanyDetails": false,
  "maxResults": 5,
  "maxResultsPerQuery": 5,
  "maxConcurrency": 5
}
```

# Actor output Schema

## `jobListings` (type: `string`):

Dataset containing scraped HelloWork French job listings. Each row includes title, company, location, departement, region, contract\_type\_fr, salary, remote\_type, experience\_level, 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 = {
    "searchQueries": [
        "developpeur"
    ],
    "contractType": "any",
    "remoteOnly": false,
    "includeJobDetails": false,
    "includeCompanyDetails": false,
    "maxResults": 5,
    "maxResultsPerQuery": 5,
    "maxConcurrency": 5
};

// Run the Actor and wait for it to finish
const run = await client.actor("santamaria-automations/hellowork-fr-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": ["developpeur"],
    "contractType": "any",
    "remoteOnly": False,
    "includeJobDetails": False,
    "includeCompanyDetails": False,
    "maxResults": 5,
    "maxResultsPerQuery": 5,
    "maxConcurrency": 5,
}

# Run the Actor and wait for it to finish
run = client.actor("santamaria-automations/hellowork-fr-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": [
    "developpeur"
  ],
  "contractType": "any",
  "remoteOnly": false,
  "includeJobDetails": false,
  "includeCompanyDetails": false,
  "maxResults": 5,
  "maxResultsPerQuery": 5,
  "maxConcurrency": 5
}' |
apify call santamaria-automations/hellowork-fr-scraper --silent --output-dataset

```

## MCP server setup

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