API di ricerca calendario delle trimestrali
Interroga il calendario delle trimestrali USA per le date dei report imminenti e recenti, le stime di EPS e ricavi e la tempistica pre/post mercato da un unico endpoint. JSON già formattato per il trading event-driven e la ricerca finanziaria guidata dall'IA.
Cos'è API di ricerca calendario delle trimestrali?
Ricerca semantica sul calendario delle trimestrali USA. Restituisce eventi di report classificati con stime e tempistiche, pronti per gli LLM a valle.
- Endpoint
- POST /api/search/earnings-calendar
- Autenticazione
- API key · header x-api-key
- Costo
- 120 crediti / chiamata
- Limite di frequenza
- 30 req / min
- Risposta
- JSON strutturato
Prova dal vivo la ricerca nel calendario delle trimestrali
Inserisci la tua API key ed esegui una query reale contro l'endpoint in produzione.
Non hai una API key?
Accedi al tuo account per creare e gestire le tue API key.
Guida all'integrazione
Copia uno snippet, sostituisci la tua API key, esegui. Funziona con qualsiasi client HTTP — esempi qui sotto in cURL, JavaScript e Python.
/api/search/earnings-calendarhttps://www.apipick.comRicerca semantica sul calendario delle trimestrali USA. Restituisce eventi di report classificati con stime e tempistiche, pronti per gli LLM a valle.
querystringobbligatorioNatural-language search query
max_num_resultsintegerfacoltativo1–5, default 5
relevance_thresholdnumberfacoltativo0.0–1.0 quality filter
country_codestringfacoltativoISO country code (e.g. US, GB)
start_datestringfacoltativoISO date YYYY-MM-DD
end_datestringfacoltativoISO 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"
}'{
"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
}Limiti di frequenza
Il throttling è per API key, con finestra mobile di 60 secondi. Al raggiungimento del limite ricevi un 429 pulito con header Retry-After.
30req/min
Per API key e per endpoint. Finestra mobile di 60 secondi.
3concurrent
Numero massimo di richieste simultanee in corso per API key.
X-RateLimit-LimitNumero massimo di richieste consentite al minutoX-RateLimit-RemainingRichieste rimanenti nella finestra correnteX-RateLimit-ResetSecondi al reset della finestra correnteRetry-AfterSecondi da attendere prima di riprovare (solo in caso di 429)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
}Domande frequenti
Perché costa 120 crediti per chiamata?
I dati del calendario delle trimestrali sono proprietari, strutturati e aggiornati di continuo, prezzati a premio dal fornitore upstream; a 120 crediti (≈ $0,12 per chiamata) restano ben al di sotto dei terminali dedicati per dati di mercato.
Cosa restituisce?
Date dei report trimestrali imminenti e recenti, stime di EPS e ricavi e orario di pubblicazione (prima o dopo il mercato) per le società quotate negli USA, classificate per pertinenza rispetto alla tua query.
In cosa si differenzia dalla ricerca SEC?
La ricerca SEC recupera documenti e trascrizioni storiche; il calendario delle trimestrali guarda al futuro — ti dice quando una società dovrebbe pubblicare i risultati e cosa si aspetta il mercato.
Filtro per date?
Sì. Passa start_date e end_date nel formato YYYY-MM-DD per delimitare i risultati a una specifica finestra di pubblicazione.
Schema tool per OpenAI / Claude?
GET /api/search/earnings-calendar/tool-schema restituisce definizioni pronte da incollare per il function calling di OpenAI e il tool use di Claude.
Esplora altre API di ricerca
Ricerca web semantica in tempo reale per il tool calling degli LLM. Restituisce titoli, URL e snippet puliti e classificati, già formattati per il consumo da parte degli agenti. Supporta filtri per paese e data.
Ricerca notizie in tempo reale tra le principali testate. Filtri per intervallo di date e paese per query urgenti. Costruita per briefing mattutini, agenti di notizie di mercato e pipeline RAG.
Fai una domanda mirata e ottieni una risposta breve con citazioni numerate, ricercata dal vivo su web, notizie e dataset specialistici. Una sola chiamata, nessuna pipeline RAG da costruire.
Cerca le notizie d'agenzia di Associated Press con il testo integrale dell'articolo, non snippet, su una finestra mobile di 30 giorni. Costruita per agenti su attualità e ultime notizie.
Ricerca su dataset specialistici che la ricerca web non raggiunge: richiami di veicoli e indagini sui difetti della NHTSA, report di short seller attivisti e liste pubbliche di sanzioni. Avvia un task e interrogalo fino a ottenere una risposta con citazioni.
Estrai contenuti puliti e leggibili da un massimo di 25 URL per chiamata. Rimuove pubblicità, navigazione e testo accessorio; restituisce testo in stile markdown pronto per l'ingestione da parte degli LLM. 2 crediti per URL.
Cerca articoli sottoposti a revisione paritaria e pre-print su arXiv, PubMed, bioRxiv e medRxiv da un unico endpoint. Costruita per la revisione della letteratura con IA, il RAG su corpus scientifici e l'estrazione delle citazioni.
Cerca studi clinici, foglietti illustrativi FDA e bioattività ChEMBL. Costruita per la ricerca medica, il riposizionamento dei farmaci e il supporto alle decisioni cliniche con IA.
Cerca documenti SEC (10-K, 10-Q, 8-K), trascrizioni di earnings call USA e statistiche azionarie. Costruita per la due diligence, l'analisi fondamentale e le pipeline RAG finanziarie guidate dall'IA.
Ricerca semantica su brevetti globali: USPTO, EPO, WIPO e principali uffici nazionali. Costruita per la ricerca di prior art, la mappatura della PI e l'intelligence competitiva guidata dall'IA.
Cerca contratti di Polymarket e Kalshi su politica, economia, sport e attualità. Costruita per recuperare previsioni collettive e fondare le probabilità nelle risposte degli LLM.
Ricerca semantica nella giurisprudenza e nella legislazione primaria del Regno Unito da un unico endpoint. Costruita per la ricerca legale, la revisione di conformità e l'interpretazione normativa con IA.
Cerca vulnerabilità note sfruttate di CISA (KEV), record CVE dell'NVD, punteggi di sfruttamento EPSS e tecniche MITRE ATT&CK. Costruita per il triage delle vulnerabilità, la threat intelligence e le operazioni di sicurezza con IA.
Cerca azioni globali e USA, cripto, forex, ETF, fondi, materie prime e i titoli più movimentati negli USA. Costruita per la consultazione dei prezzi, il recupero di dati di mercato e la ricerca di trading con IA.
Cerca FRED, l'Ufficio di Statistica del Lavoro USA, gli indicatori della Banca Mondiale, i dati macro dell'FMI, la spesa federale USA e le statistiche del lavoro tedesche. Costruita per la ricerca macroeconomica con IA.
Cerca stati patrimoniali, conti economici, rendiconti finanziari, dividendi e operazioni degli insider di società quotate USA. Costruita per l'analisi fondamentale e la due diligence con IA.
Cerca la bioattività di ChEMBL, le strutture chimiche di PubChem e le associazioni bersaglio-malattia di Open Targets. Costruita per la scoperta di farmaci, la chemioinformatica e la ricerca biomedica con IA.
Cerca le statistiche sanitarie globali dell'OMS, i finanziamenti alla ricerca dei NIH, le segnalazioni di eventi avversi dei farmaci di openFDA e i richiami di farmaci e dispositivi della FDA. Costruita per la ricerca di sanità pubblica e la farmacovigilanza con IA.
Cerca i dibattiti del Parlamento del Regno Unito, le interrogazioni scritte e l'attività dei membri (Hansard). Costruita per strumenti di civic-tech, il monitoraggio legislativo e la ricerca sulle politiche con IA.
Cerca nel corpus normativo cripto MiCA dell'UE: il regolamento, le norme tecniche di livello 2, gli orientamenti di ESMA ed EBA e le leggi nazionali di tutti i 27 Stati membri.
Cerca riviste e libri di finanza Wiley su licenza. Costruita per la ricerca finanziaria di livello accademico, la revisione della letteratura e l'analisi degli investimenti con IA.