HelloWork Scraper: French jobs with salaries, skills, companies and full descriptions

HelloWork Scraper collects job offers from hellowork.com, one of the largest job boards in France, without an account or cookies. Search by keyword and city with the same filters the site offers (contract type, remote work, experience, working time, date and minimum salary), or paste job and search links. Each job comes back as one clean row: title, company, city, region and postal code, contract, salary range in numbers, required experience and education, skills, sector, publication and expiry dates, the full description and the candidate profile.

It is used to monitor the French job market by role or region, to feed job alert and aggregator sites, to benchmark salaries, to find companies that are hiring (lead generation for recruiters, staffing and training agencies), and to build datasets for HR analytics and AI.

At a glance

What	Price
Job delivered	US$ 1.00 per 1,000 jobs (US$ 0.001 each)
Run start	US$ 0.005 per run

• 500 jobs with full details = US$ 0.505.
• Error rows, duplicates and jobs skipped by onlyNew are never charged. maxItems is a hard cap, and a spending limit set on the run stops it cleanly with everything delivered so far.
• About 150 jobs with full details in 12 seconds in our tests (one search, one job page per job).

Quick start

{
  "searchQueries": ["data analyst"],
  "location": "Paris",
  "maxItems": 50
}

Permanent contracts with partial remote work, published in the last week, at least 45,000 EUR a year, newest first:

{
  "searchQueries": ["software engineer", "devops"],
  "location": "Lyon",
  "radiusKm": 20,
  "contractTypes": ["CDI"],
  "remoteWork": ["Partiel"],
  "postedWithin": "w",
  "minYearlySalary": 45000,
  "sortBy": "date",
  "maxItems": 200
}

Links work too: job pages, search pages copied from the address bar (every filter in the link is kept) and category pages:

{
  "startUrls": [
    "https://www.hellowork.com/fr-fr/emplois/83247207.html",
    "https://www.hellowork.com/fr-fr/emploi/recherche.html?k=accountant&l=Bordeaux&c=CDI",
    "https://www.hellowork.com/fr-fr/emploi/domaine_achat.html"
  ],
  "maxItems": 100
}

An empty input runs the example search, so a first click on Start always returns data.

Input

Field	What it does
searchQueries	Keywords or job titles, one per line, in French or English. Each one is a separate search. Empty with a location = every job of that place.
location	City, department or region in France (Paris, Lyon, Gironde, Bretagne...). Empty = all of France.
radiusKm	Distance around the city in km (the site offers 10, 20, 30, 50 and 100).
contractTypes	CDI (permanent), CDD (fixed term), Travail_temp (interim), Stage (internship), Alternance (apprenticeship), Independant, Franchise, Associe, Fonctionnaire (civil service), Freelance, Stage_de_lycee.
postedWithin	all, h (24 hours), d (3 days), w (1 week), m (1 month).
experienceLevels	deb (beginners welcome), 0-1y, 2-3y, 4-5y, 6-10y, gt10y, unknown.
remoteWork	Complet (full remote), Partiel (hybrid), Occasionnel, Pas_teletravail (no remote).
workingTimes	ft (full time), pt (part time), np (not specified).
minYearlySalary	Minimum gross yearly salary in euros, up to 100000.
sortBy	relevance or date.
startUrls	Job links, search links and category links from hellowork.com.
includeDetails	On by default: opens each job page for the description, profile, salary numbers, skills, education, address and dates. Off: only the search card fields, faster.
maxItems	Cap for the whole run, across all searches (default 50; 0 = no cap).
onlyNew	For schedules: delivers only jobs not delivered in earlier runs of the same search.
proxyConfiguration	Apify datacenter proxy by default.

Common names from other job tools are accepted too: keyword, query, searchTerms, urls, city, where, maxResults, limit, jobType, datePosted, remote (true = full remote).

Output

Field	What it is
jobId, url	HelloWork job id and link
title	Job title as published
companyName, companyId, companyHelloworkUrl, companyLogo, companyCoverImage	Hiring company and its HelloWork page
location, city, region, postalCode, country	Where the job is
contractType	Contract as shown on the card (CDI, CDD, Stage, Alternance, Intérim...)
employmentType	Full time, part time, internship, temporary...
remoteAllowed, tags	Remote work flag and the card tags (for example "Télétravail partiel")
salaryText, salaryMin, salaryMax, salaryCurrency, salaryPeriod	Salary as shown and in numbers (yearly, monthly, hourly)
minExperienceMonths, educationLevels	Required experience in months and education level
skills, industries, category	Skills listed by the recruiter, company sector and job category
isSuperRecruiter, hasApplicationTracking, applyType, directApply	Recruiter badges and how the application works
reference	Recruiter's job reference
postedAgo, publishedAt, validThrough	Relative date on the card, publication date and expiry date (UTC)
description, descriptionHtml	Full job description as text and HTML
profile, profileHtml	The "profil recherché" section (who the company is looking for)
sourceQuery, scrapedAt	The search or link that found the job, and when

One real row (description and profile shortened):

{
  "type": "job",
  "jobId": "83247207",
  "url": "https://www.hellowork.com/fr-fr/emplois/83247207.html",
  "title": "Développeur - Développeuse Flutter H/F",
  "companyName": "Alpee",
  "companyId": "93511",
  "companyHelloworkUrl": "https://www.hellowork.com/fr-fr/entreprises/alpee-93511.html",
  "location": "Chambéry - 73",
  "city": "Chambéry",
  "region": "Auvergne-Rhône-Alpes",
  "postalCode": "73000",
  "country": "FR",
  "contractType": "CDI",
  "employmentType": ["Full time"],
  "remoteAllowed": true,
  "tags": ["Télétravail partiel"],
  "salaryText": "45 000 - 60 000 € / an",
  "salaryMin": 45000,
  "salaryMax": 60000,
  "salaryCurrency": "EUR",
  "salaryPeriod": "yearly",
  "minExperienceMonths": 12,
  "educationLevels": ["postgraduate degree"],
  "skills": ["Force de proposition", "Intelligence artificielle", "Firebase", "Autonomie", "Flutter"],
  "industries": ["Secteur informatique", "ESN"],
  "category": "Informatique",
  "hasApplicationTracking": true,
  "applyType": "ATS",
  "directApply": true,
  "reference": "4326656/30209705 DF/73C",
  "postedAgo": "il y a 6 jours",
  "publishedAt": "2026-10-11T00:09:45Z",
  "validThrough": "2026-11-10T00:09:45Z",
  "description": "Les missions du poste\n\nJeune société de conseil et d'ingénierie, ALPEE accompagne des entreprises industrielles du bassin Alpin...",
  "profile": "- Compétences techniques: Flutter : Firebase\n- Compétences approuvées sur les tests unitaires...",
  "sourceQuery": "developpeur"
}

Text comes in the language of the offer (almost always French). Emails and phone numbers inside descriptions are replaced with [contact removed]; no recruiter names are collected.

Errors you may see

Every error is a row with errorCode and is never charged:

errorCode	Meaning
INVALID_INPUT	A filter has a value the site does not offer (the message lists the valid ones)
INVALID_URL	Not a hellowork.com job, search or category link
NOT_FOUND	The job is no longer online (expired or filled) or the page does not exist
NO_RESULTS	The search and filters return no job; try fewer filters
NO_DATA	The job page opened without job data
BLOCKED	HelloWork refused every attempt; run it again in a few minutes
NOT_REACHED	The run time, maxItems or the cost guard arrived before this job link

Integrations, scheduling and AI agents

• Schedule a daily run with onlyNew: true and sortBy: date in Apify schedules to get only the jobs published since the last run.
• Export as JSON, CSV, Excel or XML, or read the dataset from the Apify API.
• Connect it to Make, n8n, Zapier, Google Sheets or Slack through Apify integrations, for example a new row in a sheet for every new CDI in your city.
• AI agents: call it as a tool through the Apify MCP server in Claude, ChatGPT, Cursor or any MCP client, for example "find 100 data engineer jobs in Paris published this week and give me the median salary and the top 10 skills".

FAQ

Do I need a HelloWork account? No. Everything comes from public pages, without login or cookies.

How many jobs can one search return? As many as the site lists for it, page after page (30 per page). Set maxItems to 0 to get them all; a broad keyword across France can have tens of thousands.

Why is the salary empty on some jobs? Many French offers do not publish a salary. When the recruiter gives one, you get the text and the numbers with the period (yearly, monthly or hourly).

Can I get only the jobs published today? Yes: postedWithin: "h" for the last 24 hours, or a schedule with onlyNew to receive each job once.

Does it work for jobs outside France? HelloWork lists jobs in France (including overseas departments). Use other job boards for other countries.

Is it legal? The Actor reads public job pages only and returns no personal data of candidates or recruiters. You are responsible for how you use the data under the laws that apply to you (including the GDPR).

Something broke or a field is missing? Open an issue on the Actor page; issues are answered within a day.

Limitations

• includeDetails: false returns only what the search card shows (title, company, location, contract, salary text, tags, relative date); numbers, skills, address and description need the job page.
• About 1 job in 40 (mostly offers from training centres) has no structured data on its page; those rows still get the description, profile, skills, reference and publication date from the page text, without the address fields.
• Company profiles and company reviews are not collected yet.
• Values are the ones HelloWork shows at the moment of the run.

Changelog

• 16 Oct 2026: first version: keyword and link search with every site filter, full job details from the job page, onlyNew for schedules, free error rows.