GOOVER PARA DESARROLLADORES

Consulta el catálogo de Goover desde tu sistema

Conecta tu CRM, ERP o aplicación interna con la API de lectura de Goover. Consulta el catálogo y reutiliza los datos en tu flujo de trabajo.

Gestionar mis claves →Ver documentación
GET /api/v1/catalog?kind=grant
Authorization: Bearer TU_CLAVE
Accept: application/json

{ "data": [...],
  "links": {...},
  "meta": {...} }

5.000 llamadas / mes

Cuota compartida por las claves de la cuenta. Mes natural de Europe/Madrid.

2 claves activas

Identifica cada integración, rota sus credenciales y revoca las que ya no utilices.

Solo lectura

Consulta oportunidades. No crea clientes, envía ofertas ni ejecuta análisis IA.

Conecta también asistentes mediante MCP

El endpoint https://goover.es/api/mcp ofrece las herramientas search_opportunities y get_opportunity mediante Streamable HTTP. Busca en el catálogo importado y devuelve referencias oficiales.

Necesitas un cliente compatible con cabeceras Authorization: Bearer. No utiliza OAuth y no accede a clientes, archivos privados ni análisis. Comparte las 5.000 llamadas mensuales y las dos claves con la API REST; la inicialización también consume una llamada.

Ver configuración y gestionar claves →

1. Prepara tu integración

  1. Crea tu cuenta y comprueba que tu plan incluye acceso API. El perfil de empresa no es obligatorio para consultar el catálogo.
  2. Abre Integración API dentro de Goover.
  3. Crea una clave con un nombre reconocible. Se muestra una sola vez y caduca a los 90 días.
  4. Guárdala en el gestor de secretos o las variables de entorno de tu servidor.
  5. Envía un GET con Authorization: Bearer TU_CLAVE y Accept: application/json.

Endpoint: https://goover.es/api/v1/catalog. Usa el dominio de tu instalación y HTTPS en producción. La URL mostrada corresponde a este entorno.

2. Filtros disponibles

ParámetroValores / límiteUso
qTexto, hasta 180 caracteresBuscar términos en el catálogo.
kindgrant, tender, award, guideAyuda, licitación, adjudicación o guía.
cpvEntre 2 y 8 dígitosCódigo de clasificación CPV.
statusopen, closed, awarded, resolved, upcomingEstado de la oportunidad.
page1–1.000Página de resultados, 50 por página.

Combina los parámetros con & y codifica correctamente los caracteres especiales. Los filtros del buscador visual no están disponibles automáticamente en la API: utiliza los documentados aquí.

3. Respuesta y paginación

data contiene las oportunidades; links incluye enlaces de paginación y meta los totales y la página actual. Avanza con page y detente cuando links.next sea nulo. Las páginas no son una instantánea inmutable: deduplica por id si sincronizas mientras cambia el catálogo.

Campos principales

id, kind, title, description, organization, status, amount, amount_basis, currency, deadline, source, source_url, territories, cpv_codes, documents y requirements, entre otros.

Los campos pueden ser nulos o estar vacíos si la fuente no publica esa información. amount no equivale a una ayuda concedida a tu empresa: interpreta amount_basis y consulta las bases. Las fechas de publicación y revisión se devuelven en formato ISO; los plazos utilizan fecha de calendario.

{
  "data": [{
    "id": 123,
    "kind": "grant",
    "title": "Ejemplo ilustrativo de convocatoria",
    "amount": "6000.00",
    "amount_basis": "Presupuesto total de la convocatoria; no es el importe por beneficiario",
    "currency": "EUR",
    "deadline": null
  }],
  "links": { "next": null },
  "meta": { "current_page": 1, "per_page": 50 }
}

Respuesta abreviada e ilustrativa. Los importes y los campos concretos dependen del registro de origen.

4. Ejemplos en tu lenguaje

Estos ejemplos consultan una página de ayudas. Configura GOOVER_API_URL con el endpoint de tu instalación y GOOVER_API_KEY con una clave de Goover, no con la clave de OpenAI. Las dependencias se indican en cada ejemplo.

cURL · Terminal
curl --get "$GOOVER_API_URL" \
  --header "Authorization: Bearer $GOOVER_API_KEY" \
  --header "Accept: application/json" \
  --data-urlencode 'kind=grant' \
  --data-urlencode 'q=digitalización' \
  --data-urlencode 'page=1' \
  --fail-with-body
JavaScript · Node.js con fetch nativo
const url = new URL(process.env.GOOVER_API_URL);
url.search = new URLSearchParams({kind: 'grant', page: '1'});
const response = await fetch(url, {
  headers: {
    Authorization: `Bearer ${process.env.GOOVER_API_KEY}`,
    Accept: 'application/json'
  },
  signal: AbortSignal.timeout(30000)
});
if (!response.ok) throw new Error(`Goover HTTP ${response.status}`);
const result = await response.json();
console.log(result.data);
console.log(response.headers.get('X-API-Monthly-Remaining'));

Ejecuta este código en el servidor; no publiques la clave en JavaScript del navegador.

Python · requests
import os
import requests

response = requests.get(
    os.environ['GOOVER_API_URL'],
    params={'kind': 'grant', 'page': 1},
    headers={
        'Authorization': f"Bearer {os.environ['GOOVER_API_KEY']}",
        'Accept': 'application/json'
    },
    timeout=30
)
response.raise_for_status()
print(response.json()['data'])

Dependencia: requests.

PHP · extensión cURL
$query = http_build_query(['kind' => 'grant', 'page' => 1]);
$curl = curl_init(getenv('GOOVER_API_URL') . '?' . $query);
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT => 30,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer ' . getenv('GOOVER_API_KEY'),
        'Accept: application/json',
    ],
]);
$body = curl_exec($curl);
$status = curl_getinfo($curl, CURLINFO_HTTP_CODE);
if ($body === false || $status !== 200) {
    throw new RuntimeException('Error consultando Goover: ' . $status);
}
curl_close($curl);
$result = json_decode($body, true, 512, JSON_THROW_ON_ERROR);
print_r($result['data']);
C# · HttpClient
using System.Net.Http.Headers;
using System.Text.Json;

using var client = new HttpClient { Timeout = TimeSpan.FromSeconds(30) };
client.DefaultRequestHeaders.Authorization =
    new AuthenticationHeaderValue("Bearer",
        Environment.GetEnvironmentVariable("GOOVER_API_KEY"));
client.DefaultRequestHeaders.Accept.Add(
    new MediaTypeWithQualityHeaderValue("application/json"));
var endpoint = Environment.GetEnvironmentVariable("GOOVER_API_URL")
    ?? throw new InvalidOperationException("Falta GOOVER_API_URL");
using var response = await client.GetAsync(endpoint + "?kind=grant&page=1");
response.EnsureSuccessStatusCode();
using var result = JsonDocument.Parse(await response.Content.ReadAsStringAsync());
Console.WriteLine(result.RootElement.GetProperty("data"));

5. Cuotas y errores

5.000 llamadas por mes natural, hasta 2 claves activas y 30 solicitudes por minuto por IP. Las llamadas autenticadas admitidas consumen cuota aunque los filtros sean inválidos. La revocación no reinicia el consumo.

  • 200: consulta correcta.
  • 401: clave ausente, inválida, caducada o revocada.
  • 403: cuenta bloqueada, dada de baja o clave no habilitada por el plan.
  • 422: filtros no válidos.
  • 429: límite por minuto o cuota mensual alcanzados.
  • 5xx: incidencia del servicio; reintenta con esperas crecientes.

Consulta X-API-Monthly-Limit, X-API-Monthly-Remaining y X-API-Monthly-Reset en las respuestas que las incluyan. Ante 429, respeta Retry-After cuando esté presente y no hagas reintentos en bucle.

6. Buenas prácticas

  • Integra desde tu servidor mediante HTTPS. No expongas claves en páginas, aplicaciones cliente, repositorios ni registros.
  • Usa una clave por integración, con un máximo de dos. Crea la nueva, cambia tu servicio y revoca la anterior antes de los 90 días.
  • Conserva el enlace oficial, la fecha de consulta y la atribución de la fuente. Revisa sus condiciones de reutilización.
  • Configura una frecuencia razonable y deduplica registros; la actualización depende de cada fuente incorporada.

CRM, ERP y automatizaciones

Un servicio propio o un conector HTTP puede consultar la API y transformar los resultados para tu CRM, ERP u hoja de cálculo. Son integraciones que debes configurar en tu sistema; no se ofrecen conectores nativos ni webhooks. La API REST es de lectura; el acceso MCP se describe más arriba.

Consultar una integración →