# Actiris Job Scraper \[Just 💰$1.5] — Brussels Public Jobs (`blackfalcondata/actiris-scraper`) Actor 💰 $1.5 per 1,000 jobs. Scrape actiris.brussels — the official Brussels public employment service with 33,000+ structured offers · KBO company numbers · CEFR language requirements. Incremental mode tracks new and changed jobs across scheduled runs. - **URL**: https://apify.com/blackfalcondata/actiris-scraper.md - **Developed by:** [Black Falcon Data](https://apify.com/blackfalcondata) (community) - **Categories:** Jobs, Lead generation, Automation - **Stats:** 5 total users, 2 monthly users, 98.7% runs succeeded, 3 bookmarks - **User rating**: No ratings yet ## Pricing from $1.50 / 1,000 results This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage. 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 Actiris do? Actiris Brussels Job Scraper fetches all 33,000+ active job listings from [actiris.brussels](https://actiris.brussels) — the official Brussels Capital Region employment service — in a single run. Every record includes the employer's Belgian KBO company number, bilingual French and Dutch titles and municipality names, CEFR-graded language requirements, and direct apply links. Detail enrichment adds full job descriptions, candidate profiles, contact person, recruiter email, company description, and Markdown-formatted text from each listing's HTML page. **New to Apify?** [Sign up free](https://console.apify.com/sign-up?fpr=1h3gvi) and use the included $5 monthly platform credit to test this actor. ### Key features - **🔔 Notifications** — Telegram, Slack, Discord, WhatsApp Cloud API, generic webhook — out of the box. Pair with incremental + `notifyOnlyChanges` for daily "new Actiris jobs" pings to your hiring channel. - **📋 Detail enrichment** — two-stage mode: list, then enrich each job with the full description + detail-page fields (apply counts, education, etc.). One toggle, no extra orchestration. - **📧 Email + phone extraction** — every record carries `extractedEmails[]` and `extractedPhones[]` regex-pulled from the description — direct-outreach lists with no extra processing step. - **🔗 URL + social-profile extraction** — every record carries `extractedUrls[]` and structured `socialProfiles { linkedin, twitter, github, … }` parsed from the description — useful when employers drop their careers page or recruiter LinkedIn in-line. - **📦 Compact mode** — AI-agent and MCP-friendly compact payloads with core fields only — pipe straight into your ATS, salary-benchmarking tool, or LLM context without parsing extras. - **📌 Change classification** — each record carries a `changeType` of NEW / UPDATED / UNCHANGED / REAPPEARED / EXPIRED. Default emits NEW + UPDATED + REAPPEARED; opt into the others with `emitUnchanged` / `emitExpired`. - **♻️ Incremental mode** — recurring runs emit only NEW / UPDATED / REAPPEARED records — UNCHANGED and EXPIRED are opt-in. First run builds the baseline; subsequent runs emit and charge only for the diff. Pair with notifications for daily "new jobs" alerts to your hiring team. Saves 80–95% on daily monitoring. - **📤 Export anywhere** — Download the dataset as JSON, CSV, or Excel from the Apify Console, or stream live via the Apify API and integrations (Make, Zapier, Google Sheets, n8n, …). - **🏢 KBO company registry** — captures Belgian KBO company numbers, direct KBO registry URLs, and KBO-keyed company logo URLs for employer matching and enrichment. - **🌐 CEFR language requirements + bilingual FR/NL output** — returns structured CEFR language requirements with comprehension, writing, reading, and speaking levels plus required-vs-atout status, alongside French and Dutch title, company, location, municipality, and URL pairs. - **🔌 MCP connectors** — export your results into Notion via Apify's MCP connectors — a clean run-summary page, no glue code. Opt-in via the App connector field; deterministic field-mapping, no AI. Built on Apify's connector framework, so more destinations open up as their catalog grows. ### What data can you extract from actiris.brussels? Each result includes Core job fields (`jobId`, `reference`, `title`, `titleNl`, `kboNumber`, `kboRegistryUrl`, `location`, and `locationNl`, and more), detail fields when enrichment is enabled (`description`, `descriptionHtml`, `descriptionMarkdown`, `benefits`, and `detailFetched`), contact and apply information (`applyContactPerson`, `email`, `phone`, and `applyInstructions`), and company metadata (`company`, `companyNl`, `companyLogo`, and `companyDescription`). In standard mode, all fields are always present — unavailable data points are returned as `null`, never omitted. In compact mode, only core fields are returned. Enable detail enrichment in the input to get richer fields such as full descriptions, company metadata, and contact information where the source provides them. ### Input The main inputs are a search keyword and a result limit. Additional filters and options are available in the input schema. Key parameters: - **`texte`** — Filter by keyword (searched across title and description). - **`keywordSearchType`** — Where to apply the keyword filter: Partout (everywhere), Titre (title only), or Titre-résumé (title and summary). (default: `"Partout"`) - **`isOffreActiris`** — When true, return only offers managed directly by Actiris (excludes VDAB/Forem/partner listings). (default: `false`) - **`isOffreVdabForem`** — When true, return only offers from VDAB (Flemish) or Le Forem (Walloon) partner agencies. (default: `false`) - **`codesPostal`** — Filter by Belgian postal codes (e.g. \["1000", "1200"]). - **`codesContrat`** — Filter by contract type codes (e.g. \["CDI", "CDD"]). - **`secteursPanorama`** — Filter by Panorama sector codes. - **`domainesImt`** — Filter by IMT job-family codes (e.g. \["E'2"]). - **`dateDerniereModification`** — Only return offers modified on or after this date (ISO 8601, e.g. "2026-04-01"). - **`maxResults`** — Maximum number of offers to return. 0 = all (~33 000+). Memory tiers: ≤100→256 MB, ≤2000→512 MB, 2001+→1024 MB. (default: `0`) - **`includeDetails`** — Fetch each job's HTML detail page to extract description, profile, language requirements, apply email, etc. (default: `true`) - **`descriptionMaxLength`** — Truncate description text to N characters. 0 = no truncation. (default: `0`) - ...and 24 more parameters ### Input examples **Keyword search** — Search job listings by keyword. Leave `texte` empty to browse all active listings. → Job records matching the keyword, with KBO number, bilingual titles and apply links. ```json { "texte": "développeur", "keywordSearchType": "Partout", "maxResults": 50 } ``` **Incremental tracking** — Only emit listings that changed since the previous run with this `stateKey`. → First run builds the baseline; later runs emit only new or changed listings. ```json { "texte": "développeur", "maxResults": 200, "incrementalMode": true, "stateKey": "actiris-tracker" } ``` **Compact output for AI agents** — Return only core fields for AI-agent and MCP workflows. → Small payload with the most important fields — ideal for piping into LLMs without token overhead. ```json { "texte": "développeur", "maxResults": 50, "compact": true } ``` ### Output Each run produces a dataset of structured job records. Results can be downloaded as JSON, CSV, or Excel from the Dataset tab in Apify Console. ### Example job record ```json { "jobId": "06ca39341ffef949cebf988288a36e52df994ae2e7635d706be92f186fb54c28", "reference": "5841400", "title": "PUERICULTEUR/PUERICULTRICE H/F/X", "titleNl": "PUERICULTEUR/PUERICULTRICE H/F/X", "company": "COOKIES & FRIENDS", "companyNl": "COOKIES & FRIENDS", "kboNumber": "0682499225", "kboRegistryUrl": "https://kbopub.economie.fgov.be/kbopub/toonondernemingps.html?ondernemingsnummer=0682499225", "companyLogo": "https://my.actiris.brussels/Repository/Tiers/0682499225/fr.png", "location": "1030 - Schaerbeek", "locationNl": "1030 - Schaarbeek", "postalCode": "1030", "municipality": "Schaerbeek", "municipalityNl": "Schaarbeek", "country": "BE", "description": "Nous cherchons une personne pour un poste à temps plein. Motivée, flexible et dynamique, vous jouerez un rôle de référent pour les enfants. Dans ce rôle il vous sera demandé d'assurer l'accueil et l'e...", "descriptionHtml": "

Nous cherchons une personne pour un poste à temps plein. Motivée, flexible et dynamique, vous jouerez un rôle de référent pour les enfants.

\n\n

Dans ce rôle il vous sera demandé d'assurer l'acc...", "descriptionMarkdown": "Nous cherchons une personne pour un poste à temps plein. Motivée, flexible et dynamique, vous jouerez un rôle de référent pour les enfants.\n\nDans ce rôle il vous sera demandé d'assurer l'accueil et l'...", "companyDescription": "« Cookies And Friends » est à la recherche de puéricultrices/puériculteurs- diplôme en puériculture ou un équivalent pour pouvoir exercer dans une maison d'enfants autorisée par l'ONE. http://cookiesa...", "profile": "Assurer l'accueil l'encadrement quotidien (soins, activités, repas') de l'enfant tout en appliquant le projet pédagogique du milieu. Avoir l'esprit créatif, un esprit d'initiative, un sens des respons...", "profileHtml": "