HelloWork Jobs Scraper

---

🎯 What this scrapes

HelloWork is France's biggest jobs board, but it has no public API and its search page is built for browsers. This Actor reads the same result pages and returns clean, deduplicated rows for every keyword and city you give it, with salary parsed into numbers and left empty when the employer did not disclose one.

🔥 What we handle for you

• 🛡️ We send browser-grade requests (curl-cffi Chrome impersonation) so HelloWork sees a real browser, not Python.
• 🔁 We retry failed pages automatically with exponential backoff, up to 5 attempts per page, honouring Retry-After.
• 🧹 We parse the messy parts — salary ranges, per-day rates and anonymous employers become clean fields.
• 🧊 We keep the dataset clean — Pydantic-validated rows, deduped by job id, ISO dates.
• 💰 You pay only for results that land. No jobs, no charge — only the small actor-start fee.

💡 Use cases

• Recruiting pipelines — pull fresh French openings for the roles and cities you hire in, on a schedule.
• Salary and demand benchmarking — track disclosed pay, contract types and remote policy across French cities.
• Job aggregators — feed clean, deduplicated French listings into your own board.
• Labour-market research — measure hiring volume by role, contract and city over time.

⚙️ How to use it

1. Click Try for free at the top of the page.
2. Fill in the input form — most fields have sensible defaults.
3. Click Start. Output streams into the run's dataset.
4. Export from Storage → Dataset as JSON, CSV, or Excel — or fetch via the API.

📥 Input

Field	Type	Required	Default	Notes
queries	array	no	['python', 'comptable']	Job titles or keywords, for example python or comptable. Each query is searched separately.
locations	array	no	['Paris']	Optional French cities, for example Paris or Lyon. Each query runs once per city. Leave empty to search all of France.
maxItems	integer	no	60	Maximum job rows for each query and city combination. Each page holds 30 jobs.
proxyConfiguration	object	no	{'useApifyProxy': False}	Optional Apify Proxy. HelloWork answers without one, so the default is off. When a proxy is on, exits are pinned to…

Example input

{
  "queries": [
    "python"
  ],
  "locations": [
    "Paris"
  ],
  "maxItems": 5
}

📤 Output

Every row is one dataset item.

Field	Type	Notes
jobId	string	HelloWork job id; dedup key.
title	string	Job title.
companyName	['string', 'null']	Hiring company; null when anonymous.
location	['string', 'null']	Location as shown, e.g. Paris 1er - 75.
city	['string', 'null']	City part of the location.
departmentCode	['string', 'null']	French department code, e.g. 75.
contractType	['string', 'null']	Contract type as shown, e.g. CDI, CDD, Freelance, Intérim, Stage, Alternance.
workingTime	['string', 'null']	temps plein or temps partiel when stated.
remotePolicy	['string', 'null']	Remote policy as shown, e.g. Télétravail partiel or Télétravail occasionnel; null when absent.
salaryText	['string', 'null']	Salary as shown on the site with plain spaces; null when undisclosed.
salaryMin	['integer', 'null']	Minimum salary; equals salaryMax for a single value.
salaryMax	['integer', 'null']	Maximum salary.
salaryCurrency	['string', 'null']	Salary currency, e.g. EUR.
salaryPeriod	['string', 'null']	Salary period: year, day, month or hour.
postedText	['string', 'null']	Relative posting time, e.g. il y a 6 jours.
postedAt	['string', 'null']	ISO date derived from postedText and the run time.
applyMethod	['string', 'null']	How candidates apply, e.g. ATS, Mail, UrlWithForm.
isSuperRecruiter	boolean	Super recruiter badge.
isApproximateMatch	boolean	True when HelloWork marks the card as an approximate (non-exact) match for your query.
isSponsored	boolean	Promoted listing marker (best effort; we have not seen a sponsored card yet).
companyLogoUrl	['string', 'null']	Company logo URL.
url	string	HelloWork job page URL.
query	string	Search query that produced the row.
searchLocation	['string', 'null']	City filter used; null means all France.
scrapedAt	string	ISO-8601 UTC scrape time.

Example output

{
  "jobId": "80459780",
  "title": "Python Developer - Paris H/F",
  "companyName": "Approach People Recruitment",
  "location": "Paris - 75",
  "city": "Paris",
  "departmentCode": "75",
  "contractType": "CDI",
  "workingTime": "temps plein",
  "remotePolicy": null,
  "salaryText": "45 000 - 90 000 € / an",
  "salaryMin": 45000,
  "salaryMax": 90000,
  "salaryCurrency": "EUR",
  "salaryPeriod": "year",
  "postedText": "il y a 5 heures",
  "postedAt": "2026-10-08",
  "applyMethod": "UrlWithForm",
  "isSuperRecruiter": false,
  "isApproximateMatch": false,
  "isSponsored": false,
  "companyLogoUrl": "https://f.hellowork.com/img/entreprises/192636.png",
  "url": "https://www.hellowork.com/fr-fr/emplois/80459780.html",
  "query": "python",
  "searchLocation": "Paris",
  "scrapedAt": "2026-10-08T09:30:00Z"
}

💰 Pricing

Pay-Per-Event — you pay only when these events fire:

Event	USD	What it is
actor-start	$0.2	One-off warm-up charge per run
result	$0.002	Per dataset item

Example: 1 000 results at the rates above ≈ $2.20. No subscription, no minimum, no card to start — Apify gives every new account $5 of free credit.

🚧 Limitations

Version 1 returns listing data only: full job descriptions, filters such as contract or salary, and company pages are not included. Each search returns up to the pages HelloWork serves for it, 30 jobs per page, and never more than your Max jobs per search. isSponsored is best effort: we have not yet seen a sponsored card, so treat it as informational. Approximate matches are flagged with isApproximateMatch, not removed.

❓ FAQ

Do I need a HelloWork account or API key?

No. Give us keywords and optionally cities and we do the rest.

How much does a run cost?

Each job row costs $0.002, so 1 000 jobs cost $2.00, plus a one-off $0.20 start fee per run (about $2.20 for a 1 000-job run). A search that finds nothing only pays the start fee.

Why is salary empty on many rows?

Many employers do not disclose pay. We leave salary empty rather than returning a misleading 0. When pay is shown we give you the raw text plus min, max, currency and period (year, month, day or hour).

Do I get full job descriptions?

Not yet. Rows carry the listing data: title, company, location, contract, salary, remote policy, posting date and apply method, plus a link to the job page.

What does isApproximateMatch mean?

HelloWork mixes in near matches after the exact ones. We flag them instead of hiding them, so you can filter either way.

Is the data in French?

Yes. HelloWork is a French market: titles, contract names (CDI, CDD, Intérim) and remote labels stay as the site writes them, and salaries are in EUR.

How is postedAt calculated?

HelloWork shows relative ages such as il y a 5 jours. We keep that text in postedText and convert it to an ISO date from the run time in postedAt. A month counts as 30 days.

💬 Your feedback

Spotted a bug, hit a weird edge case, or need a new field? Open an issue on the Actor's Issues tab on Apify Console — we ship fixes weekly and we read every report.

---