HelloWork Jobs Scraper

Effortlessly scrape and collect job listings from Hellowork.com, France's leading job board. This powerful Apify actor automates the extraction of job opportunities, including titles, companies, locations, salaries, and detailed descriptions, directly from Hellowork's search results and individual job pages.

🚀 Key Features

• ⚡ Hybrid Architecture: Uses ultra-fast Cheerio crawler for list pages (10-20x faster) + Playwright only for detail pages requiring JavaScript
• 🎯 Comprehensive Job Data Extraction: Captures essential job details such as title, company, location, salary, contract type, posting date, and full descriptions
• 💰 Low Memory Footprint: Cheerio-based list scraping uses 80-90% less memory than full browser automation
• 🔍 Flexible Search Options: Search by keywords, locations, or categories to target specific job markets in France
• 📄 Pagination Handling: Automatically navigates through multiple search result pages with minimal resource usage
• 🎭 Stealth & Anti-Detection: Fingerprinting, UA rotation, session pooling, proxy support for reliable enterprise scraping
• 📊 Structured Output: Saves data in clean, consistent JSON format ready for analysis or integration
• 🌐 Proxy Support: Built-in support for Apify proxies to handle rate limits and ensure reliable scraping
• 📈 Production-Ready: Optimized for speed, memory efficiency, and large-scale job data collection

📋 Input Parameters

Configure the scraper with the following options to customize your job search:

Parameter	Type	Description	Default
keyword	string	Job title or skill to search for (e.g., "software engineer", "chef de projet").	-
location	string	Location filter (e.g., "Paris", "Lyon").	-
category	string	Job category to filter by (if supported by Hellowork).	-
startUrl / url / startUrls	string/array	Specific Hellowork search URL(s) to start from. Overrides keyword/location if provided.	-
results_wanted	integer	Maximum number of job listings to collect.	100
max_pages	integer	Maximum number of search pages to visit.	20
collectDetails	boolean	Whether to visit job detail pages for full descriptions.	true
proxyConfiguration	object	Proxy settings for enhanced scraping reliability.	Apify Proxy recommended

Example Input Configuration

{
  "keyword": "développeur web",
  "location": "Paris",
  "results_wanted": 50,
  "collectDetails": true,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}

📊 Output Data Structure

Each scraped job is saved as a JSON object with the following fields:

{
  "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...</p>",
  "description_text": "Plain text version of the job description...",
  "url": "https://www.hellowork.com/fr-fr/emplois/12345678.html"
}

• title: Job position title
• company: Hiring company name
• category: Job category (if available)
• location: Job location in France
• salary: Salary information (when provided)
• contract_type: Type of contract (CDI, CDD, etc.)
• date_posted: Job posting date
• description_html: Full job description in HTML format
• description_text: Plain text version of the description
• url: Direct link to the job posting on Hellowork

🛠️ Usage Examples

Basic Job Search

Run the actor with simple keyword and location inputs to collect recent job listings:

{
  "keyword": "marketing",
  "location": "Lille",
  "results_wanted": 25
}

Advanced Configuration

For targeted scraping with proxy support:

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

Integration with Apify API

Use the Apify API to run the scraper programmatically:

curl -X POST https://api.apify.com/v2/acts/your-actor-id/runs \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"keyword": "vendeur", "location": "Marseille", "results_wanted": 100}'

⚙️ Configuration Best Practices & Memory Requirements

💾 Memory Recommendations

Hybrid Architecture Memory Usage:

• Minimum (Development/Testing): 2 GB - Supports low concurrency (1-3 jobs at a time)
• Recommended (Production): 4 GB - Optimal for concurrency 5-10 with stable performance
• High Volume: 8 GB - For heavy workloads with 15+ concurrent detail page extractions

Why Hybrid is Faster:

• LIST pages: Cheerio crawler uses ~50-100 MB per page (no browser overhead)
• DETAIL pages: Playwright uses ~400-600 MB per browser instance (JavaScript execution required)
• Overall: 80-90% memory reduction vs full Playwright scraping

⚡ Performance Configuration

• Proxy Usage: Always enable proxy configuration to avoid IP blocking and ensure smooth scraping
• Result Limits: Set reasonable results_wanted values to balance data volume and execution time
• Detail Scraping: Enable collectDetails for comprehensive data - Playwright only runs for detail pages
• Concurrency: CheerioCrawler runs at 20 concurrent requests, PlaywrightCrawler at 10 (auto-optimized)
• Rate Limiting: The actor handles rate limits automatically with session pooling

🔧 Troubleshooting

Common Issues

• No Results Found: Verify keyword and location spellings. Try broader search terms.
• Incomplete Data: Ensure collectDetails is enabled for full descriptions.
• Rate Limiting: Use proxy configuration to distribute requests.
• Timeout Errors: Reduce results_wanted or increase timeout settings.

Performance Tips

• For large datasets, run the actor during off-peak hours.
• Use specific keywords to reduce irrelevant results.
• Monitor dataset size to avoid exceeding Apify storage limits.

📈 SEO and Discoverability

This scraper is optimized for finding French job market data. Keywords include: Hellowork scraper, French jobs, emploi France, job listings France, automated job scraping, recruitment data, Hellowork API alternative.

🤝 Support and Resources

For questions or issues:

• Check the Apify community forums
• Review Hellowork's terms of service before large-scale scraping
• Ensure compliance with local data protection regulations

Last updated: November 2025