Documentación

Primer request

Registro, verificación de la key y primera consulta a un endpoint de datos.

1. Obtén la API key

Solicita una key gratuita en api.buscafondos.com/register. Tras verificar el email, la key se muestra una sola vez; el backend conserva únicamente su hash. Guárdala en el gestor de secretos de tu entorno.

2. Verifica la key

curl
curl https://api.buscafondos.com/api/key/info \
-H "X-Api-Key: $BUSCAFONDOS_API_KEY"

/api/key/info devuelve tier, cuota diaria y consumo del día. Esta llamada no descuenta cuota.

3. Consulta fondos

JavaScript / TypeScript
const response = await fetch(
"https://api.buscafondos.com/api/all-funds?category=money_market",
{ headers: { "X-Api-Key": process.env.BUSCAFONDOS_API_KEY! } },
);

if (!response.ok) {
throw new Error(`BuscaFondos respondió ${response.status}`);
}

const payload: unknown = await response.json();
Python
import os
import requests

response = requests.get(
  "https://api.buscafondos.com/api/all-funds",
  params={"category": "money_market"},
  headers={"X-Api-Key": os.environ["BUSCAFONDOS_API_KEY"]},
  timeout=20,
)
response.raise_for_status()
payload = response.json()

Comprobar conectividad sin key

GET /health es el único endpoint público. Respuesta capturada el 26 de agosto de 2026:

GET /health · 200 OK
{
"status": "ok",
"last_scraped_date": "2026-08-25",
"total_records": 4913905
}

Los ejemplos de respuesta de la referencia API provienen del snapshot OpenAPI del backend y se actualizan con él.

Siguientes pasos