HelloWork.fr Scraper

Extract structured job listing data from hellowork.com — one of France's largest job boards with over 700,000 active listings across all industries and regions. Filter by keyword, location, and contract type. Full job descriptions in HTML, plain text, and Markdown. Built-in deduplication and repost detection across runs.

---

Features

• Keyword & location search — search any job title, skill, or department across all French regions
• Contract type filtering — CDI, CDD, Interim, Stage, Alternance, Freelance
• Salary data — actual salary ranges where available, plus estimated salary percentiles (p10 / p25 / median / p75 / p90) powered by HelloWork's market data
• Rich categorisation — sector, occupational category, job function, skills, qualifications, and experience levels
• Triple description format — HTML, plain text, and Markdown in every result
• Cross-run deduplication — fingerprinting with 90-day TTL; mark or skip listings seen in previous runs
• daysOld filter — only return listings published within N days
• startUrls support — scrape specific job detail pages or custom search URLs directly

---

Input Parameters

Parameter	Type	Default	Description
keywords	String	""	Job title or keyword (e.g. "développeur", "infirmier")
location	String	""	City or region (e.g. "Paris", "Lyon", "Île-de-France")
contractType	String	""	One of: CDI, CDD, Interim, Stage, Alternance, Freelance
maxResults	Integer	5	Maximum number of results to return (0 = unlimited)
daysOld	Integer	0	Only return listings published within this many days (0 = disabled)
skipReposts	Boolean	false	Skip listings already seen in a previous run
startUrls	Array	[]	Specific HelloWork job URLs or search page URLs to scrape directly

Example inputs

Search for developers in Paris:

{
  "keywords": "développeur",
  "location": "Paris",
  "maxResults": 100
}

Recent nursing jobs on CDI contracts:

{
  "keywords": "infirmier",
  "contractType": "CDI",
  "daysOld": 14,
  "maxResults": 200
}

Scrape specific job listings:

{
  "startUrls": [
    { "url": "https://www.hellowork.com/fr-fr/emplois/77535148.html" },
    { "url": "https://www.hellowork.com/fr-fr/emplois/77194876.html" }
  ]
}

---

Output Schema

Each result contains the following fields:

Field	Type	Description
id	String	HelloWork's unique listing ID
url	String	Direct URL to the job listing
title	String	Job title
company	String	Employer name
location	String	Full location string
city	String	City
postalCode	String	Postal code
region	String	Region (e.g. "Île-de-France")
country	String	Country code (always "FR")
contractType	String	French contract label: CDI, CDD, Interim, Stage, Alternance, Freelance
sector	Array	Industry sectors
skills	Array	Required skills (when listed by employer)
qualifications	Array	Required education level(s) (e.g. ["Bac +5"])
experienceLevels	Array	Experience level label(s)
salaryMin	Number	Minimum salary (or p10 estimated)
salaryMax	Number	Maximum salary (or p90 estimated)
salaryMedian	Number	Median estimated salary for this role
salaryPeriod	String	Salary period: YEAR, MONTH, WEEK, DAY
salaryCurrency	String	Always "EUR"
publishDate	String	Publication date (YYYY-MM-DD)
descriptionHtml	String	Full job description as HTML
descriptionText	String	Full job description as plain text
descriptionMarkdown	String	Full job description as Markdown
isRepost	Boolean	true if this listing was seen in a previous run
originalPublishDate	String	Date first seen (if repost)
source	String	Always "hellowork.com"
scrapedAt	String	ISO 8601 timestamp of collection time

---

💰 Pricing

$0.99 per 1,000 results — you only pay for successfully retrieved listings. Failed retries and filtered reposts are never charged.

Results	Cost
100	~$0.10
1,000	~$0.99
10,000	~$9.90
100,000	~$99.00

Flat-rate alternatives typically charge $29–$49/month regardless of usage. At 10,000 results/month, this scraper costs significantly less with no commitment.

Use the Max results cap in the input to control your spend exactly.

---

Performance

Run size	Approx. time
100 listings	~2 min
1,000 listings	~15 min
10,000 listings	~2.5 hours

---

---

Examples

Developer jobs in Paris

{
  "keywords": "développeur",
  "location": "Paris",
  "maxResults": 50
}

CDI contracts in Lyon posted this week

{
  "keywords": "ingénieur",
  "location": "Lyon",
  "contractType": "CDI",
  "daysOld": 7,
  "maxResults": 100
}

Remote tech roles across France

{
  "keywords": "data scientist",
  "maxResults": 100
}

Daily incremental feed

{
  "keywords": "développeur web",
  "location": "Ile-de-France",
  "daysOld": 1,
  "skipReposts": true,
  "maxResults": 500
}

Known Limitations

• Salary availability: Not all employers publish salary information. HelloWork provides estimated salary percentiles (p10–p90) for most roles based on market data, even when employers do not specify an exact salary.
• Skills field: Often empty — HelloWork only populates it when the employer explicitly tags skills.
• Apply URL: Not exposed in the HTML. Use the url field as the canonical apply link.

---

Technical Details

• Source: hellowork.com — France's largest generalist job board
• Memory: 256 MB
• Repost storage: KeyValueStore hellowork-job-dedup, 90-day TTL
• Retry: Automatic retry on network errors, exponential backoff, 3 attempts per request

---

Additional Services

Need a custom actor, additional filters, scheduled runs, or integration support?.nl](mailto:info@unfencedgroup.nl) — we build on request.

---

---

Need a custom scraper?

Unfenced Group builds Apify actors for any website — for free.

If the site you need isn't in our portfolio yet, just ask. We scope, build, and publish it at no cost to you. You only pay for results — we absorb the compute and proxy costs ourselves. Same pay-per-result pricing, same quality, same standards as every actor in this portfolio.

Get in touch: www.unfencedgroup.nl