# Actiris Brussels Job Scraper (`blackfalcondata/actiris-scraper`) Actor Scrape all active job listings from actiris.brussels — official Brussels public employment service. Returns 33,000+ structured offers with KBO company numbers, CEFR language requirements, and bilingual FR/NL fields. - **URL**: https://apify.com/blackfalcondata/actiris-scraper.md - **Developed by:** [Black Falcon Data](https://apify.com/blackfalcondata) (community) - **Categories:** Jobs, Lead generation, Automation - **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, NaN 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/platform/actors/running/actors-in-store#pay-per-event ## What's an Apify Actor? Actors are a software tools running on the Apify platform, for all kinds of web data extraction and automation use cases. 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. In JavaScript/TypeScript projects, use official [JavaScript/TypeScript client](https://docs.apify.com/api/client/js.md): ```bash npm install apify-client ``` In Python projects, use official [Python client library](https://docs.apify.com/api/client/python.md): ```bash pip install apify-client ``` In shell scripts, use [Apify CLI](https://docs.apify.com/cli/docs.md): ````bash # MacOS / Linux curl -fsSL https://apify.com/install-cli.sh | bash # Windows irm https://apify.com/install-cli.ps1 | iex ```bash In AI frameworks, you might use the [Apify MCP server](https://docs.apify.com/platform/integrations/mcp.md). If your project is in a different language, use 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 Brussels Job Scraper 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. ### Key features - **Incremental mode** — recurring runs emit and charge only for listings that are new or whose tracked content changed. First run builds the baseline state; subsequent runs emit only new or changed records. - **Detail enrichment** — full descriptions, company metadata, and contact information where the source provides them. - **Compact mode** — AI-agent and MCP-friendly payloads with core fields only. ### What data can you extract from actiris.brussels? Each result includes Core listing 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 (`applyInstructions`, `applyContactPerson`, `email`, and `phone`), 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 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 6 more parameters ### Input examples **Basic search** — Keyword-driven search with a result cap. → Full payload per result — all standard fields populated where the source provides them. ```json { "texte": "software engineer", "maxResults": 50 } ```` **Incremental tracking** — Only emit jobs that changed since the previous run with this `stateKey`. → First run builds the baseline state. Subsequent runs emit only records that are new or whose tracked content changed. Set `emitUnchanged: true` to include unchanged records as well. ```json { "texte": "software engineer", "maxResults": 200, "incrementalMode": true, "stateKey": "software-engineer-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": "software engineer", "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": "b1f9d1ae6e6fe80ff478767473b6fd81c615b0e31a45edb4d0f99e2faecb64d9", "reference": "5813876", "title": "SUPPLY CHAIN & OFFICE MANAGER FR/ANG/NL H/F/X", "titleNl": "SUPPLY CHAIN & OFFICE MANAGER NL/FR/ENG M/V/X", "company": null, "companyNl": null, "kboNumber": "0239843188", "kboRegistryUrl": "https://kbopub.economie.fgov.be/kbopub/toonondernemingps.html?ondernemingsnummer=0239843188", "companyLogo": "https://my.actiris.brussels/Repository/Tiers/0239843188/fr.png", "location": "1070", "locationNl": "1070", "postalCode": "1070", "municipality": null, "municipalityNl": null, "country": "BE", "description": "Description de la fonction: En tant que SUPPLY CHAIN and OFFICE Manager, vous êtes responsable d'un large éventail de tâches administratives, financières et opérationnelles au sein de l'entreprise. Vo...", "descriptionHtml": "

Description de la fonction:

En tant que SUPPLY CHAIN and OFFICE Manager, vous êtes responsable d'un large éventail de tâches administratives, financières et opérationnelles a...", "descriptionMarkdown": "**Description de la fonction:**\n\nEn tant que SUPPLY CHAIN and OFFICE Manager, vous êtes responsable d'un large éventail de tâches administratives, financières et opérationnelles au sein de l'entrepris...", "companyDescription": "Les barrières Pitagone contribuent à protéger les citoyens contre les attaques de véhicules-béliers. PITAGONE est le leader mondial des solutions mobiles antiterrorisme. Nos principaux clients sont la...", "profile": "Profil: Bachelier ou expérience équivalente Expérience avec ERP requise (EXACT, etc.) Excellentes compétences organisationnelles Mentalité proactive et orientée solutions Très bonne maîtrise du néerla...", "profileHtml": "

Profil: