# English Jobs Italy

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

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

## Allowed Locations

Below is the list of supported location IDs:

Cities:
- `treviso` # Treviso
- `varese` # Varese
- `castellammare-di-stabia` # Castellammare di Stabia
- `pozzallo` # Pozzallo
- `roma` # Rome
- `verona` # Verona
- `padova` # Padua
- `siracusa` # Syracuse
- `forli` # Forlì
- `caserta` # Caserta
- `biella` # Biella
- `messina` # Messina
- `brescia` # Brescia
- `bolzano` # Bolzano
- `genova` # Genoa
- `venezia` # Venice
- `taranto` # Taranto
- `livorno` # Livorno
- `giugliano-in-campania` # Giugliano in Campania
- `terni` # Terni
- `perugia` # Perugia
- `sassari` # Sassari
- `andria` # Andria
- `molfetta` # Molfetta
- `urbino` # Urbino
- `milano` # Milan
- `monza` # Monza
- `lecce` # Lecce
- `brindisi` # Brindisi
- `siena` # Siena
- `firenze` # Florence
- `foggia` # Foggia
- `salerno` # Salerno
- `bergamo` # Bergamo
- `trento` # Trento
- `pisa` # Pisa
- `napoli` # Naples
- `prato` # Prato
- `udine` # Udine
- `catanzaro` # Catanzaro
- `macerata` # Macerata
- `bologna` # Bologna
- `parma` # Parma
- `reggio-di-calabria` # Reggio Calabria
- `vicenza` # Vicenza
- `agrigento` # Agrigento
- `narni` # Narni
- `torino` # Turin
- `reggio-nell-emilia` # Reggio nell'Emilia
- `rimini` # Rimini
- `busto-arsizio` # Busto Arsizio
- `catania` # Catania
- `novara` # Novara
- `como` # Como
- `bari` # Bari
- `ravenna` # Ravenna
- `latina` # Latina
- `piacenza` # Piacenza
- `asti` # Asti
- `potenza` # Potenza
- `san-vito-dei-normanni` # San Vito dei Normanni
- `palermo` # Palermo
- `trieste` # Trieste
- `modena` # Modena
- `ancona` # Ancona
- `savona` # Savona
- `ferrara` # Ferrara
- `pescara` # Pescara

Regions:
- `lazio` # Lazio
- `campania` # Campania
- `sicily` # Sicily
- `umbria` # Umbria
- `valle-daosta` # Aosta Valley
- `sardegna` # Sardinia
- `marche` # Marche
- `molise` # Molise
- `piemonte` # Piedmont
- `apulia` # Apulia
- `toscana` # Tuscany
- `liguria` # Liguria
- `abruzzo` # Abruzzo
- `lombardia` # Lombardy
- `veneto` # Veneto
- `emilia-romagna` # Emilia-Romagna
- `calabria` # Calabria
- `friuli-venezia-giulia` # Friuli–Venezia Giulia
- `trentino-alto-adige` # Trentino-South Tyrol
- `basilicata` # Basilicata


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