HelloWork FR Scraper: French Job Listings

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.

What you get

• contract_type_fr: French contract label - CDI, CDD, Interim, Stage, Alternance, Freelance - preserved in original French terminology
• departement: French departement number ("75", "69", "13") - unique geographic field no other scraper surfaces
• region: French administrative region (Ile-de-France, Auvergne-Rhone-Alpes, etc.)
• remote_type: "teletravail integral", "hybride", or "sur site" - in native French taxonomy
• salary_min / salary_max: numeric EUR salary range when disclosed, plus salary_text and salary_period
• working_time: "temps plein" or "temps partiel" - direct from the listing
• experience_level: Debutant, Junior, Confirme, Senior, Expert
• description_html / description_md: full job description in HTML and Markdown (requires includeJobDetails=true)

Input example

{
  "searchQueries": ["developpeur", "comptable"],
  "location": "Paris",
  "contractType": "CDI",
  "remoteOnly": false,
  "includeJobDetails": true,
  "maxResultsPerQuery": 100
}

Output example

{
  "_type": "job",
  "id": "82639894",
  "title": "Coordinateur Caisse Accueil 35H H/F",
  "job_url": "https://www.hellowork.com/fr-fr/emplois/82639894.html",
  "source_platform": "hellowork.com",
  "company_name": "Lidl",
  "company_logo_url": "https://f.hellowork.com/img/entreprises/199012.png",
  "location": "Gardanne - 13",
  "country": "FR",
  "region": "Provence-Alpes-Cote d'Azur",
  "departement": "13",
  "contract_type_fr": "CDI",
  "working_time": "temps plein",
  "remote_type": "sur site",
  "salary_min": 2214,
  "salary_max": 2319,
  "salary_currency": "EUR",
  "salary_period": "month",
  "posted_at_datetime": "2026-08-25T00:00:00Z",
  "scraped_at": "2026-08-25T10:30:00Z"
}

Who should use this

Related tutorials

• How to scrape every job online
• How to scrape HelloWork.com - French job listings guide

Integrations

• n8n / Make / Zapier — trigger runs and process results via webhook
• AI Agents (MCP) — Claude Desktop, Cursor, VS Code, LangChain, LlamaIndex
• Python / Node.js — Apify SDK for programmatic access
• Google Sheets / Airtable — export via Apify integrations

Run this actor directly on Apify (no code)

Click Open on Apify above to run hellowork-fr-scraper in your browser - no code, no install. In the Apify console you get:

• One-click test - fill in the input form, or paste the JSON example above into the JSON editor tab, then hit Start.
• Live output - watch rows stream into an interactive Output table as they arrive, or flip to the raw JSON / Log view.
• Export in any format - one click to download the dataset as JSON, CSV, XML, Excel, HTML table, RSS, or JSONL.
• Schedules - run this actor daily, weekly, hourly, or on a custom cron. Apify handles timing and stores every dataset run.
• Integrations & webhooks - fire a webhook on success/failure, or plug into Zapier, n8n, Make, Airbyte, Google Sheets, Slack, S3, Postgres, and more from the Actions tab.
• Transparent cost - see exact usage against your $5/month free tier before you spend a cent.

Get your Apify API token

To run this actor from your own code you need an Apify API token. Get one in about a minute:

1. Sign up for a free Apify account (Google, GitHub, or email).
2. Go to Settings → Integrations → API tokens.
3. Click Create a new API token. Copy it and keep it secret.

Free tier: Apify credits your account with $5 of platform usage every month, no credit card required. Enough to test any actor meaningfully - at $0.001 per result on typical scrapers, that is roughly 5,000 results for free every month.

Call from code

Run this actor from any language via the Apify REST API. Replace YOUR_TOKEN with your API token and adapt the input JSON to your needs.

curl -X POST "https://api.apify.com/v2/acts/santamaria-automations~hellowork-fr-scraper/run-sync-get-dataset-items?token=YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{}'

// npm install apify-client
import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_TOKEN' });
const run = await client.actor('santamaria-automations/hellowork-fr-scraper').call({});
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

# pip install apify-client
from apify_client import ApifyClient

client = ApifyClient('YOUR_TOKEN')
run = client.actor('santamaria-automations/hellowork-fr-scraper').call(run_input={})
items = list(client.dataset(run['defaultDatasetId']).iterate_items())
print(items)

// dotnet add package Apify.Client
using Apify.Client;

var client = new ApifyClient("YOUR_TOKEN");
var run = await client.Actor("santamaria-automations/hellowork-fr-scraper").CallAsync(new { });
var items = await client.Dataset(run.DefaultDatasetId).ListItemsAsync();

// Maven: com.apify:apify-client
import com.apify.client.ApifyClient;

ApifyClient client = new ApifyClient("YOUR_TOKEN");
ActorRun run = client.actor("santamaria-automations/hellowork-fr-scraper").call(Map.of());
List<Map<String,Object>> items = client.dataset(run.getDefaultDatasetId()).listItems();

Use with AI agents (MCP)

This actor is available on the Apify MCP server, so you can drive it from any MCP-compatible AI client - Claude Desktop, Claude.ai, Cursor, VS Code, LangChain, LlamaIndex, or a custom agent - without writing any code.

https://mcp.apify.com?tools=santamaria-automations/hellowork-fr-scraper

Example prompt once connected:

"Use <code>hellowork-fr-scraper</code> to run a scrape on my target list and give me the results as a table."

Clients that support dynamic tool discovery (Claude.ai, VS Code) receive the full input schema automatically via add-actor.

Use with no-code platforms

Trigger this actor from your favorite automation tool. Every platform below can call the Apify API in a few clicks - no code required.