Name: Spain Public Jobs and Tenders API: BOE and Catalonia
Brand: hispanodata
SKU: api-hispanodata-hispanodata-open-data
Availability: InStock
Author: API Market

# Spain Public Jobs and Tenders API

## Overview

The hispanodata Open Data API returns two official Spanish open-data sources as structured JSON. `GET /v1/oposiciones` lists public-job and civil-service notices from section II.B of the Official State Gazette (BOE), with the department, administration level, category, document type and links to the HTML and PDF notice. `GET /v1/licitaciones` lists public tender notices for Catalonia from the Plataforma de serveis de contractació pública (PSCP), with the contracting body, contract type, phase, amounts, deadlines and links.

It is built for job boards and alert services for public employment, tender monitoring tools, consultancies and B2G sales teams. In our tests the BOE endpoint returned notices published from 9 to 13 November 2026, the PSCP endpoint returned open Barcelona tenders such as water network works for the municipality of Gualba, and an invalid date returned a clear `400`. Every response cites its source and carries a disclaimer: this is not an official service.

## Features

*   **2 endpoints**: BOE public-job notices and Catalonia PSCP tenders.
*   **Date filters**: a single `date` or a `from`/`to` range of up to 7 days.
*   **Filters**: document type, administration level, contract type, province and keyword.
*   **Up to 200 rows**: per call, with a `truncated` flag.
*   **Source citation**: every response carries the official source and licence text.

## Use Cases

*   **Public job boards**: alert candidates to new oposiciones.
*   **Tender monitoring**: track new Catalonia tenders by province and type.
*   **B2G sales**: find contracts that match your services.
*   **Research**: analyse public hiring and procurement.

## API Documentation

### Base URL

All requests use the following base URL.

```
https://prod.api.market/api/v1/hispanodata/hispanodata-open-data
```

### Authentication

All requests are authenticated with the `x-api-market-key` header.

```
x-api-market-key: YOUR_API_KEY
```

Replace `YOUR_API_KEY` with your actual API key.

### Endpoints

#### 1. List public-job notices

Returns BOE section II.B notices in the date range.

**Method:** `GET`

**Endpoint:** `/v1/oposiciones`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `date` | query | One publication day, `YYYY-MM-DD` | string | No | today | - |
| `from` | query | First day of a range, `YYYY-MM-DD` | string | No | - | - |
| `to` | query | Last day of a range (7 days at most) | string | No | - | - |
| `documentType` | query | `call`, `amendment`, `correction`, `admittedList`, `selectionBoard`, `results`, `freeDesignation`, `internalTransfer` or `other` | string | No | - | - |
| `administrationLevel` | query | `state`, `regional`, `local` or `university` | string | No | - | - |
| `keyword` | query | Word to find in the title or category | string | No | - | - |
| `maxItems` | query | Maximum rows returned | integer | No | 100 | 200 |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/hispanodata/hispanodata-open-data/v1/oposiciones?from=2026-11-09&to=2026-11-13&maxItems=3' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "fuente": "Basado en datos de la Agencia Estatal Boletín Oficial del Estado (https://www.boe.es)",
  "datos_via": "hispanodata",
  "source": "Basado en datos de la Agencia Estatal Boletín Oficial del Estado (https://www.boe.es)",
  "officialDisclaimer": "This is not an official service and is not endorsed, sponsored or affiliated with the AEBOE, the Generalitat de Catalunya or the Ministerio de Hacienda (Plataforma de Contratación...",
  "from": "2026-11-09",
  "to": "2026-11-13",
  "truncated": true,
  "count": 3,
  "results": [
    {
      "id": "BOE-A-2026-23418",
      "publicationDate": "2026-11-09",
      "boeIssue": "BOE-S-2026-279",
      "department": "MINISTERIO DE CIENCIA, INNOVACIÓN Y UNIVERSIDADES",
      "administrationLevel": "state",
      "category": "Escala de Ayudantes de Investigación de los Organismos Públicos de Investigación",
      "title": "Resolución de 30 de octubre de 2026, de la Subsecretaría, por la que se corrigen errores en la de 22 de diciembre de 2025, por la que se convoca proceso selectivo para ingreso,...",
      "documentType": "correction",
      "urlHtml": "https://www.boe.es/diario_boe/txt.php?id=BOE-A-2026-23418",
      "urlPdf": "https://www.boe.es/boe/dias/2026/11/09/pdfs/BOE-A-2026-23418.pdf",
      "fuente": "Basado en datos de la Agencia Estatal Boletín Oficial del Estado (https://www.boe.es)",
      "datos_via": "hispanodata",
      "source": "Basado en datos de la Agencia Estatal Boletín Oficial del Estado (https://www.boe.es)"
    }
  ]
}
```

The `results` list above is shortened to one of three notices. An invalid date returns `400`:

```json
{
  "error": "Invalid 'date': use a real calendar date in YYYY-MM-DD format.",
  "datos_via": "hispanodata"
}
```

#### 2. List Catalonia tenders

Returns PSCP tender notices in the date range.

**Method:** `GET`

**Endpoint:** `/v1/licitaciones`

**Parameters:**

| Name | In | Description | Type | Required | Default | Max Value |
|---|---|---|---|---|---|---|
| `from` | query | First day, `YYYY-MM-DD` | string | No | today | - |
| `to` | query | Last day (7 days at most) | string | No | today | - |
| `contractType` | query | `works`, `services`, `supplies`, `administrativeSpecial`, `worksConcession`, `servicesConcession`, `other` and more | string | No | - | - |
| `province` | query | `barcelona`, `girona`, `lleida` or `tarragona` | string | No | - | - |
| `keyword` | query | Word to find in the title or description | string | No | - | - |
| `maxItems` | query | Maximum rows returned | integer | No | 50 | 200 |

**Example Request:**

```bash
curl -X GET 'https://prod.api.market/api/v1/hispanodata/hispanodata-open-data/v1/licitaciones?from=2026-11-10&to=2026-11-13&province=barcelona&maxItems=3' \
  -H 'x-api-market-key: YOUR_API_KEY'
```

**Example Response (200 OK):**

```json
{
  "fuente": "Generalitat de Catalunya. Departament d'Economia i Finances. Dataset 'Contractació pública a Catalunya: publicacions a la Plataforma de serveis de contractació pública'...",
  "datos_via": "hispanodata",
  "source": "Generalitat de Catalunya. Departament d'Economia i Finances. Dataset 'Contractació pública a Catalunya: publicacions a la Plataforma de serveis de contractació pública'...",
  "officialDisclaimer": "This is not an official service and is not endorsed, sponsored or affiliated with the AEBOE, the Generalitat de Catalunya or the Ministerio de Hacienda (Plataforma de Contratación...",
  "sourceLastUpdated": "2026-11-13T09:00:18.000Z",
  "fecha_actualizacion_fuente": "2026-11-13T09:00:18.000Z",
  "from": "2026-11-10",
  "to": "2026-11-13",
  "truncated": true,
  "count": 3,
  "results": [
    {
      "id": "268b22cc-6e40-45e3-8d44-6682a50ac3df",
      "phase": "open",
      "phaseOriginal": "Anunci de licitació",
      "publishedAt": "2026-11-12T19:48:00.000",
      "title": "Millores a la xarxa d'abastament d'aigua potable del Municipi de Gualba",
      "description": "L’objectiu general del present contracte  és la millora operativa de la xarxa de distribució mitjançant la sectorització . es proposa la següents actuacions :  - actuació 1....",
      "fileNumber": "X2026001712",
      "contractType": "works",
      "contractTypeOriginal": "Obres",
      "procedure": "Obert simplificat",
      "contractingBody": "Ajuntament de Gualba",
      "nuts": "ES511",
      "province": "Barcelona",
      "budgetExVat": 214107.7,
      "budgetIncVat": 259070.32,
      "estimatedValue": 214107.7,
      "submissionDeadline": "2026-12-02T23:59:00.000",
      "url": "https://contractaciopublica.cat/ca/detall-publicacio/268b22cc-6e40-45e3-8d44-6682a50ac3df/300926447",
      "fuente": "Generalitat de Catalunya. Departament d'Economia i Finances. Dataset 'Contractació pública a Catalunya: publicacions a la Plataforma de serveis de contractació pública'...",
      "datos_via": "hispanodata",
      "source": "Generalitat de Catalunya. Departament d'Economia i Finances. Dataset 'Contractació pública a Catalunya: publicacions a la Plataforma de serveis de contractació pública'...",
      "sourceLastUpdated": "2026-11-13T09:00:18.000Z"
    }
  ]
}
```

The `results` list above is shortened to one of three tenders.

## Status Codes

| Code | Status | Description |
|---|---|---|
| 200 | OK | The request succeeded and the JSON result is in the response body. |
| 400 | Bad Request | A date is not valid or the range is longer than 7 days. The message says which. |
| 401 | Unauthorized | The `x-api-market-key` header is missing or the key is not valid. |
| 403 | Forbidden | Your key does not have an active subscription that includes this endpoint. |
| 404 | Not Found | The path does not match an endpoint of this API. Check the Base URL and path. |
| 429 | Too Many Requests | You went over the requests per second of your plan or used up its calls. |
| 500 | Internal Server Error | The request failed on the server. Retry once, then contact us if it continues. |
| 503 | Service Unavailable | The service is temporarily unavailable. Retry after a short wait. |

## Rate Limits

The Free trial includes 50 calls at 2 requests per second. PAYG allows 10 requests per second and is billed $0.005 per call. When you go over a limit, the API returns `429 Too Many Requests`. Throttle your requests, back off before retrying, and honour the `Retry-After` header when it is present.

## FAQ

*   **Why did I get no results?**
    Without dates the API uses today. The BOE is not published on Sundays and PSCP has fewer notices at weekends, so send a `from`/`to` range of up to 7 days.

*   **Does it return the full notice text?**
    No. It returns the fields of the official summaries and dataset, plus links to the HTML and PDF of each notice.

*   **Can I reuse the data?**
    The data stays under the official BOE and Generalitat de Catalunya licences, which are cited in every response.

*   **How is a call counted?**
    Each successful request counts as one call, whatever the number of rows.

## Contact Us

If you have any questions or need support, reach out through the chat embedded on this page or email us at hello@magicapi.com.


Spanish open data as JSON: BOE public-job notices (oposiciones) and Catalonia PSCP public tenders, filtered by date, type, province and keyword.