HelloWork Scraper — French Job Offers

Scrape job offers from HelloWork (hellowork.com), one of France's largest general job boards. Search by keyword, location, and contract type, then export clean structured data with companies, locations, salaries, contract types, skills, and full descriptions. No login, no cookies.

Why use this actor?

HelloWork is a mainstream French job board covering every sector and contract type — CDI, CDD, interim, alternance, stage, and freelance — across the whole country. If you build a jobs aggregator, run salary benchmarks, track hiring demand by region or industry, or feed a recruitment CRM, this actor turns the HelloWork search into a structured feed you can query on a schedule.

It reads the HelloWork search pages and each offer's own structured job data, so results are clean and complete. Every offer already carries its title, hiring company, location, contract type, salary (when published), and publication date. Turn on full descriptions and each row also gets the complete job text, listed skills, required education and experience, industry, and the exact ISO publish date.

How to scrape HelloWork data

1. Open the actor and set a Search Query in French — for example commercial, développeur, comptable, or infirmier.
2. Optionally set a Location (city, department, or region such as Paris, Lyon, or Bordeaux) and a Contract Type (CDI, CDD, Interim, Alternance, Stage, Freelance).
3. Set Max Results to the number of offers you want.
4. Leave Fetch Full Descriptions on for the complete job text and skills, or turn it off for faster listing-only results.
5. Keep the French residential proxy prefill and click Start.
6. When the run finishes, export the dataset as JSON, CSV, or Excel, or pull it from the Apify API.

The actor paginates through the HelloWork search results automatically (30 offers per page) until it reaches your Max Results or runs out of matching offers.

Input

Field	Type	Required	Description
searchQuery	String	No	Job search keyword in French (e.g. commercial, développeur). Defaults to commercial if empty.
location	String	No	City, department, or region (e.g. Paris, Lyon, Bordeaux). Leave empty for all of France.
contractType	String	No	all, CDI, CDD, INTERIM, ALTERNANCE, STAGE, or FREELANCE.
maxResults	Integer	No	Maximum number of offers to scrape (default: 100).
fetchDetails	Boolean	No	Fetch each offer's detail page for the full description, exact salary, skills, and dates (default: true).
proxyConfiguration	Object	No	Proxy settings. French residential proxies recommended.

Output

Each result contains:

Field	Type	Example
jobTitle	String	"Ingénieur Commercial - Ingénieure Commerciale H/F"
company	String	"Solutec"
companyUrl	String	Company page URL on hellowork.com
location	String	"Paris - 75"
city	String	"Paris"
region	String	"Île-de-France"
postalCode	String	"75000"
department	String	"75"
contractType	String	"CDI"
workType	String	"Temps plein"
salary	String	"30 000 - 45 000 € / an"
salaryMin	Number	30000
salaryMax	Number	45000
salaryCurrency	String	"EUR"
salaryPeriod	String	"annual"
jobDescription	String	Full job description text
skills	Array	["Prospection", "Négociation", ...]
experience	String	Required experience (when published)
education	String	Required education (when published)
industry	String	Industry / sector
remote	Boolean	true
publishedDate	String	"2026-07-09T12:41:09Z"
publishedText	String	"il y a 2 jours"
validThrough	String	"2026-08-08T12:41:09Z"
offerId	String	"81138425"
url	String	Full URL to the offer on hellowork.com
scrapedAt	String	ISO timestamp of when the row was scraped

Example output

{
    "jobTitle": "Commercial - Commerciale Paris H/F",
    "company": "LIVEMENTOR",
    "companyUrl": "https://www.hellowork.com/fr-fr/entreprises/livementor-12345.html",
    "location": "Paris - 75",
    "city": "Paris",
    "region": "Île-de-France",
    "postalCode": "75000",
    "department": "75",
    "contractType": "CDI",
    "workType": "Temps plein",
    "salary": "30 000 - 45 000 € / an",
    "salaryMin": 30000,
    "salaryMax": 45000,
    "salaryCurrency": "EUR",
    "salaryPeriod": "annual",
    "jobDescription": "Nous recherchons un commercial pour développer notre portefeuille clients...",
    "skills": ["Prospection", "Négociation", "CRM"],
    "experience": "24 mois",
    "education": "Bac +3",
    "industry": "Formation",
    "remote": false,
    "publishedDate": "2026-07-09T12:41:09Z",
    "publishedText": "il y a 2 jours",
    "validThrough": "2026-08-08T12:41:09Z",
    "offerId": "80877246",
    "url": "https://www.hellowork.com/fr-fr/emplois/80877246.html",
    "scrapedAt": "2026-07-09T10:00:00.000Z"
}

Salary parsing

HelloWork publishes salaries as free text (for example "30 000 - 45 000 € / an" or "2 050 - 2 630 € / mois"). The actor keeps the original text in salary and also parses it into salaryMin, salaryMax, salaryCurrency, and salaryPeriod where possible. Not every offer publishes a salary — those rows leave the salary fields empty, which is expected.

Cost estimate

With Fetch Full Descriptions on, the actor makes one extra request per offer to read its structured job data; with it off, it fetches one page per 30 offers. A typical run of a few hundred offers costs a small fraction of a dollar in Apify compute plus the pay-per-result fee. Turn off fetchDetails when you only need titles, companies, locations, salaries, contract types, and links — everything on the listing card.

Limitations / known issues

• General job board. HelloWork covers all sectors and contract types. For executive-only roles, pair it with an APEC scraper; for the national employment agency, pair it with a France Travail scraper.
• Salary is not always published. Many French offers omit salary. When present, both the raw text and parsed min/max are returned; when absent, the salary fields are empty.
• Location filter is text-based. The location input is passed to HelloWork's own search. It is not a radius search.
• education and experience depend on the recruiter. These come from each offer's structured data and are only populated when the recruiter filled them in.
• French residential proxy recommended. HelloWork serves reliably through French residential proxies; the prefill is set up for you.

Related scrapers

• APEC Scraper — France's executive (cadre) job board.
• France Travail Scraper — France's national employment agency (Pôle Emploi), full job market.
• Jobat Scraper — Belgian job board.
• Pracuj Scraper — Poland's largest job board.
• InfoJobs Scraper — Spain's largest job board.

Disclaimer

This actor collects only publicly available job-offer data from hellowork.com for legitimate use such as market research and job aggregation. Respect HelloWork's terms of service and applicable data-protection law when using the output.