# English Jobs Finland

> English Jobs Finland is a job search platform for English-speaking roles in Finland. 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.fi`.

### 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.fi/jobs/software%20developer`
- **Location-only:** `GET https://englishjobs.fi/in/helsinki`
- **Query and location:** `GET https://englishjobs.fi/in/helsinki/software%20developer`
- **With additional languages:**
  - `GET https://englishjobs.fi/jobs/software%20developer?include=french.german.spanish`
  - `GET https://englishjobs.fi/in/helsinki?include=french`
  - `GET https://englishjobs.fi/in/helsinki/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.fi/jobs/software%20developer?format=markdown`
- `GET https://englishjobs.fi/in/helsinki?format=md`
- `GET https://englishjobs.fi/in/helsinki/software%20developer?format=markdown&include=french.german`

## Allowed Locations

Below is the list of supported location IDs:

Cities:
- `mantsala` # Mäntsälä
- `aanekoski` # Äänekoski
- `lieksa` # Lieksa
- `vihti` # Vihti
- `imatra` # Imatra
- `haukipudas` # Haukipudas
- `riihimaki` # Riihimäki
- `hamina` # Hamina
- `forssa` # Forssa
- `keuruu` # Keuruu
- `alajarvi` # Alajärvi
- `leppavirta` # Leppävirta
- `seinajoki` # Seinäjoki
- `hyvinkaa` # Hyvinkää
- `kontiolahti` # Kontiolahti
- `kurikka` # Kurikka
- `nurmo` # Nurmo
- `nurmijarvi` # Nurmijärvi
- `jyvaskylan-mlk` # Jyväskylän maalaiskunta
- `hollola` # Hollola
- `eura` # Eura
- `orivesi` # Orivesi
- `helsinki` # Helsinki
- `lappeenranta` # Lappeenranta
- `valkeakoski` # Valkeakoski
- `vammala` # Vammala
- `kalajoki` # Kalajoki
- `muurame` # Muurame
- `pirkkala` # Pirkkala
- `pieksamaki` # Pieksämäki
- `pedersore` # Pedersöre
- `liminka` # Liminka
- `kouvola` # Kouvola
- `joensuu` # Joensuu
- `siilinjarvi` # Siilinjärvi
- `oulunsalo` # Oulunsalo
- `kangasala` # Kangasala
- `ylivieska` # Ylivieska
- `hameenkyro` # Hämeenkyrö
- `rovaniemi` # Rovaniemi
- `salo` # Salo
- `vantaa` # Vantaa
- `pietarsaari` # Jakobstad
- `kauniainen` # Kauniainen
- `kaarina` # Kaarina
- `keminmaa` # Kemi
- `varkaus` # Varkaus
- `huittinen` # Huittinen
- `turku` # Turku
- `jarvenpaa` # Järvenpää
- `kerava` # Kerava
- `rovaniemen-mlk` # Rovaniemen maalaiskunta
- `kauhajoki` # Kauhajoki
- `ilmajoki` # Ilmajoki
- `liperi` # Liperi
- `paimio` # Paimio
- `kotka` # Kotka
- `anjalankoski` # Anjalankoski
- `kuusamo` # Kuusamo
- `lapua` # Lapua
- `tampere` # Tampere
- `jamsa` # Jämsä
- `sipoo` # Sipoo
- `hanko` # Hanko
- `saarijarvi` # Saarijärvi
- `lohja` # Lohja
- `kempele` # Kempele
- `toijala` # Akaa
- `tuusula` # Tuusula
- `nokia` # Nokia
- `kuusankoski` # Kuusankoski
- `veckelaaa` # Vehkalahti
- `joutseno` # Joutseno
- `sotkamo` # Sotkamo
- `ii` # Ii
- `kuopio` # Kuopio
- `savonlinna` # Savonlinna
- `raahe` # Raahe
- `tornio` # Tornio
- `rauma` # Rauma
- `iisalmi` # Iisalmi
- `lieto` # Lieto
- `janakkala` # Janakkala
- `ulvila` # Ulvila
- `kitee` # Kitee
- `espoo` # Espoo
- `heinola` # Heinola
- `uusikaupunki` # Uusikaupunki
- `hattula` # Hattula
- `hameenlinna` # Hämeenlinna
- `valkeala` # Valkeala
- `narpio` # Närpes
- `raisio` # Raisio
- `laukaa` # Laukaa
- `nastola` # Nastola
- `lapinlahti` # Lapinlahti
- `masku` # Masku
- `kirkkonummi` # Kirkkonummi
- `kauhava` # Kauhava
- `orimattila` # Orimattila
- `alavus` # Alavus
- `kankaanpaa` # Kankaanpää
- `halikko` # Halikko
- `oulu` # Oulu
- `jyvaskyla` # Jyväskylä
- `vaasa` # Vaasa
- `ylojarvi` # Ylöjärvi
- `mustasaari` # Korsholm
- `nivala` # Nivala
- `lahti` # Lahti
- `mikkeli` # Mikkeli
- `porvoo` # Porvoo
- `lempaala` # Lempäälä
- `parainen` # Pargas
- `mantta` # Mänttä-Vilppula
- `pori` # Pori
- `loviisa` # Loviisa
- `naantali` # Naantali
- `loimaa` # Loimaa
- `kiiminki` # Kiiminki
- `kokkola` # Kokkola
- `kajaani` # Kajaani

Regions:
- `northern-ostrobothnia` # Northern Ostrobothnia
- `central-finland` # Central Finland
- `southern-ostrobothnia` # Southern Ostrobothnia
- `kymenlaakso` # Kymenlaakso
- `south-karelia` # South Karelia
- `finland-proper` # Southwest Finland
- `lapland` # Lapland
- `ostrobothnia` # Ostrobothnia
- `aland` # Åland
- `uusimaa` # Uusimaa
- `satakunta` # Satakunta
- `kainuu` # Kainuu
- `central-ostrobothnia` # Central Ostrobothnia
- `pirkanmaa` # Pirkanmaa
- `north-savonia` # North Savo
- `paijanne-tavastia` # Päijänne Tavastia
- `tavastia-proper` # Tavastia Proper
- `north-karelia` # North Karelia
- `southern-savonia` # South Savo


## 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`