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 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
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();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:
{
"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
- Autenticación: header
X-Api-Key, alternativa Bearer y manejo de la key. - Cuotas y errores: headers de cuota, códigos de estado y retry.
- Referencia: parámetros, respuestas y modelos de cada operación.
- Playground: requests GET desde el navegador.