[ search · endpoint ]API de búsqueda · Económico

API de búsqueda de indicadores económicos

Consulta FRED, la Oficina de Estadísticas Laborales de EE. UU., indicadores del Banco Mundial, datos macro del FMI, gasto federal de EE. UU. y estadísticas laborales alemanas desde un solo endpoint. JSON preformateado para investigación macroeconómica con IA.

●50 créditos / llamada●60 req / minPOST /api/search/economic

[ 01 · live ]

Prueba la búsqueda de datos económicos en vivo

Introduce tu API Key y ejecuta una consulta real contra el endpoint en producción.

auth · x-api-key

Clave API

¿No tienes una clave API?

Inicia sesión en tu cuenta para crear y gestionar tus claves API.

Iniciar sesión Gestionar claves API

[ 02 · integrate ]

Integration guide

Copy a snippet, replace your API key, run. Works in any HTTP client — examples below in cURL, JavaScript, and Python.

spec

POST/api/search/economic

base

https://www.apipick.com

Búsqueda semántica en FRED, BLS, Banco Mundial, FMI, USAspending y Destatis. Devuelve registros ordenados con URLs fuente listos para LLMs.

parameters

querystringrequired

Natural-language search query

max_num_resultsintegeroptional

1–5, default 5

relevance_thresholdnumberoptional

0.0–1.0 quality filter

country_codestringoptional

ISO country code (e.g. US, GB)

start_datestringoptional

ISO date YYYY-MM-DD

end_datestringoptional

ISO date YYYY-MM-DD

curl -X POST "https://www.apipick.com/api/search/economic" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "US unemployment rate over the past two years",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'

● 200 · response

{
  "query": "US unemployment rate over the past two years",
  "results": [
    {
      "title": "Example result",
      "url": "https://example.com/article",
      "snippet": "Short excerpt of the page content…",
      "source_type": "web",
      "published_at": "2026-04-15",
      "score": 0.92
    }
  ],
  "result_count": 1,
  "credits_used": 50,
  "remaining_credits": 99
}

[ 03 · limits ]

Rate limits

Throttling is per API key, sliding 60-second window. Hit the limit and you get a clean 429 with a Retry-After header.

request rate

60req/min

Per API key, per endpoint. Sliding 60-second window.

concurrency

3concurrent

Max simultaneous in-flight requests per API key.

response headers

X-RateLimit-LimitMaximum requests allowed per minute

X-RateLimit-RemainingRequests remaining in the current window

X-RateLimit-ResetSeconds until the current window resets

Retry-AfterSeconds to wait before retrying (only on 429)

● 429 · too many requests

HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 60
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

{
  "error": "rate_limit_exceeded",
  "message": "Rate limit exceeded: 60 requests/minute per API key. Retry after 12s.",
  "retry_after": 12
}

[ faq ]

Preguntas frecuentes

¿Por qué cuesta 50 créditos por llamada?

Estos seis conjuntos de datos gubernamentales e institucionales se agregan y mantienen en índice, así que el endpoint cuesta 50 créditos (≈ $0.05 por llamada), muy por debajo de las terminales de datos macro dedicadas.

¿Qué fuentes cubre?

FRED de la Reserva Federal de EE. UU., la Oficina de Estadísticas Laborales (BLS), indicadores de desarrollo del Banco Mundial, indicadores macro y financieros del FMI, gasto federal de EE. UU. (USAspending) y estadísticas laborales alemanas (Destatis). Todos se consultan en paralelo.

¿Puedo buscar una serie específica?

Sí. Pasa el nombre de una serie o una consulta en lenguaje natural como «tasa de desempleo de EE. UU. 2024» o «PIB per cápita del Banco Mundial para India» y el endpoint ordena los registros más relevantes.

¿Filtrado por fecha?

Sí. Pasa start_date y end_date en formato YYYY-MM-DD para acotar a una ventana concreta.

¿Esquema de herramienta para OpenAI / Claude?

GET /api/search/economic/tool-schema devuelve definiciones listas para pegar de función de OpenAI y de uso de herramientas de Claude.