HelloWork Jobs Scraper

Extract comprehensive job listings from Hellowork.com, France's leading job board. Collect detailed job opportunities including titles, companies, locations, salaries, and descriptions at scale. Perfect for recruitment research, market analysis, and job market monitoring.

Features

• Comprehensive Job Data — Capture complete job details including titles, companies, locations, salaries, contract types, and full descriptions
• Flexible Search Options — Search by keywords, locations, or specific categories to target precise job markets in France
• Automatic Pagination — Navigate through multiple search result pages to collect your desired number of results
• Structured Output — Clean, consistent JSON data ready for analysis or integration
• Proxy Support — Built-in proxy configuration for reliable, uninterrupted scraping

Use Cases

Recruitment Research

Analyze current job market trends and requirements. Identify in-demand skills and salary ranges across different industries in France.

Market Intelligence

Track job postings from competitors and industry leaders. Understand hiring patterns and strategic workforce planning.

Job Market Analysis

Build comprehensive datasets for labor market studies. Monitor employment opportunities and economic indicators.

Career Planning

Research salary ranges and job availability in specific locations. Make informed decisions about career moves and relocations.

---

Input Parameters

Parameter	Type	Required	Default	Description
keyword	String	No	—	Job title or skill to search for
location	String	No	—	Location filter for job search
category	String	No	—	Job category to filter by
startUrl	String	No	—	Specific Hellowork search URL to start from
results_wanted	Integer	No	100	Maximum number of job listings to collect
max_pages	Integer	No	20	Maximum number of search pages to visit
collectDetails	Boolean	No	true	Whether to collect full job descriptions
proxyConfiguration	Object	No	—	Proxy settings for enhanced reliability

---

Output Data

Each item in the dataset contains:

Field	Type	Description
title	String	Job position title
company	String	Hiring company name
category	String	Job category
location	String	Job location in France
salary	String	Salary information
contract_type	String	Type of employment contract
date_posted	String	Job posting date
description_html	String	Full job description in HTML
description_text	String	Plain text job description
url	String	Direct link to job posting

---

Usage Examples

Basic Job Search

Search for jobs by keyword and location:

{
    "keyword": "développeur web",
    "location": "Paris",
    "results_wanted": 50
}

Advanced Filtering

Use a specific search URL for targeted results:

{
    "startUrl": "https://www.hellowork.com/fr-fr/emploi/recherche.html?k=data%20analyst",
    "collectDetails": true,
    "max_pages": 10,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": ["RESIDENTIAL"]
    }
}

Category-Specific Search

Filter jobs by category:

{
    "keyword": "marketing",
    "category": "communication",
    "location": "Lyon",
    "results_wanted": 25
}

---

Sample Output

{
    "title": "Software Engineer H/F",
    "company": "TechCorp",
    "category": "IT",
    "location": "Paris - 75",
    "salary": "45 000 € / an",
    "contract_type": "CDI",
    "date_posted": "20/11/2025",
    "description_html": "<p>Detailed job description with requirements and benefits...</p>",
    "description_text": "Detailed job description with requirements and benefits...",
    "url": "https://www.hellowork.com/fr-fr/emplois/12345678.html"
}

---

Tips for Best Results

Optimize Search Terms

• Use specific job titles in French for better results
• Combine keywords with location for targeted searches
• Try broader terms if initial searches return few results

Configure Result Limits

• Start with smaller result counts for testing
• Increase gradually for production runs
• Balance data needs with execution time

Use Proxy Configuration

• Enable proxies for reliable, uninterrupted scraping
• Residential proxies recommended for best results
• Helps avoid rate limits and access restrictions

---

Integrations

Connect your job data with:

• Google Sheets — Export for team analysis and reporting
• Airtable — Build searchable job databases
• Slack — Get notifications for new job postings
• Webhooks — Send data to custom endpoints
• Make — Create automated job monitoring workflows
• Zapier — Trigger actions based on job criteria

Export Formats

Download data in multiple formats:

• JSON — For developers and APIs
• CSV — For spreadsheet analysis
• Excel — For business reporting
• XML — For system integrations

---

Frequently Asked Questions

How many job listings can I collect?

You can collect all available jobs from your search criteria. The practical limit depends on your search parameters and website availability.

Can I search in multiple locations?

Yes, you can run separate searches for different locations or use broader location terms to cover multiple areas.

What if salary information is missing?

Some job postings may not include salary details. The field will be empty if the information isn't provided by the employer.

How do I get full job descriptions?

Enable the collectDetails parameter to retrieve complete job descriptions from individual job pages.

Can I filter by contract type?

Use specific keywords in your search or browse categorized results to find particular contract types like CDI or CDD.

What languages are supported?

The scraper works with French job listings on Hellowork.com. Search terms should be in French for best results.

---

Support

For issues or feature requests, contact support through the Apify Console.

Resources

• Apify Documentation
• API Reference
• Scheduling Runs

---

Legal Notice

This actor is designed for legitimate data collection purposes. Users are responsible for ensuring compliance with website terms of service and applicable laws. Use data responsibly and respect rate limits.