API pública de licitaciones

Tendova publica como API JSON de solo lectura los datos de licitaciones que recoge de TED. Es gratuita, se puede probar sin clave y devuelve los mismos anuncios que muestra el sitio.

Qué devuelve la API

Dos endpoints, ambos JSON y ambos de solo lectura.

GET /api/tenders — busca licitaciones activas por texto completo, país, código CPV y orden, y devuelve una página de resultados con su paginación.
GET /api/tenders/{id} — devuelve una licitación completa: comprador, códigos CPV, lugar de ejecución, valor estimado, plazos y los enlaces oficiales a la fuente.
Los títulos y las descripciones se devuelven en cualquiera de las 24 lenguas oficiales de la UE mediante el parámetro locale.

Los resúmenes de IA, las puntuaciones de coincidencia, los análisis de encaje y el análisis documental nunca forman parte de una respuesta de la API. Se quedan dentro del producto.

Autenticación

No hace falta clave para probar la API. Envía una en cuanto construyas sobre ella: las claves son gratuitas en todos los planes y amplían tu cuota. Ambas cabeceras funcionan.

Authorization: Bearer tdv_live_…
X-Api-Key: tdv_live_…

Una clave desconocida, mal formada o revocada se rechaza con HTTP 401 y el código de error invalid_api_key. No enviar ninguna clave es una llamada anónima, no un error.

Crear una clave en tu cuenta

Límites de uso

Llamante	Cuota de solicitudes	Registros por solicitud
Sin clave	20 solicitudes por minuto y dirección IP	hasta 20
Clave del plan Free	500 solicitudes al día y por clave	hasta 20
Clave del plan Pro	10.000 solicitudes al día y por clave	hasta 50

Las llamadas con clave pasan además un control de picos de 60 solicitudes por minuto, para que una cuota diaria no se agote de una vez.

Cada respuesta incluye x-ratelimit-limit y x-ratelimit-remaining. Una llamada por encima del límite devuelve HTTP 429 con retry-after en segundos.

Ejemplos

Buscar licitaciones

curl -s "https://tendova.eu/api/tenders?q=software&country=DE&limit=20&locale=es" \
  -H "Authorization: Bearer tdv_live_YOUR_KEY"

Obtener una licitación

curl -s "https://tendova.eu/api/tenders/{id}?locale=es" \
  -H "Authorization: Bearer tdv_live_YOUR_KEY"

Omite la cabecera Authorization para llamar de forma anónima. Cada elemento de la lista incluye un campo apiUrl: la URL de detalle de esa licitación, lista para consultar.

Para agentes de IA

Un breve archivo de orientación describe los mismos endpoints en el formato de llmstxt.org, para asistentes de código y frameworks de agentes.

Abrir llms.txt

De dónde proceden los datos

Todos los anuncios proceden de Tenders Electronic Daily (TED), el diario oficial de contratación pública de la UE. Tendova añade traducción, estructura y búsqueda; los anuncios en sí siguen siendo datos públicos.

Para acceso masivo o comercial a los datos, escribe a [email protected].