Los datos de Subvencióname, en JSON y por REST: las convocatorias de subvenciones de la BDNS (~208.000, enriquecidas con plazos), los contratos públicos en plazo (PLACSP, TED y BOE) y las adjudicaciones con NIF del adjudicatario. Solo lectura, pensada para integrarla en tu CRM, tu panel interno o tu propio producto.
Está incluida en el plan Gestoría Plus (89 €/mes). Las claves se crean y revocan desde tu cuenta (hasta 3 activas). Cada clave admite 1000 peticiones al día; las cabeceras X-RateLimit-Limit y X-RateLimit-Remaining te dicen por dónde vas, y un 429 trae Retry-After.
Cabecera Authorization con tu clave. La clave se enseña una sola vez al crearla: guárdala en tu gestor de secretos y úsala solo desde tu servidor. La API no emite CORS a propósito — una clave en el navegador de tus usuarios es una clave filtrada.
curl -H "Authorization: Bearer sv_live_TU_CLAVE" \ "https://subvencioname.app/api/v1/convocatorias?q=digitalizacion&ccaa=rioja&abiertas=1"
Búsqueda de convocatorias con los mismos filtros que el buscador. La respuesta es { data, total, page, pageSize }; cada elemento trae código BDNS, título, órgano, fechas de solicitud, estado (abierta = solicitable hoy), presupuesto y el enlace a su ficha.
| Parámetro | Qué acepta |
|---|---|
| q | Texto libre («digitalización hostelería»). |
| ambito | ESTADO · AUTONOMICA · LOCAL · OTROS. |
| ccaa | Slug de la comunidad: rioja, pais-vasco, navarra, castilla-leon… |
| provincia | Nombre oficial («La Rioja», «Bizkaia»); filtra por NUTS3. |
| abiertas | 1 para solo solicitables hoy. |
| pymes | 1 para solo dirigidas a pymes y autónomos. |
| ue | 1 para solo fondos europeos (Next Generation, FEDER…). |
| orden | recientes · cierre · presupuesto. |
| page | Entero 1–10000 (por defecto 1). |
| pageSize | Entero 1–100 (por defecto 25). |
Ficha completa por código BDNS: además de lo del listado, la finalidad, los tipos de beneficiarios, sectores, regiones, los textos del plazo y los enlaces a las bases reguladoras y la sede electrónica. Si la convocatoria aún no está enriquecida, se consulta la BDNS en vivo — la API nunca sabe menos que la web.
curl -H "Authorization: Bearer sv_live_TU_CLAVE" \ "https://subvencioname.app/api/v1/convocatorias/922483"
El dossier de tramitación en JSON: qué es, quién puede pedirla, documentación, dónde y cómo se presenta, obligaciones de justificación y avisos. El plazo y el presupuesto exactos van en la ficha de la convocatoria (endpoint anterior). Se genera con IA a partir de la ficha oficial la primera vez que alguien lo pide (la generación tiene su propio límite diario) y las siguientes lecturas salen de caché. Es orientativo: la letra vinculante está en las bases reguladoras.
curl -H "Authorization: Bearer sv_live_TU_CLAVE" \ "https://subvencioname.app/api/v1/convocatorias/922483/dossier"
Contratos públicos con el plazo de presentación abierto, de las cuatro fuentes (PLACSP, contratos menores, TED y BOE).
| Parámetro | Qué acepta |
|---|---|
| q | Texto libre contra el objeto del contrato y el órgano. |
| provincia | Nombre («La Rioja», «Málaga»). |
| tipo | Código del tipo de contrato: 1 suministros, 2 servicios, 3 obras… |
| importeMin / importeMax | Números en euros, sin separadores. |
| orden | margen (por defecto) · cierre · importe. |
| page | Entero 1–10000 (por defecto 1). |
| pageSize | Entero 1–100 (por defecto 25). |
Contratos ya adjudicados (~640.000), con NIF del adjudicatario. Con nif se ignora q. Cada fila lleva importe_iva («con IVA», «sin IVA» o vacío) porque las fuentes públicas no lo declaran igual.
| Parámetro | Qué acepta |
|---|---|
| nif | NIF del adjudicatario (se valida el dígito de control). |
| q | Texto contra adjudicatario u objeto. |
| provincia | Nombre de la provincia. |
| page | Entero 1–10000 (por defecto 1). |
| pageSize | Entero 1–100 (por defecto 25). |
| Código | Cuándo |
|---|---|
| 400 | Un parámetro no vale; el cuerpo { "error": "…" } dice cuál. |
| 401 | Falta la clave, no es válida o está revocada. |
| 403 | La cuenta ya no tiene el plan Gestoría Plus. |
| 404 | El código BDNS no existe. |
| 429 | Cuota diaria agotada; Retry-After indica cuándo se reabre. |
| 503 | No se pudo verificar la clave o la cuota; reintenta en unos minutos. |
Los datos proceden de fuentes oficiales (BDNS/SNPSAP, PLACSP, BOE, TED) y se reutilizan conforme a la Ley 37/2007: si los publicas, cita la fuente. La API es de solo lectura y su cuota es por clave; si tu integración necesita más volumen, escríbenos.