# English Jobs Portugal

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

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

## Allowed Locations

Below is the list of supported location IDs:

Cities:
- `almada` # Almada
- `praia-da-vitoria` # Praia da Vitória
- `braga` # Braga
- `moita` # Moita
- `cantanhede` # Cantanhede
- `porto` # Porto
- `vila-nova-de-famalicao` # Vila Nova de Famalicão
- `aveiro` # Aveiro
- `tavira` # Tavira
- `maia` # Maia
- `beja` # Beja
- `peniche` # Peniche
- `elvas` # Elvas
- `mangualde` # Mangualde
- `matosinhos` # Matosinhos
- `coimbra` # Coimbra
- `barreiro` # Barreiro
- `vila-real` # Vila Real
- `braganca` # Bragança
- `cinfaes` # Cinfães
- `serta` # Sertã
- `macedo-de-cavaleiros` # Macedo de Cavaleiros
- `barcelos` # Barcelos
- `oliveira-de-azemeis` # Oliveira de Azeméis
- `sesimbra` # Sesimbra
- `portalegre` # Portalegre
- `oliveira-do-bairro` # Oliveira do Bairro
- `arouca` # Arouca
- `oliveira-do-hospital` # Oliveira do Hospital
- `peso-da-regua` # Peso da Régua
- `caminha` # Caminha
- `grandola` # Grândola
- `valenca` # Valença
- `loule` # Loulé
- `trofa` # Trofa
- `silves` # Silves
- `esposende` # Esposende
- `sao-joao-da-madeira` # São João da Madeira
- `coruche` # Coruche
- `guimaraes` # Guimarães
- `chaves` # Chaves
- `angra-do-heroismo` # Angra do Heroísmo
- `vila-real-de-santo-antonio` # Vila Real de Santo António
- `castelo-de-paiva` # Castelo de Paiva
- `vila-nova-de-gaia` # Vila Nova de Gaia
- `felgueiras` # Felgueiras
- `tomar` # Tomar
- `torres-novas` # Torres Novas
- `anadia` # Anadia
- `benavente` # Benavente
- `funchal` # Funchal
- `valongo` # Valongo
- `ribeira-grande` # Ribeira Grande
- `machico` # Machico
- `ponte-de-sor` # Ponte de Sor
- `batalha` # Batalha
- `moura` # Moura
- `mafra` # Mafra
- `alcobaca` # Alcobaça
- `fafe` # Fafe
- `loures` # Loures
- `faro` # Faro
- `caldas-da-rainha` # Caldas da Rainha
- `ponte-de-lima` # Ponte de Lima
- `mealhada` # Mealhada
- `moncao` # Monção
- `sines` # Sines
- `azambuja` # Azambuja
- `cabeceiras-de-basto` # Cabeceiras de Basto
- `pombal` # Pombal
- `agueda` # Águeda
- `santiago-do-cacem` # Santiago do Cacém
- `cartaxo` # Cartaxo
- `salvaterra-de-magos` # Salvaterra de Magos
- `povoa-de-lanhoso` # Póvoa de Lanhoso
- `condeixa-a-nova` # Condeixa-a-Nova
- `estremoz` # Estremoz
- `leiria` # Leiria
- `santo-tirso` # Santo Tirso
- `santarem` # Santarém
- `albufeira` # Albufeira
- `castro-daire` # Castro Daire
- `nazare` # Nazaré
- `nelas` # Nelas
- `amadora` # Amadora
- `pacos-de-ferreira` # Paços de Ferreira
- `ovar` # Ovar
- `montijo` # Montijo
- `santa-cruz` # Santa Cruz
- `ilhavo` # Ílhavo
- `sintra` # Sintra
- `alcochete` # Alcochete
- `guarda` # Guarda
- `montemor-o-novo` # Montemor-o-Novo
- `setubal` # Setúbal
- `evora` # Évora
- `marco-de-canaveses` # Marco de Canaveses
- `estarreja` # Estarreja
- `soure` # Soure
- `lousa` # Lousã
- `povoa-de-varzim` # Póvoa de Varzim
- `tondela` # Tondela
- `lourinha` # Lourinhã
- `vale-de-cambra` # Vale de Cambra
- `torres-vedras` # Torres Vedras
- `castelo-branco` # Castelo Branco
- `lagos` # Lagos
- `mirandela` # Mirandela
- `vizela` # Vizela
- `almeirim` # Almeirim
- `valpacos` # Valpaços
- `gondomar` # Gondomar
- `odivelas` # Odivelas
- `santa-maria-da-feira` # Santa Maria da Feira
- `viseu` # Viseu
- `marinha-grande` # Marinha Grande
- `vagos` # Vagos
- `horta` # Horta
- `gouveia` # Gouveia
- `amarante` # Amarante
- `montemor-o-velho` # Montemor-o-Velho
- `oeiras` # Oeiras
- `viana-do-castelo` # Viana do Castelo
- `penafiel` # Penafiel
- `figueira-da-foz` # Figueira da Foz
- `fundao` # Fundão
- `albergaria-a-velha` # Albergaria-a-Velha
- `palmela` # Palmela
- `vila-do-conde` # Vila do Conde
- `rio-maior` # Rio Maior
- `penacova` # Penacova
- `lisboa` # Lisbon
- `paredes` # Paredes
- `portimao` # Portimão
- `olhao` # Olhão
- `seia` # Seia
- `cadaval` # Cadaval
- `covilha` # Covilhã
- `espinho` # Espinho
- `odemira` # Odemira
- `baiao` # Baião
- `seixal` # Seixal
- `vila-franca-de-xira` # Vila Franca de Xira
- `lousada` # Lousada
- `entroncamento` # Entroncamento
- `celorico-de-basto` # Celorico de Basto
- `cascais` # Cascais
- `vila-verde` # Vila Verde
- `ourem` # Ourém
- `lamego` # Lamego
- `lagoa` # Lagoa
- `serpa` # Serpa
- `ponta-delgada` # Ponta Delgada
- `abrantes` # Abrantes
- `porto-de-mos` # Porto de Mós

Districs:
- `leiria-district` # Leiria District
- `aveiro-district` # Aveiro District
- `azores` # Azores
- `lisboa-district` # Lisbon District
- `coimbra-district` # Coimbra District
- `viseu-district` # Viseu District
- `faro-district` # Faro District
- `vila-real-district` # Vila Real District
- `portalegre-district` # Portalegre District
- `beja-district` # Beja District
- `porto-district` # Porto District
- `setubal-district` # Setúbal District
- `braga-district` # Braga District
- `evora-district` # Évora District
- `castelo-branco-district` # Castelo Branco District
- `braganca-district` # Bragança District
- `viana-do-castelo-district` # Viana do Castelo District
- `santarem-district` # Santarém District
- `guarda-district` # Guarda District
- `madeira` # Madeira


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