# English Jobs Belgium

> English Jobs Belgium is a job search platform for English-speaking roles in Belgium. It helps non-local speakers find work. By default, it searches for jobs requiring only English. Users can specify additional languages they speak to broaden the search. You can search for these English-speaking jobs by crafting URLs as explained below.

## How to generate search engine results pages

To generate a search URL, follow these patterns. The base URL is `https://englishjobs.be`.

### URL Structure

1. `/jobs/{query}`: For searching by job title or keyword.
2. `/in/{location}`: For searching by location.
3. `/in/{location}/{query}`: For searching by both location and query.

### Path Parameters

- `{query}`: The job title, keyword, or skill to search for. If it contains spaces, URL-encode them (e.g., `software developer` becomes `software%20developer`).
- `{location}`: The ID of the city or region. Must be one of the values from the "Allowed Locations" list below.

### Query Parameters

- `include`: (Optional) A dot-separated list of additional languages the user speaks. This will include jobs that require English *plus* any of the specified languages.
  - You can include up to 4 languages.
  - The language values must come from the "Allowed Languages for `include`" list below.

### Examples

- **Query-only:** `GET https://englishjobs.be/jobs/software%20developer`
- **Location-only:** `GET https://englishjobs.be/in/brussels`
- **Query and location:** `GET https://englishjobs.be/in/brussels/software%20developer`
- **With additional languages:**
  - `GET https://englishjobs.be/jobs/software%20developer?include=french.german.spanish`
  - `GET https://englishjobs.be/in/brussels?include=french`
  - `GET https://englishjobs.be/in/brussels/software%20developer?include=french.german`

## Fetching pages as Markdown

Any page on this site can be fetched as Markdown instead of HTML by adding the `format=markdown` query parameter (or the shorter alias `format=md`) to the URL. The response is served as `text/markdown; charset=utf-8` and includes a `Link: <html-url>; rel="canonical"` header pointing to the HTML version.

This works on any GET request, including search result pages and individual job listings. Static assets and machine-readable feeds (`.xml`, `.json`, `.txt`) are served unchanged.

**The `format` parameter must be appended to every request.** Links inside a Markdown response point at the canonical HTML URLs (without `?format=markdown`), so when following a link you must re-append the parameter yourself to keep receiving Markdown.

### Examples

- `GET https://englishjobs.be/jobs/software%20developer?format=markdown`
- `GET https://englishjobs.be/in/brussels?format=md`
- `GET https://englishjobs.be/in/brussels/software%20developer?format=markdown&include=french.german`

## Allowed Locations

Below is the list of supported location IDs:

Cities:
- `ninove` # Ninove
- `brussels` # Brussels
- `aalst` # Aalst
- `wavre` # Wavre
- `huy` # Huy
- `bilzen` # Bilzen
- `rochefort` # Rochefort
- `malmedy` # Malmedy
- `verviers` # Verviers
- `ath` # Ath
- `gistel` # Gistel
- `comines-warneton` # Comines-Warneton
- `tournai` # Tournai
- `harelbeke` # Harelbeke
- `peruwelz` # Péruwelz
- `leuven` # Leuven
- `roeselare` # Roeselare
- `fleurus` # Fleurus
- `bree` # Bree
- `leuze-en-hainaut` # Leuze-en-Hainaut
- `veurne` # Veurne
- `ieper` # Ypres
- `hannuit` # Hannut
- `damme` # Damme
- `seraing` # Seraing
- `tongeren` # Tongeren
- `nivelles` # Nivelles
- `diest` # Diest
- `saint-ghislain` # Saint-Ghislain
- `dilsen-stokkem` # Dilsen-Stokkem
- `couvin` # Couvin
- `herk-de-stad` # Herk-de-Stad
- `charleroi` # Charleroi
- `turnhout` # Turnhout
- `heusden-zolder` # Heusden-Zolder
- `hoogstraten` # Hoogstraten
- `peer` # Peer
- `mechelen` # Mechelen
- `lokeren` # Lokeren
- `oudenaarde` # Oudenaarde
- `diksmuide` # Diksmuide
- `sankt-vith` # Sankt Vith
- `namur` # Namur
- `sint-niklaas` # Sint-Niklaas
- `ottignies-louvain-la-neuve` # Ottignies-Louvain-la-Neuve
- `marche-en-famenne` # Marche-en-Famenne
- `borgloon` # Borgloon
- `soignies` # Soignies
- `eeklo` # Eeklo
- `torhout` # Torhout
- `poperinge` # Poperinge
- `aubange` # Aubange
- `genappe` # Genappe
- `hamont-achel` # Hamont-Achel
- `dendermonde` # Dendermonde
- `tienen` # Tienen
- `waremme` # Waremme
- `ronse` # Ronse
- `walcourt` # Walcourt
- `landen` # Landen
- `vilvoorde` # Vilvoorde
- `wervik` # Wervik
- `sint-truiden` # Sint-Truiden
- `rixensart` # Rixensart
- `eupen` # Eupen
- `andenne` # Andenne
- `dinant` # Dinant
- `le-roeulx` # Le Rœulx
- `binche` # Binche
- `tielt` # Tielt
- `bastogne` # Bastogne
- `chimay` # Chimay
- `gent` # Ghent
- `lummen` # Lummen
- `ciney` # Ciney
- `virton` # Virton
- `geraardsbergen` # Geraardsbergen
- `tubize` # Tubize
- `durbuy` # Durbuy
- `antwerpen` # Antwerp
- `thuin` # Thuin
- `beauraing` # Beauraing
- `beringen` # Beringen
- `herne` # Enghien
- `philippeville` # Philippeville
- `zoutleeuw` # Zoutleeuw
- `mouscron` # Mouscron
- `chatelet` # Châtelet
- `herentals` # Herentals
- `halen` # Halen
- `oostende` # Ostend
- `izegem` # Izegem
- `maaseik` # Maaseik
- `braine-le-comte` # Braine-le-Comte
- `vise` # Visé
- `geel` # Geel
- `menen` # Menen
- `zottegem` # Zottegem
- `lessines` # Lessines
- `genk` # Genk
- `deinze` # Deinze
- `arlon` # Arlon
- `mortsel` # Mortsel
- `brugge` # Bruges
- `mons` # Mons
- `la-louviere` # La Louvière
- `hasselt` # Hasselt
- `jodoigne` # Jodoigne
- `spa` # Spa
- `oudenburg` # Oudenburg
- `liege` # Liège
- `kortrijk` # Kortrijk
- `lommel` # Lommel
- `gembloux` # Gembloux
- `lier` # Lier
- `scherpenheuvel-zichem` # Scherpenheuvel-Zichem
- `tessenderlo` # Tessenderlo
- `halle` # Halle
- `waregem` # Waregem
- `aarschot` # Aarschot

Provinces:
- `antwerpen-province` # Antwerp Province
- `hainaut` # Hainaut
- `vlaams-brabant` # Flemish Brabant
- `liege-province` # Liège Province
- `limburg` # Limburg
- `namur-province` # Namur Province
- `luxembourg` # Belgian Luxembourg
- `brussels` # Brussels
- `oost-vlaanderen` # East Flanders
- `west-vlaanderen` # West Flanders
- `brabant-wallon` # Walloon Brabant


## Allowed Languages for `include`

Below is the list of supported languages for the `include` parameter:

- `arabic`
- `bulgarian`
- `catalan`
- `chinese`
- `croatian`
- `czech`
- `danish`
- `dutch`
- `estonian`
- `finnish`
- `french`
- `german`
- `greek`
- `hindi`
- `hungarian`
- `irish`
- `italian`
- `japanese`
- `korean`
- `latvian`
- `lithuanian`
- `luxembourgish`
- `maltese`
- `norwegian`
- `polish`
- `portuguese`
- `romanian`
- `russian`
- `slovenian`
- `spanish`
- `swedish`
- `turkish`
- `ukrainian`