# HelloWork Jobs Scraper: French Jobs, Salary and France Travail (`themineworks/hellowork-jobs-scraper`) Actor

Scrape HelloWork job offers by keyword and place, plus France Travail (Pole emploi) as a second source: one row per job with company, city, contract, salary min and max, telework, posted date, full description, skills and ROME code. No login, no API key.

- **URL**: https://apify.com/themineworks/hellowork-jobs-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Jobs, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 1 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.72 / 1,000 jobs

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## HelloWork Jobs Scraper: French Jobs, Salary and France Travail

[![40 French job offers from HelloWork and France Travail with salary, contract and full description in 8 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/hellowork-jobs-scraper-hero.png)](https://console.apify.com/actors/IcpHRxkcyNTqSJte8/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Returns French job offers from HelloWork by keyword and place, and from France Travail (formerly Pole emploi) with the same search if you want, one row per job with company, city, postal code, contract, salary range, telework, posted date, full description and skills. No login, no cookies, no API key. You pay $0.90 per 1,000 jobs on the Free plan and $0.72 per 1,000 on the Gold plan, plus a $0.001 start fee per run.

From **The Mine Works**, with over 335,000 runs across 330+ public actors.

Updated 12 Nov 2026: first release. HelloWork and France Travail in one actor, keyword and place search, pasted search links, contract, date, telework, salary and radius filters, and full job details (description, skills, education, experience, ROME code), one flat row per job. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **Two French job sites, one schema.** HelloWork is the default. Tick France Travail too and the same keywords, place and filters run there, with every row in the same columns and a `source` field. France Travail also carries offers from its partner sites, marked `is_partner_offer`.
- **Salary in numbers you can sort.** `salary_min`, `salary_max`, `salary_currency` and `salary_period` (YEAR, MONTH, DAY or HOUR) are parsed from French formats such as "46 000 - 53 000 € / an" and "Mensuel de 2900.0 Euros à 4500.0 Euros". `salary_is_estimate` says when HelloWork shows its own estimate instead of the employer's figure.
- **The whole offer, not just the card.** With details on (the default), each job adds the full description, skills, education, experience, sector, postal code, valid through date and, on France Travail, the ROME job code, working hours, languages, driving licences and benefits. In our test runs on Apify, 1,621 of 1,622 jobs came back with their details (the other had been removed by the employer).
- **Pay per job, nothing for errors.** Links that are not HelloWork or France Travail links, the summary row and a job found twice in one run are never charged. Details cost nothing extra.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/IcpHRxkcyNTqSJte8/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works Jobs and hiring family:** [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Shine.com Jobs Scraper](https://apify.com/themineworks/shine-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Internshala Scraper](https://apify.com/themineworks/internshala-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns 20 accountant jobs in Lyon from HelloWork and 20 from France Travail, with full details. It took 8 seconds in our test run on Apify:

```json
{
  "searchQueries": ["comptable"],
  "location": "Lyon",
  "sources": ["hellowork", "francetravail"],
  "maxItems": 20
}
```

Put several keywords on separate lines to run several searches at once. Leave `location` empty for all of France.

Apify's free plan includes $5 of credit every month, which covers about 5,000 jobs at this actor's price.

#### Copy to your AI assistant

```text
themineworks/hellowork-jobs-scraper on Apify. Searches French job offers on HelloWork (and France Travail, formerly Pole emploi, if asked) and returns one flat row per job, no login. Call ApifyClient("TOKEN").actor("themineworks/hellowork-jobs-scraper").call(run_input={"searchQueries": ["comptable"], "location": "Lyon", "maxItems": 100}), then client.dataset(run["defaultDatasetId"]).list_items().items. Give searchQueries (keywords), location (French city, postal code, departement number or name, or region; empty = all France), startUrls (HelloWork or France Travail search links), or a mix. Optional: sources (["hellowork"] default, add "francetravail"), maxItems (default 50, 1 to 5000, per keyword per site; France Travail serves at most 1000 per search), includeDetails (default true), contractTypes (cdi, cdd, interim, alternance, stage, freelance, independant, seasonal), postedWithin (any, 24h, 3d, 7d, 30d), telework (full, partial, occasional, none; HelloWork only), minSalary (annual euros, HelloWork only), radiusKm, sortBy (relevance or date). Job rows have no _type field and carry source, job_id, job_url, title, company, company_url, company_logo, company_size, company_description, employer_page_url, location, city, postal_code, department, region, country, contract_type, contract_details, contract_duration, employment_type, working_time, working_hours, telework, remote_allowed, salary_text, salary_min, salary_max, salary_currency, salary_period, salary_is_estimate, posted_text, date_posted, date_posted_time, valid_through, updated_at, snippet, description_text, description_html, qualifications, skills, soft_skills, languages, driving_licences, benefits, education, experience, experience_months, experience_required, qualification, industry, occupation_category, rome_code, rome_label, travel, few_applicants, offer_origin, is_partner_offer, direct_apply, tags, is_sponsored, details_scraped, details_error, details_from, search_query, search_location, search_url, page, position, scraped_at. Each run also writes one row with _type "summary", one with _type "info" when jobs were delivered, and a row with _type "error" for each input that could not be read; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~hellowork-jobs-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme.
```

### Key features

- **Keyword and place.** Type keywords the way you would on HelloWork (comptable, développeur, aide soignant). The place can be a city (Lyon), a postal code (33000), a departement number or name (69, Gironde) or a region (Bretagne). For France Travail the place is matched to the official commune, departement or region code for you.
- **Pasted search links.** Copy a HelloWork or France Travail results link with the filters you set on the site and paste it into `startUrls`. Later pages are read for you.
- **Filters.** Contract type (CDI, CDD, interim, alternance, stage, freelance, independant, seasonal), posted within (24 hours to 30 days), telework mode and minimum annual salary on HelloWork, radius around a city, and newest first sorting.
- **Deep searches.** Up to 5,000 jobs per keyword on HelloWork, 30 a page. France Travail serves at most 1,000 offers for one search, 20 a page; split a broad search by place or contract to get more.
- **Details on or off.** On: each job's own page or offer data is read for the full description and the fields listed below. Off: rows come from the search results only, which is about three times faster. Same price either way.
- **Stops cleanly.** A search with no results ends after one request. A refused request is retried; six failed pages in a row end the run; the run stops before its time limit and keeps every row it read. The summary row says why.

### How to use it

#### Basic: the first 100 HelloWork jobs for a keyword in a city

```json
{
  "searchQueries": ["développeur"],
  "location": "Paris",
  "maxItems": 100
}
```

#### Permanent jobs posted this month, both sites

```json
{
  "searchQueries": ["infirmier", "aide soignant"],
  "location": "Gironde",
  "sources": ["hellowork", "francetravail"],
  "contractTypes": ["cdi"],
  "postedWithin": "30d",
  "maxItems": 200
}
```

#### Remote friendly roles above a salary

```json
{
  "searchQueries": ["data engineer"],
  "telework": ["full", "partial"],
  "minSalary": 50000,
  "maxItems": 300
}
```

#### Daily feed of the newest offers

```json
{
  "searchQueries": ["comptable"],
  "location": "Bretagne",
  "sources": ["hellowork", "francetravail"],
  "postedWithin": "24h",
  "sortBy": "date",
  "maxItems": 500
}
```

#### Paste your own search links

```json
{
  "startUrls": [
    "https://www.hellowork.com/fr-fr/emploi/recherche.html?k=comptable&l=Bordeaux&c=CDI",
    "https://candidat.francetravail.fr/offres/recherche?motsCles=boulanger&lieux=75D"
  ],
  "maxItems": 200
}
```

### Input parameters

| Field | Type | Default | What it does |
|---|---|---|---|
| `searchQueries` | list of text | | Keywords, one search each per site. Up to 100 searches per run. |
| `location` | text | | City, postal code, departement or region in France. Empty means all of France. |
| `sources` | list | hellowork | `hellowork`, `francetravail` or both. |
| `maxItems` | number | 50 | Most jobs per keyword per site, or per link, 1 to 5,000 (France Travail: 1,000). |
| `includeDetails` | true/false | true | Reads each job for the description, skills, education and more. |
| `contractTypes` | list | all | cdi, cdd, interim, alternance, stage (HelloWork), freelance, independant, seasonal (France Travail). |
| `postedWithin` | choice | any | any, 24h, 3d, 7d, 30d. |
| `telework` | list | all | full, partial, occasional, none. HelloWork only. |
| `minSalary` | number | | Minimum annual salary in euros. HelloWork only. |
| `radiusKm` | number | site default | Distance around a city, 0 to 100 km. |
| `sortBy` | choice | relevance | relevance or date (newest first). |
| `startUrls` | list of text | | HelloWork or France Travail search links. |

### What data do you get?

| Field | Example | Notes |
|---|---|---|
| `source` | hellowork | or francetravail |
| `job_id` / `job_url` | 85343740 / https://www.hellowork.com/fr-fr/emplois/85343740.html | |
| `title` | Développeur Fullstack .Net H/F | |
| `company` | Capgemini | |
| `city` / `postal_code` / `department` / `region` | Paris / 75000 / 75 / Île-de-France | postal code and region with details |
| `contract_type` | CDI | as shown on the site |
| `working_time` / `working_hours` | Temps plein / 35H/semaine | hours on France Travail |
| `telework` | Télétravail occasionnel | HelloWork |
| `salary_min` / `salary_max` / `salary_period` | 46000 / 53000 / YEAR | EUR |
| `salary_text` | 46 000 - 53 000 € / an | as shown |
| `date_posted` / `valid_through` | 2026-11-09 / 2026-12-09 | |
| `description_text` | Les missions du poste... | with details |
| `skills` | \[".NET", "C#", "React JS"] | with details |
| `education` / `experience` | Bac+2 / 5 An(s) | with details |
| `industry` | \["Secteur informatique", "ESN"] | with details |
| `rome_code` / `rome_label` | M1855 / Développeur / Développeuse front-end | France Travail, with details |
| `offer_origin` / `is_partner_offer` | France Travail / false | France Travail |
| `search_query` / `page` / `position` | comptable / 1 / 3 | where the row came from |

#### Output example

```json
{
  "source": "hellowork",
  "job_id": "85343740",
  "job_url": "https://www.hellowork.com/fr-fr/emplois/85343740.html",
  "title": "Développeur - Développeuse Sénior Fullstack .Net H/F",
  "company": "Capgemini",
  "company_url": "https://www.hellowork.com/fr-fr/entreprises/capgemini-france-6026.html",
  "location": "Paris - 75",
  "city": "Paris",
  "postal_code": "75000",
  "department": "75",
  "region": "Île-de-France",
  "country": "France",
  "contract_type": "CDI",
  "employment_type": "FULL_TIME",
  "working_time": "Temps plein",
  "telework": "Télétravail occasionnel",
  "remote_allowed": true,
  "salary_text": "46 000 - 53 000 € / an",
  "salary_min": 46000,
  "salary_max": 53000,
  "salary_currency": "EUR",
  "salary_period": "YEAR",
  "salary_is_estimate": false,
  "posted_text": "il y a 2 jours",
  "date_posted": "2026-11-09",
  "valid_through": "2026-12-09",
  "description_text": "Les missions du poste\nChoisir Capgemini, c'est choisir une entreprise où vous serez en mesure de façonner votre carrière...",
  "skills": ["Anglais", ".NET", "Veille technologique", "Analyse des besoins client", "C#", "React JS"],
  "education": "bachelor degree",
  "experience_months": 12,
  "industry": ["Secteur informatique", "ESN"],
  "occupation_category": "Informatique",
  "details_scraped": true,
  "search_query": "développeur",
  "search_location": "Paris",
  "page": 1,
  "position": 1,
  "scraped_at": "2026-11-11T20:30:12.000Z"
}
```

### Pricing

Pay per event: you pay for the jobs you receive, plus a flat $0.001 per run, whatever memory you choose. Job details cost nothing extra.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `job` | Once per job row stored in your dataset | $0.90 per 1,000 | $0.84 per 1,000 | $0.78 per 1,000 | $0.72 per 1,000 |
| `run-start` | Once per run, after a search returned jobs | $0.001 | $0.001 | $0.001 | $0.001 |

Never charged:

- links that are not HelloWork or France Travail search links (each gets an error row);
- a job that a second keyword of the same run finds again;
- jobs past your `maxItems`;
- the summary, info and error rows;
- a run with no valid input, or one whose searches return no jobs: the start fee is charged only once jobs came back;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit.

### How it compares

| Actor | Price per 1,000 on the Free plan | Start fee | Sites | Parsed salary min and max | Full description |
|---|---|---|---|---|---|
| **This actor** | $0.90 | $0.001 per run | HelloWork and France Travail | Yes | Yes, both sites |
| [HelloWork Jobs Scraper by shahidirfan](https://apify.com/shahidirfan/HelloWork-Jobs-Scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $1.00 | $0.008 per run | HelloWork | Yes | Yes |
| [HelloWork Jobs Scraper by solidcode](https://apify.com/solidcode/hellowork-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $1.13 | $0.00005 per GB of memory | HelloWork | Yes | Yes |
| [France Travail Scraper by dltik](https://apify.com/dltik/francetravail-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $3.00 | none listed | France Travail | Yes | Yes |

Checked 12 Nov 2026 from the public Store listings.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every day, every Monday at 08:00 and so on).
3. Use `postedWithin: "24h"` and `sortBy: "date"` for a daily feed, and compare runs on `source` plus `job_id` to keep only new offers.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

The public job search pages of hellowork.com and candidat.francetravail.fr, and each job's public page or offer data, as anyone sees them without logging in. It does not log in, apply to jobs or read candidate data.

#### Do I need an account, cookies or an API key?

No account, no cookies and no API key, on either site. You do not need France Travail API credentials.

#### How many jobs can I get?

Up to 5,000 per keyword on HelloWork and up to 1,000 per search on France Travail, with up to 100 searches per run. For more from France Travail, split a broad search by departement or contract type.

#### Why do some rows have no postal code or salary?

Many employers give only a city or a region, and about half of the HelloWork offers show no salary. The actor never invents a value: a field the site does not show is left out of the row.

#### What is salary_is_estimate?

HelloWork shows its own salary estimate on some offers ("Estimation Hellowork"). Those rows carry `salary_is_estimate: true`, so you can keep employer salaries and estimates apart.

#### Are offers from other job sites included on France Travail?

Yes. France Travail lists offers from partner sites next to its own. `offer_origin` names who published the offer (for example APEC, METEOJOB or HELLOWORK) and `is_partner_offer` is true for partner offers. When you search both sites, an offer HelloWork shares with France Travail can come back once from each; drop the France Travail rows with `offer_origin` HELLOWORK if you want one copy.

#### How long does a run take?

In our tests on Apify (12 Nov 2026): 8 seconds for the "Try it" input (40 jobs), 10 seconds for 182 HelloWork jobs with details, 15 seconds for 200 France Travail jobs with details, and 162 seconds for 1,200 jobs (3 keywords on both sites, all of France, with details). The summary row shows pages, requests and time.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. In CSV and Excel, lists such as `skills` are flattened into columns.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/hellowork-jobs-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http hellowork-jobs-scraper "https://mcp.apify.com/?tools=themineworks/hellowork-jobs-scraper"`

#### Is it legal to scrape HelloWork?

The actor reads only public job offers that employers publish to be found, on HelloWork and on France Travail, without logging in. It collects no candidate data. You are responsible for how you use the data, including the sites' terms and laws that apply to you, such as GDPR when a job offer names a contact person. This is general information, not legal advice.

### Integrations

- **Google Sheets**: send each run's jobs to a sheet with Apify's Google Sheets integration; one row per job fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "new CDI offers in Lyon every morning to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

If this actor saved you time, a short rating on the Store helps other buyers find it.

### More from The Mine Works

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Shine.com Jobs Scraper](https://apify.com/themineworks/shine-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Internshala Scraper](https://apify.com/themineworks/internshala-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Indeed Jobs Scraper](https://apify.com/themineworks/indeed-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instahyre Jobs Scraper](https://apify.com/themineworks/instahyre-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Apna Jobs Scraper](https://apify.com/themineworks/apna-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CutShort Jobs Scraper](https://apify.com/themineworks/cutshort-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Jobs Scraper](https://apify.com/themineworks/linkedin-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Recruiting & Jobs MCP](https://apify.com/themineworks/recruiting-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a search that returns fewer jobs than the site, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or another French job site, email dmineworks@gmail.com.

*Search HelloWork and France Travail by keyword and place and get every French job offer back as one row, with company, contract, salary range, telework, description and skills, no login.*

# Actor input Schema

## `searchQueries` (type: `array`):

Job titles or keywords, one per line, as you would type them in the HelloWork search box. Example: comptable, développeur, infirmier, chef de projet. Each keyword is one search on each source you pick. Up to 100 searches per run.

## `location` (type: `string`):

City, postal code, departement or region in France, for example Paris, Lyon, 33000, 69, Gironde or Bretagne. Leave empty for all of France. Used by every keyword search.

## `sources` (type: `array`):

Which sites to search. HelloWork is the default. Add France Travail (formerly Pole emploi, the public employment service, which also lists offers from partner sites) to search it with the same keywords, place and filters. Same price per job on both.

## `maxItems` (type: `integer`):

The most jobs to return for each keyword on each site, or for each search link, 1 to 5,000. HelloWork shows 30 jobs a page; France Travail shows 20 and serves at most 1,000 for one search. Example: 200.

## `includeDetails` (type: `boolean`):

On: each job's own page is read too, for the full description, skills, education, experience, salary range, valid through date, sector, postal code and, on France Travail, the ROME job code, working hours, languages and licences. Off: rows come from the search results only (title, company, place, contract, salary text, telework, posted date), which is faster. Same price either way.

## `contractTypes` (type: `array`):

Only jobs with these contracts. Empty means all. Stage is HelloWork only; seasonal is France Travail only.

## `postedWithin` (type: `string`):

Only jobs published in this window.

## `telework` (type: `array`):

Only HelloWork jobs with this remote work mode. Empty means all.

## `minSalary` (type: `integer`):

HelloWork applies this filter on its side, for example 40000. Leave empty for no minimum.

## `radiusKm` (type: `integer`):

How far around a city to search, 0 to 100 km. Leave empty for the sites' own default (HelloWork 20 km, France Travail 10 km).

## `sortBy` (type: `string`):

Most relevant first, or newest first.

## `startUrls` (type: `array`):

HelloWork or France Travail search result links copied from your browser, with any filters you set there, for example https://www.hellowork.com/fr-fr/emploi/recherche.html?k=comptable\&l=Bordeaux\&c=CDI or https://candidat.francetravail.fr/offres/recherche?motsCles=comptable\&lieux=33D. The pages after the first are read automatically.

## Actor input object example

```json
{
  "searchQueries": [
    "comptable"
  ],
  "location": "Lyon",
  "sources": [
    "hellowork",
    "francetravail"
  ],
  "maxItems": 20,
  "includeDetails": true,
  "postedWithin": "any",
  "sortBy": "relevance"
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "searchQueries": [
        "comptable"
    ],
    "location": "Lyon",
    "sources": [
        "hellowork",
        "francetravail"
    ],
    "maxItems": 20
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/hellowork-jobs-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "searchQueries": ["comptable"],
    "location": "Lyon",
    "sources": [
        "hellowork",
        "francetravail",
    ],
    "maxItems": 20,
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/hellowork-jobs-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "searchQueries": [
    "comptable"
  ],
  "location": "Lyon",
  "sources": [
    "hellowork",
    "francetravail"
  ],
  "maxItems": 20
}' |
apify call themineworks/hellowork-jobs-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/hellowork-jobs-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/IcpHRxkcyNTqSJte8/builds/swUu8FNPwKdHvH71n/openapi.json
