[ search · endpoint ]API de búsqueda · Finanzas

API de búsqueda del calendario de resultados

Consulta en el calendario de resultados de EE. UU. las fechas próximas y recientes de informes, las estimaciones de EPS e ingresos y el momento de publicación (antes o después del mercado) desde un solo endpoint. JSON preformateado para trading dirigido por eventos e investigación financiera con IA.

120 créditos / llamada30 req / minPOST /api/search/earnings-calendar

¿Qué es API de búsqueda del calendario de resultados?

Búsqueda semántica en el calendario de resultados de EE. UU. Devuelve eventos de informes ordenados con estimaciones y momento de publicación, listos para LLMs.

Datos clave
Endpoint
POST /api/search/earnings-calendar
Autenticación
Clave de API · cabecera x-api-key
Coste
120 créditos / llamada
Límite de tasa
30 req / min
Respuesta
JSON estructurado
[ 01 · live ]

Prueba la búsqueda del calendario de resultados en vivo

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

auth · x-api-key

¿No tienes una clave API?

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

5 consultas de ejemplo — haz clic para cargar
[ 02 · integrate ]

Guía de integración

Copia un fragmento, sustituye tu clave de API y ejecútalo. Funciona en cualquier cliente HTTP — ejemplos abajo en cURL, JavaScript y Python.

spec
POST/api/search/earnings-calendar
base
https://www.apipick.com

Búsqueda semántica en el calendario de resultados de EE. UU. Devuelve eventos de informes ordenados con estimaciones y momento de publicación, listos para LLMs.

parámetros
querystringobligatorio

Natural-language search query

max_num_resultsintegeropcional

1–5, default 5

relevance_thresholdnumberopcional

0.0–1.0 quality filter

country_codestringopcional

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

start_datestringopcional

ISO date YYYY-MM-DD

end_datestringopcional

ISO date YYYY-MM-DD

curl -X POST "https://www.apipick.com/api/search/earnings-calendar" \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "query": "Nvidia upcoming earnings date",
  "max_num_results": 5,
  "country_code": "US",
  "start_date": "2026-01-01"
}'
● 200 · respuesta
{
  "query": "Nvidia upcoming earnings date",
  "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": 120,
  "remaining_credits": 99
}
[ 03 · limits ]

Límites de tasa

La limitación es por clave de API, ventana deslizante de 60 segundos. Al alcanzar el límite recibes un 429 limpio con una cabecera Retry-After.

tasa de peticiones

30req/min

Por clave de API, por endpoint. Ventana deslizante de 60 segundos.

concurrencia

3concurrent

Máximo de peticiones simultáneas en curso por clave de API.

cabeceras de respuesta
X-RateLimit-LimitMáximo de peticiones permitidas por minuto
X-RateLimit-RemainingPeticiones restantes en la ventana actual
X-RateLimit-ResetSegundos hasta que se reinicia la ventana actual
Retry-AfterSegundos a esperar antes de reintentar (solo en 429)
● 429 · demasiadas peticiones
HTTP/1.1 429 Too Many Requests
Retry-After: 12
X-RateLimit-Limit: 30
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12

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

Preguntas frecuentes

01

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

Los datos del calendario de resultados son propietarios, estructurados y se actualizan continuamente, y el proveedor origen los cobra con un recargo; a 120 créditos (≈ $0.12 por llamada) se mantiene muy por debajo de las terminales de datos de mercado dedicadas.

02

¿Qué devuelve?

Fechas de informes trimestrales próximos y recientes, estimaciones de EPS e ingresos y el momento de publicación (antes o después del mercado) de empresas cotizadas en EE. UU., ordenados por relevancia respecto a tu consulta.

03

¿En qué se diferencia de la búsqueda en la SEC?

La búsqueda en la SEC recupera informes y transcripciones históricas; el calendario de resultados es prospectivo: te indica cuándo se espera que una empresa presente resultados y qué anticipa el mercado.

04

¿Filtrado por fecha?

Sí. Pasa start_date y end_date en formato YYYY-MM-DD para acotar los resultados a una ventana de publicación concreta.

05

¿Esquema de herramienta para OpenAI / Claude?

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

[ explore ]

Explora otras APIs de búsqueda

Búsqueda web

Búsqueda web semántica en tiempo real para tool calling de LLM. Devuelve títulos, URLs y snippets limpios y rankeados, preformateados para consumo de agentes. Admite filtros por país y fecha.

Búsqueda de noticias

Búsqueda de noticias en tiempo real en los principales medios. Filtros por rango de fechas y país para consultas urgentes. Para resúmenes matinales, agentes de noticias del mercado y pipelines RAG.

Extracción de contenido URL

Extrae contenido limpio y legible de hasta 25 URLs por llamada. Elimina anuncios, navegación y elementos accesorios; devuelve texto en estilo markdown listo para LLM. 2 créditos por URL.

Búsqueda académica

Busca artículos revisados por pares y pre-prints en arXiv, PubMed, bioRxiv y medRxiv desde un solo endpoint. Para revisión bibliográfica con IA, RAG sobre corpus científicos y extracción de citas.

Búsqueda clínica

Busca ensayos clínicos, fichas técnicas de la FDA y bioactividad de ChEMBL. Para investigación médica, reposicionamiento de fármacos y soporte de decisiones clínicas con IA.

Búsqueda en SEC

Busca registros SEC (10-K, 10-Q, 8-K), transcripciones de earnings calls de EE.UU. y estadísticas de equity. Para due diligence, análisis fundamental y pipelines RAG financieros impulsados por IA.

Búsqueda de patentes

Búsqueda semántica de patentes globales: USPTO, EPO, WIPO y oficinas nacionales principales. Para investigación de prior art, panorámica de PI e inteligencia competitiva impulsada por IA.

Mercados de predicción

Busca contratos de Polymarket y Kalshi sobre política, economía, deportes y actualidad. Para recuperar pronósticos de masa y anclar probabilidades en respuestas de LLM.

Búsqueda legal Reino Unido

Búsqueda semántica en jurisprudencia y legislación primaria del Reino Unido desde un solo endpoint. Para investigación legal, revisión de cumplimiento e interpretación legal con IA.

Búsqueda de Ciberseguridad

Busca vulnerabilidades explotadas conocidas de CISA (KEV), registros CVE del NVD, puntuaciones de explotación EPSS y técnicas de MITRE ATT&CK. Para triaje de vulnerabilidades, inteligencia de amenazas y operaciones de seguridad con IA.

Búsqueda de Mercados

Busca renta variable global y de EE. UU., cripto, forex, ETFs, fondos, materias primas y movers de EE. UU. Para consultas de precios, datos de mercado y análisis de trading con IA.

Búsqueda de Datos Económicos

Busca 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. Para investigación macroeconómica con IA.

Búsqueda de Finanzas

Busca balances, cuentas de resultados, estados de flujo de caja, dividendos y transacciones de insiders de empresas cotizadas de EE. UU. Para análisis fundamental y due diligence con IA.

Búsqueda de Química

Busca bioactividad de ChEMBL, estructuras químicas de PubChem y asociaciones diana-enfermedad de Open Targets. Para descubrimiento de fármacos, quimioinformática e investigación biomédica con IA.

Búsqueda de genes y variantes genómicas

Busca genes, variantes y significado clínico en NCBI Gene, dbSNP, ClinVar, dbVar, MedGen y GTR. Para investigación en genómica e interpretación de variantes con IA.

Búsqueda de secuencias genómicas

Busca secuencias, ensamblajes y dominios proteicos en NCBI Nucleotide, Protein, Genome, Assembly, CDD y Structure. Para bioinformática con IA.

Búsqueda de conjuntos de datos genómicos

Busca ejecuciones de secuenciación, conjuntos de datos de expresión y datos de organismos en NCBI SRA, GEO, BioSample, BioProject, dbGaP y Taxonomy. Para el descubrimiento de datos ómicos con IA.

Búsqueda de Datos de Salud

Busca estadísticas de salud de la OMS, subvenciones de investigación de los NIH e informes de eventos adversos de medicamentos de openFDA. Para investigación de salud pública y farmacovigilancia con IA.

Búsqueda de Política

Busca debates del Parlamento del Reino Unido, preguntas escritas y actividad de los diputados (Hansard). Para herramientas cívicas, seguimiento legislativo e investigación de políticas con IA.

Búsqueda Wiley Finance

Busca revistas y libros de finanzas con licencia de Wiley. Para investigación financiera de nivel académico, revisión de literatura y análisis de inversiones con IA.