# English Jobs Spain

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

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

## Allowed Locations

Below is the list of supported location IDs:

Cities:
- `valencia` # Valencia
- `bilbao` # Bilbao
- `badalona` # Badalona
- `cartagena` # Cartagena
- `jerez-de-la-frontera` # Jerez de la Frontera
- `ourense` # Ourense
- `portugalete` # Portugalete
- `errenteria` # Errenteria
- `zaragoza` # Zaragoza
- `huelva` # Huelva
- `el-puerto-de-santa-maria` # El Puerto de Santa María
- `pontevedra` # Pontevedra
- `malaga` # Málaga
- `palencia` # Palencia
- `burriana` # Borriana
- `granada` # Granada
- `las-palmas-de-gran-canaria` # Las Palmas
- `sabadell` # Sabadell
- `lugo` # Lugo
- `rubi` # Rubí
- `gandia` # Gandia
- `merida` # Mérida
- `albacete` # Albacete
- `castellon-de-la-plana` # Castelló de la Plana
- `guadalajara` # Guadalajara
- `ponferrada` # Ponferrada
- `arrecife` # Arrecife
- `oviedo` # Oviedo
- `mijas` # Mijas
- `antequera` # Antequera
- `ecija` # Écija
- `tudela` # Tudela
- `avila` # Ávila
- `gijon` # Gijón
- `santa-cruz-de-tenerife` # Santa Cruz de Tenerife
- `tarragona` # Tarragona
- `benalmadena` # Benalmádena
- `vilanova-i-la-geltru` # Vilanova i la Geltrú
- `motril` # Motril
- `pamplona` # Pamplona
- `almeria` # Almería
- `santander` # Santander
- `marbella` # Marbella
- `cadiz` # Cádiz
- `soria` # Soria
- `madrid` # Madrid
- `mostoles` # Móstoles
- `leon` # León
- `melilla` # Melilla
- `aviles` # Avilés
- `cordoba` # Córdoba
- `valladolid` # Valladolid
- `alcala-de-henares` # Alcalá de Henares
- `badajoz` # Badajoz
- `palma-de-mallorca` # Palma de Mallorca
- `alicante` # Alicante
- `vitoria-gasteiz` # Vitoria-Gasteiz
- `san-cristobal-de-la-laguna` # La Laguna
- `salamanca` # Salamanca
- `caceres` # Cáceres
- `ferrol` # Ferrol
- `torrelavega` # Torrelavega
- `burgos` # Burgos
- `jaen` # Jaén
- `zamora` # Zamora
- `granollers` # Granollers
- `eivissa` # Ibiza
- `plasencia` # Plasencia
- `ronda` # Ronda
- `sevilla` # Seville
- `vigo` # Vigo
- `benidorm` # Benidorm
- `villarreal` # Vila-real
- `ubeda` # Úbeda
- `barcelona` # Barcelona
- `girona` # Girona
- `lorca` # Lorca
- `ceuta` # Ceuta
- `yecla` # Yecla
- `villena` # Villena

Comunidades:
- `cataluna` # Catalonia
- `aragon` # Aragon
- `comunidad-foral-de-navarra` # Navarre
- `castilla-la-mancha` # Castile-La Mancha
- `region-de-murcia` # Region of Murcia
- `principado-de-asturias` # Asturias
- `comunidad-de-madrid` # Community of Madrid
- `castilla-y-leon` # Castile and León
- `islas-baleares` # Balearic Islands
- `extremadura` # Extremadura
- `la-rioja` # La Rioja
- `andalucia` # Andalusia
- `comunidad-valenciana` # Community of Valencia
- `galicia` # Galicia
- `pais-vasco` # Basque Country
- `islas-canarias` # Canary Islands
- `cantabria` # Cantabria


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