API de Aralda

Consulta licitaciones, plazos, filtros y fuentes desde tus herramientas mediante la API.

Autenticación

https://api.aralda.com/v1

Authorization: Bearer arla_…

La clave completa se muestra una sola vez. Copia la clave y guárdala de forma segura: no la compartas.

Plan	Solicitudes al día	Solicitudes por minuto	Resultados por página	Desplazamiento máximo
Cazador	200	30	25	500
Gremio	20.000	120	100	10.000
Maestro	2000	30	50	2500

Busca licitaciones por palabras, país, CPV, comprador y plazo.

Parámetros: q, paese (ISO2, CSV ≤10), cpv ([0-9]{1,8}, CSV ≤10), ente, scadenza_giorni (1–365), pagina, per_page

curl 'https://api.aralda.com/v1/search?q=software&paese=IT&pagina=1&per_page=10' \
  -H 'Authorization: Bearer arla_…'

Detalles de una licitación mediante su ID.

Parámetros: id (UUID)

curl 'https://api.aralda.com/v1/tenders/00000000-0000-4000-8000-000000000001' \
  -H 'Authorization: Bearer arla_…'

Licitaciones abiertas ordenadas por plazo.

Parámetros: giorni (1–365), limite (1–200, ≤ per_page), pagina, per_page

curl 'https://api.aralda.com/v1/deadlines?giorni=30&limite=10&per_page=10' \
  -H 'Authorization: Bearer arla_…'

Lista de tus filtros guardados.

Parámetros: —

curl 'https://api.aralda.com/v1/filters' \
  -H 'Authorization: Bearer arla_…'

Nuevas licitaciones para tu filtro; la primera llamada abarca los últimos 7 días y luego actualiza la última consulta.

Parámetros: id (UUID)

curl 'https://api.aralda.com/v1/filters/00000000-0000-4000-8000-000000000002/new' \
  -H 'Authorization: Bearer arla_…'

Lista de fuentes activas y su licencia.

Parámetros: —

curl 'https://api.aralda.com/v1/sources' \
  -H 'Authorization: Bearer arla_…'

{"ok":false,"family":"auth","correlation_id":"…"}

401 auth — Clave ausente o no válida.
402 abbonamento — Suscripción inactiva o caducada.
403 accesso — Tu plan no incluye acceso a la API.
429 quota — Límite de solicitudes alcanzado; inténtalo tras el intervalo indicado. · Retry-After
400 invalid_input — Parámetros no válidos.
404 not_found — Recurso no encontrado.