# English Jobs Germany

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

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

## Allowed Locations

Below is the list of supported location IDs:

Cities:
- `heilbronn` # Heilbronn
- `koblenz` # Koblenz
- `ingolstadt` # Ingolstadt
- `braunschweig` # Braunschweig
- `kiel` # Kiel
- `hannover` # Hanover
- `muelheim-an-der-ruhr` # Mülheim
- `jena` # Jena
- `cottbus` # Cottbus
- `ansbach` # Ansbach
- `moers` # Moers
- `chemnitz` # Chemnitz
- `aachen` # Aachen
- `darmstadt` # Darmstadt
- `luebeck` # Lübeck
- `offenbach-am-main` # Offenbach am Main
- `trier` # Trier
- `potsdam` # Potsdam
- `duisburg` # Duisburg
- `mannheim` # Mannheim
- `regensburg` # Regensburg
- `koeln` # Cologne
- `bonn` # Bonn
- `nuernberg` # Nuremberg
- `hamm` # Hamm
- `neuss` # Neuss
- `solingen` # Solingen
- `pforzheim` # Pforzheim
- `essen` # Essen
- `recklinghausen` # Recklinghausen
- `wiesbaden` # Wiesbaden
- `bergisch-gladbach` # Bergisch Gladbach
- `bochum` # Bochum
- `halle-(saale)` # Halle
- `mainz` # Mainz
- `goettingen` # Göttingen
- `duesseldorf` # Düsseldorf
- `remscheid` # Remscheid
- `wuerzburg` # Würzburg
- `freiburg-im-breisgau` # Freiburg
- `hamburg` # Hamburg
- `salzgitter` # Salzgitter
- `berlin` # Berlin
- `dresden` # Dresden
- `hildesheim` # Hildesheim
- `bremen-kreisfreie-stadt` # Bremen
- `stuttgart` # Stuttgart
- `osnabrueck` # Osnabrück
- `leverkusen` # Leverkusen
- `erfurt` # Erfurt
- `heidelberg` # Heidelberg
- `kassel` # Kassel
- `muenster` # Münster
- `herne` # Herne
- `oldenburg` # Oldenburg
- `dortmund` # Dortmund
- `fuerth` # Fürth
- `bremerhaven` # Bremerhaven
- `leipzig` # Leipzig
- `oberhausen` # Oberhausen
- `frankfurt-am-main` # Frankfurt
- `gelsenkirchen` # Gelsenkirchen
- `karlsruhe` # Karlsruhe
- `bottrop` # Bottrop
- `ulm` # Ulm
- `wuppertal` # Wuppertal
- `hagen` # Hagen
- `wolfsburg` # Wolfsburg
- `bielefeld` # Bielefeld
- `muenchen` # Munich
- `rostock` # Rostock
- `saarbruecken` # Saarbrücken
- `erlangen` # Erlangen
- `siegen` # Siegen
- `magdeburg` # Magdeburg
- `reutlingen` # Reutlingen
- `moenchengladbach` # Mönchengladbach
- `paderborn` # Paderborn
- `ludwigshafen-am-rhein` # Ludwigshafen
- `krefeld` # Krefeld
- `augsburg` # Augsburg

States:
- `rheinland-pfalz` # Rhineland-Palatinate
- `hessen` # Hesse
- `bayern` # Bavaria
- `sachsen` # Saxony
- `niedersachsen` # Lower Saxony
- `thueringen` # Thuringia
- `bremen` # Bremen (state)
- `brandenburg` # Brandenburg
- `saarland` # Saarland
- `sachsen-anhalt` # Saxony-Anhalt
- `hamburg` # Hamburg
- `berlin` # Berlin
- `schleswig-holstein` # Schleswig-Holstein
- `baden-wuerttemberg` # Baden-Württemberg
- `nordrhein-westfalen` # North Rhine-Westphalia
- `mecklenburg-vorpommern` # Mecklenburg-Western Pomerania


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