# France Jobs Aggregator: HelloWork + APEC Scraper (`frenchdatalab/france-jobs-aggregator`) Actor

Scrape French job offers from HelloWork and APEC in one run: keyword, city, department or region, contract, remote and date filters. Duplicates merged, direct employers vs agencies tagged, salaries structured, plus a list of companies hiring the most. JSON, CSV, Excel.

- **URL**: https://apify.com/frenchdatalab/france-jobs-aggregator.md
- **Developed by:** [French Data lab](https://apify.com/frenchdatalab) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.50 / 1,000 job offers

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 Aggregator: HelloWork + APEC Scraper

Get **every new job offer in France from HelloWork and APEC in a single run** — normalized, deduplicated and ready for Excel, Google Sheets, your CRM or your AI agent.

No more scraping each job board separately and cleaning the mess afterwards: search by keyword, city, department or region, filter by contract type, remote work and publication date, and receive one clean table where **the same offer posted on several boards appears only once**.

### What can you do with it?

- 🎯 **Find companies that are hiring (B2B lead generation).** A company that recruits is a company with budget and needs. Keep **direct employers only** (no recruitment agencies, no job-board re-posts) and every run also produces a **ranked list of the companies hiring the most** in your area and sector — perfect for recruitment agencies, staffing firms, HR software, B2B sales teams and consultants.
- 📬 **Monitor new offers daily.** Schedule the Actor with *Posted within: last 24 hours* and get only fresh offers every morning, by email, Slack, Google Sheets, Make, Zapier or n8n.
- 📊 **Analyze the French job market.** Salaries by city, contract mix, remote-friendliness, most in-demand skills for a job title — with structured salary ranges (min / max / period) instead of free text.
- 🤖 **Feed your job board, newsletter or AI assistant** with a clean, deduplicated feed of French job offers.
- 🔎 **Job seekers & career coaches:** one search across two major French boards, including APEC's executive (*cadre*) offers.

### Why this Actor?

| | This Actor | Single-board scrapers |
|---|---|---|
| HelloWork + APEC in one run | ✅ | ❌ one board each |
| Cross-board duplicate merging | ✅ (`sources` lists every board) | ❌ |
| Who published it: direct employer, agency, training center or job-board re-post | ✅ `publisherType` on every offer + filter | ❌ |
| Off-topic offers removed (keyword only in the description) | ✅ `titleMustMatch` | ❌ |
| Location as city, postal code, department or region | ✅ | Usually board-specific codes |
| Structured salary (min / max / period) | ✅ | Often raw text only |
| Correct timestamps (UTC) | ✅ both boards return Paris time labeled as UTC — we fix it | ⚠️ often 1–2 h off |
| "Companies hiring" summary | ✅ | ❌ |
| Respects your max cost per run | ✅ stops exactly at your budget | varies |

### Input

| Field | Description | Example |
|---|---|---|
| `queries` | Job titles or keywords, one per line | `["comptable", "contrôleur de gestion"]` |
| `location` | City, postal code, department number or region. Empty = all of France | `"Lyon"`, `"69003"`, `"13"`, `"Bretagne"` |
| `contractTypes` | `CDI`, `CDD`, `Interim`, `Alternance`, `Stage`, `Freelance`. Empty = all | `["CDI", "CDD"]` |
| `postedWithin` | `any`, `24h`, `3d`, `7d`, `30d` | `"24h"` |
| `remote` | `any`, `partial` (partial or full remote), `full` | `"full"` |
| `publisherTypes` | `employer` (direct employers), `agency` (recruitment firms, temp agencies), `trainingCenter`, `jobBoard` (APEC offers re-posted by other job boards). Default: all but `jobBoard` | `["employer"]` for lead generation |
| `titleMustMatch` | Keep only offers whose title contains your keyword (default `true`). Turn off for skills/tools like `python` or `SAP` | `true` |
| `sources` | `hellowork`, `apec` | both |
| `maxResults` | Maximum unique offers for the whole run | `500` |
| `includeDetails` | Open each HelloWork offer for full description, skills, exact date, expiry date, experience, industry | `true` |
| `deduplicate` | Merge the same offer found on several boards | `true` |

```json
{
    "queries": ["développeur python", "data engineer"],
    "location": "Île-de-France",
    "contractTypes": ["CDI"],
    "postedWithin": "7d",
    "remote": "partial",
    "maxResults": 500,
    "includeDetails": true
}
```

### Output

Each job offer is one dataset item:

```json
{
    "id": "hellowork:83926847",
    "title": "Collaborateur Comptable H/F",
    "company": "Hireos",
    "location": "Rillieux-la-Pape - 69",
    "city": "Rillieux-la-Pape",
    "department": "69",
    "postalCode": "69140",
    "region": "Auvergne-Rhône-Alpes",
    "contractType": "CDI",
    "publisherType": "employer",
    "salaryText": "34 000 - 38 000 € / an",
    "salaryMin": 34000,
    "salaryMax": 38000,
    "salaryPeriod": "year",
    "remote": null,
    "publishedAt": "2026-09-30T08:54:08Z",
    "publishedAtIsApproximate": false,
    "validThrough": "2026-10-30T09:54:08Z",
    "url": "https://www.hellowork.com/fr-fr/emplois/83926847.html",
    "sources": ["hellowork"],
    "otherUrls": [],
    "companyUrl": "https://www.hellowork.com/fr-fr/entreprises/hireos-93414.html",
    "companyLogo": "https://f.hellowork.com/img/entreprises/160_160/197419.png",
    "experienceMonths": 12,
    "skills": ["Bilan comptable", "Révision des comptes", "Autonomie"],
    "industry": ["Secteur informatique", "ESN"],
    "category": "Comptabilité",
    "description": "Détail du poste\n\nVOTRE MISSION ...",
    "query": "comptable",
    "scrapedAt": "2026-09-30T09:17:39Z"
}
```

- `sources` / `otherUrls`: when the same offer is published on both boards, you get it **once**, with every link.
- `remote`: `full`, `partial` (when you filtered on it), `possible` (the offer mentions remote work) or `null`.
- `publishedAtIsApproximate`: HelloWork search pages only show relative dates ("il y a 4 jours"); enable `includeDetails` to get exact timestamps.
- `descriptionSnippet`, `latitude`, `longitude`: available for APEC offers.

#### Companies hiring (key-value store record `COMPANIES`)

Real example (keyword `comptable`, location `Lyon`):

```json
[
    {
        "company": "Compagnie Fiduciaire",
        "publisherType": "employer",
        "openJobs": 4,
        "titles": ["Chef de Mission Comptable H/F", "Collaborateur Comptable Confirmé H/F", "Collaborateur Comptable H/F", "Expert Comptable H/F"],
        "locations": ["Caluire-et-Cuire - 69"],
        "contractTypes": {"CDI": 4},
        "latestPublishedAt": "2026-09-26T09:27:39Z",
        "sources": ["hellowork"]
    }
]
```

Job boards re-posting offers are never listed as hiring companies. Download it from the run's **Storage → Key-value store** tab.

### Pricing

Pay per result: you only pay for the unique job offers you receive. Duplicates merged across boards are **not** charged twice. Set a *maximum cost per run* and the Actor stops exactly there.

### Tips

- **Daily monitoring:** create a Schedule (e.g. every day at 8:00) with `postedWithin: "24h"` and connect an integration (Google Sheets, Slack, email, webhook).
- **Maximum coverage:** leave `contractTypes` empty and use several close keywords (`"comptable"`, `"assistant comptable"`, `"collaborateur comptable"`).
- **Executive roles only:** select only the `apec` source.
- **Internships and freelance** are only published on HelloWork: APEC is skipped automatically for those contract types.

### FAQ

**Is it legal?** This Actor only collects job offers that employers publish publicly to reach as many candidates as possible. It does not collect candidates' personal data. You are responsible for using the data in compliance with the GDPR and the boards' terms, especially if you contact companies.

**Which boards are next?** Welcome to the Jungle and France Travail are on the roadmap. Tell us which board you need in the Issues tab.

**Something broke?** Job boards change their pages from time to time. Open an issue with your run link and it will be fixed quickly.

***

#### 🇫🇷 En bref

Récupérez en un seul lancement **toutes les offres d'emploi HelloWork et APEC** : recherche par mot-clé, ville, code postal, département ou région, filtres par contrat (CDI, CDD, intérim, alternance, stage, freelance), télétravail et date de publication. Les doublons entre sites sont fusionnés, les offres hors sujet sont écartées, chaque offre indique **qui l'a publiée** (employeur direct, cabinet de recrutement / intérim, centre de formation), les salaires sont structurés (min / max / période) et chaque exécution produit la **liste des entreprises qui recrutent le plus** — idéal pour la prospection B2B, les cabinets de recrutement et la veille du marché de l'emploi. Export JSON, CSV, Excel, Google Sheets.

# Actor input Schema

## `queries` (type: `array`):

Job titles or keywords, one per line (e.g. "comptable", "développeur python", "infirmier"). Each keyword is searched on every selected job board.

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

City ("Lyon"), postal code ("69003"), department number ("69") or region ("Bretagne"). Leave empty to search all of France.

## `contractTypes` (type: `array`):

Leave empty for all contract types. Note: APEC only publishes CDI, CDD, intérim and alternance offers.

## `postedWithin` (type: `string`):

Only keep offers published recently. Ideal for daily or weekly monitoring with a schedule.

## `remote` (type: `string`):

Filter on remote-friendly offers.

## `publisherTypes` (type: `array`):

Direct employers only = best for B2B lead generation. 'Job board re-posts' are APEC offers re-published by other job boards (Hellowork, Cadremploi, Meteojob...): the company shown is then the job board, not the employer, so they are excluded by default.

## `titleMustMatch` (type: `boolean`):

Job boards also return offers that only mention your keyword somewhere in the description (e.g. 'comptable' returns building-site managers). Keep this on for job titles; turn it off for skills or tools (e.g. 'python', 'SAP').

## `sources` (type: `array`):

Job boards to search.

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

Maximum number of unique job offers to return for the whole run.

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

Open each HelloWork offer to get the full description, skills, exact publication date, expiry date, required experience, industry and company page. Slower.

## `deduplicate` (type: `boolean`):

When the same offer (same title, company and department) is published on several boards, return it once and list every source.

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

Not needed in most cases. Use Apify Proxy if you experience blocking on very large runs.

## Actor input object example

```json
{
  "queries": [
    "comptable"
  ],
  "location": "Lyon",
  "postedWithin": "any",
  "remote": "any",
  "publisherTypes": [
    "employer",
    "agency",
    "trainingCenter"
  ],
  "titleMustMatch": true,
  "sources": [
    "hellowork",
    "apec"
  ],
  "maxResults": 50,
  "includeDetails": false,
  "deduplicate": true,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}
```

# Actor output Schema

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

No description

## `companies` (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 '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "queries": [
        "comptable"
    ],
    "location": "Lyon",
    "maxResults": 50
};

// Run the Actor and wait for it to finish
const run = await client.actor("frenchdatalab/france-jobs-aggregator").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 = {
    "queries": ["comptable"],
    "location": "Lyon",
    "maxResults": 50,
}

# Run the Actor and wait for it to finish
run = client.actor("frenchdatalab/france-jobs-aggregator").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 '{
  "queries": [
    "comptable"
  ],
  "location": "Lyon",
  "maxResults": 50
}' |
apify call frenchdatalab/france-jobs-aggregator --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,frenchdatalab/france-jobs-aggregator"
        }
    }
}
```

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/AdGK8EnKcv3vSuvqG/builds/jq6cl10IooZfdSQlt/openapi.json