# Le Forem Scraper - Wallonia Job Board Data Extractor (`studio-amba/leforem-scraper`) Actor

Scrape job listings from Le Forem, Wallonia's public employment service. Search by keyword. Extract titles, companies, salaries, contract types, languages, and full descriptions. No login or cookies required.

- **URL**: https://apify.com/studio-amba/leforem-scraper.md
- **Developed by:** [Studio Amba](https://apify.com/studio-amba) (community)
- **Categories:** Jobs
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $1.20 / 1,000 result scrapeds

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?

Actors are web data automations that power AI and operations. They run on the Apify platform to scrape websites, process data, connect APIs, and automate workflows.
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.
Actors are written with capital "A".

## 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.
The best way to integrate Actors is as follows.

- **AI agents and MCP clients** — the [Apify MCP server](https://docs.apify.com/integrations/mcp.md) at `https://mcp.apify.com` (remote, streamable HTTP, OAuth on first use).
- **Agentic workflows and local Actor development** — [Agent Skills](https://apify.com/.well-known/agent-skills/index.json) with the [Apify CLI](https://docs.apify.com/cli/docs.md): `npm install -g apify-cli`, then `apify login`.
- **JavaScript/TypeScript projects** — the official [JS/TS client](https://docs.apify.com/api/client/js/docs.md): `npm install apify-client`.
- **Python projects** — the official [Python client](https://docs.apify.com/api/client/python/docs.md): `pip install apify-client`.
- **Any other language** — the [REST API](https://docs.apify.com/api/v2.md).

For usage examples, see the [API](#api) section below.

For more details, see Apify documentation as [Markdown index](https://docs.apify.com/llms.txt) and [Markdown full-text](https://docs.apify.com/llms-full.txt).

# README

### What does Le Forem Scraper do?

**Le Forem Scraper** extracts job listings from [Le Forem](https://www.leforem.be), the public employment service for Wallonia, French-speaking Belgium. It collects job titles, companies, locations, contract types, work regimes, salary indications, language requirements, and full job descriptions directly from Le Forem's job search API. No login or cookies required.

Use it on the Apify platform to get structured job data via API, schedule recurring scrapes, and integrate with tools like Zapier, Make, Google Sheets, and Slack.

### How to scrape Le Forem data

1. Go to the Le Forem Scraper on the Apify Store.
2. Click **Try for free** to open the actor in the Apify Console.
3. Enter a French-language search query (e.g. "comptable", "infirmier", "informaticien") or leave it empty to browse all current openings.
4. Set the maximum number of results you want.
5. Optionally toggle off "Fetch Full Description" if you only need the search-result summary (faster, fewer requests).
6. Click **Start** and wait for the run to finish.
7. Download your data as JSON, CSV, Excel, or HTML from the Output tab.

### Why use Le Forem Scraper?

- **Recruitment and hiring** — Monitor job postings across Wallonia to understand hiring trends by sector and region.
- **Salary research** — Collect the salary indications employers do disclose, benchmarked by contract type and sector.
- **Labor market analysis** — Track which sectors are growing, which companies are hiring most, and where demand concentrates across Wallonia's arrondissements.
- **Lead generation** — Identify companies actively hiring to target with B2B recruitment or HR services.
- **Academic and public-policy research** — Gather structured Walloon labor market data, since Le Forem is the official regional employment service.

### Input

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `searchQuery` | String | No | French-language search keyword (e.g. "comptable", "infirmier", "informaticien"). Leave empty to browse all current openings. |
| `maxResults` | Integer | No | Maximum number of job listings to scrape (default: 100, max: 10000). |
| `fetchFullDescription` | Boolean | No | Fetch the full description, salary, and contact details per listing (default: `true`). Disable for faster, lighter runs. |
| `proxyConfiguration` | Object | No | Proxy settings. Le Forem has no anti-bot protection, so this is optional — Belgian residential proxies are used by default for politeness on larger runs. |

### Output

Each result contains structured data about a single job listing. You can download the dataset in various formats such as JSON, HTML, CSV, or Excel.

#### Example output

```json
{
    "title": "Comptable Senior (H/F/X)",
    "company": "L.I.P. Belgique - L.I.P. Belgique",
    "location": "Arrondissement de Tournai-Mouscron",
    "locations": ["Arrondissement de Tournai-Mouscron"],
    "contractType": "Durée indéterminée",
    "workRegime": "Temps plein",
    "sector": "Activités des agences de placement de main-d'oeuvre",
    "languages": [],
    "salary": "",
    "description": "En tant que Comptable Senior, vos tâches principales seront les suivantes : Vous intégrerez l'équipe comptable de 3 personnes (2 collaborateurs + vous). Vous encoderez les transactions, achats, opérations financières et diverses opérations comptables...",
    "numberOfPositions": 1,
    "postedDate": "Publié hier",
    "startDate": "2026-08-01T00:00:00+02:00",
    "endDate": "2026-08-08T00:00:00+02:00",
    "email": "tournai@groupelip.com",
    "phone": "",
    "reference": "2001700",
    "url": "https://www.leforem.be/recherche-offres/offre-detail/2001700",
    "scrapedAt": "2026-08-02T14:13:49.149Z"
}
```

### Data fields

| Field | Type | Description |
|-------|------|-------------|
| `title` | String | Job position title |
| `company` | String | Hiring company name |
| `location` | String | Job location(s), comma-separated |
| `locations` | Array | Job location(s) as an array of city or arrondissement names |
| `contractType` | String | Type of contract (e.g. Durée indéterminée, Durée déterminée, Intérimaire) |
| `workRegime` | String | Working time regime (e.g. Temps plein, Temps partiel) |
| `sector` | String | Industry sector of the employer |
| `languages` | Array | Language requirements, when disclosed |
| `salary` | String | Salary indication, when disclosed (e.g. "Salaire selon barème CP329.02") |
| `description` | String | Full job description text (HTML stripped) |
| `numberOfPositions` | Integer | Number of open positions for this listing |
| `postedDate` | String | When the job was posted (e.g. "Publié aujourd'hui") |
| `startDate` | String | ISO 8601 date the listing became active |
| `endDate` | String | ISO 8601 date the listing closes |
| `email` | String | Employer contact email, when disclosed |
| `phone` | String | Employer contact phone, when disclosed |
| `reference` | String | Le Forem job reference number |
| `url` | String | Direct URL to the job listing on Le Forem |
| `scrapedAt` | String | ISO 8601 timestamp of when the data was collected |

### Cost estimate

This actor calls Le Forem's own JSON search API directly rather than rendering pages in a browser, so it runs fast and cheap — roughly **0.2–0.4 compute units per 1,000 results**. With the Apify free tier you can run smaller scrapes at no cost. For larger runs, expect well under $0.20 per 1,000 job listings at standard Apify pricing.

### Tips

- Use specific search queries to get more relevant results and reduce run time.
- Leave `searchQuery` empty to pull the newest listings across all of Wallonia.
- Turn off `fetchFullDescription` if you only need title/company/location/contract type — it roughly halves the number of requests.
- Schedule recurring runs to track new job postings daily or weekly.
- Combine with other Belgian job board scrapers (Jobat, VDAB-adjacent boards, StepStone) for full national coverage.

### Limitations

- Salary data is not available for all listings — many Walloon employers do not publish a salary indication, only a collective-bargaining reference.
- Some job detail fields (email, phone, languages) may be empty depending on how the employer filled in the listing.
- Data is scraped from the public Le Forem website and may change without notice.

### Integrations

Connect Le Forem Scraper with your existing tools and workflows:

- **Google Sheets** — Export job listings directly to a spreadsheet for easy filtering and sharing.
- **Slack** — Get notified when new jobs matching your criteria appear.
- **Zapier / Make** — Build workflows that react to new job postings in real time.
- **Custom API** — Access all results programmatically via the Apify API in JSON format.

### FAQ and support

**Is it legal to scrape Le Forem?** Scraping publicly available data is generally permitted under EU law. This actor only accesses public job listings that require no login, via the same API the public search page uses.

**How often is the data updated?** The actor scrapes live data from Le Forem each time it runs. Schedule it daily or weekly to track changes.

**I found a bug or have a feature request.** Open an issue in the Issues tab on the actor page. You can also request a custom scraping solution.

# Actor input Schema

## `searchQuery` (type: `string`):

Job search keyword in French (e.g. 'comptable', 'infirmier', 'informaticien'). Leave empty to browse all current openings.

## `maxResults` (type: `integer`):

Maximum number of job listings to scrape.

## `fetchFullDescription` (type: `boolean`):

Fetch the full job description, salary, and contact details for each listing (1 extra request per job). Disable for faster runs when you only need the search-result summary fields.

## `proxyConfiguration` (type: `object`):

Proxy settings. Le Forem has no anti-bot protection, so proxies are optional — Belgian residential proxies are used by default for politeness and IP diversity on larger runs.

## Actor input object example

```json
{
  "searchQuery": "comptable",
  "maxResults": 20,
  "fetchFullDescription": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "BE"
  }
}
```

# 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 = {
    "searchQuery": "comptable",
    "maxResults": 20,
    "fetchFullDescription": true,
    "proxyConfiguration": {
        "useApifyProxy": true,
        "apifyProxyGroups": [
            "RESIDENTIAL"
        ],
        "apifyProxyCountry": "BE"
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("studio-amba/leforem-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 = {
    "searchQuery": "comptable",
    "maxResults": 20,
    "fetchFullDescription": True,
    "proxyConfiguration": {
        "useApifyProxy": True,
        "apifyProxyGroups": ["RESIDENTIAL"],
        "apifyProxyCountry": "BE",
    },
}

# Run the Actor and wait for it to finish
run = client.actor("studio-amba/leforem-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 '{
  "searchQuery": "comptable",
  "maxResults": 20,
  "fetchFullDescription": true,
  "proxyConfiguration": {
    "useApifyProxy": true,
    "apifyProxyGroups": [
      "RESIDENTIAL"
    ],
    "apifyProxyCountry": "BE"
  }
}' |
apify call studio-amba/leforem-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,studio-amba/leforem-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/4xOwc1GDI6h5rvAi9/builds/GL9qsJ47auQp6l54b/openapi.json