API di ricerca su dataset
Fai una domanda su una raccolta di dataset specialistici e ricevi una risposta con citazioni. Questi dataset sono raggiungibili solo tramite una ricerca, quindi l'API è asincrona: avvia un task, poi interrogalo finché la risposta è pronta, di solito tra 15 secondi e 2,5 minuti.
Cos'è API di ricerca su dataset?
Avvia un task di ricerca limitato a una raccolta e restituisce un id del task. Interrogando il task ottieni lo stato e, a completamento, una risposta in Markdown con citazioni numerate e l'elenco delle fonti.
- Endpoint
- POST /api/research
- Autenticazione
- API key · header x-api-key
- Costo
- 100 crediti / chiamata
- Limite di frequenza
- 20 req / min
- Risposta
- JSON strutturato
Prova la ricerca su dataset dal vivo
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/researchhttps://www.apipick.comAvvia un task di ricerca limitato a una raccolta e restituisce un id del task. Interrogando il task ottieni lo stato e, a completamento, una risposta in Markdown con citazioni numerate e l'elenco delle fonti.
querystringobbligatorioThe research question (max 2000 characters)
collectionstringobbligatoriovehicle-safety | short-sellers | sanctions
curl -X POST "https://www.apipick.com/api/research" \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"query": "What recalls and NHTSA investigations exist for the 2021 Tesla Model Y?",
"collection": "vehicle-safety"
}'{
"query": "What recalls and NHTSA investigations exist for the 2021 Tesla Model Y?",
"answer": "**Summary:** … [[1]](https://example.com/source)",
"results": [
{
"title": "Example source",
"url": "https://example.com/source",
"snippet": "Short excerpt the answer cites…"
}
],
"result_count": 1,
"credits_used": 100,
"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.
20req/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: 20
X-RateLimit-Remaining: 0
X-RateLimit-Reset: 12
{
"error": "rate_limit_exceeded",
"message": "Rate limit exceeded: 20 requests/minute per API key. Retry after 12s.",
"retry_after": 12
}Domande frequenti
Perché è asincrona se Risposta con citazioni non lo è?
La ricerca su queste raccolte richiede più tempo, da 15 secondi a circa 2,5 minuti. POST /api/research restituisce subito un task_id; interroga GET /api/research/tasks/{task_id} ogni pochi secondi finché status non è completed.
Quali raccolte sono disponibili?
vehicle-safety copre i richiami NHTSA, i reclami dei proprietari, le indagini sui difetti e la decodifica del VIN. short-sellers copre i report di short seller attivisti e le lettere e i pitch dei fondi long. sanctions copre le liste SDN e consolidate dell'OFAC, l'ONU, l'HMT del Regno Unito, il DFAT australiano, la SECO svizzera, la Consolidated Screening List statunitense e le Red Notice dell'INTERPOL.
Quando mi viene addebitato?
Solo quando un task viene completato: la prima interrogazione che restituisce la risposta scala 100 crediti (≈ $0,10), e le interrogazioni successive dello stesso task sono gratuite. Interrogare un task in corso è gratis, e i task falliti non costano nulla.
Posso usare la raccolta sanzioni per lo screening di compliance?
No. È un supporto alla ricerca: le risposte possono non includere alcune iscrizioni e non sostituiscono un fornitore di screening né una verifica sulle liste ufficiali.
Schema tool per OpenAI / Claude?
GET /api/research/tool-schema restituisce definizioni pronte da incollare per il function calling di OpenAI e il tool use di Claude, più l'elenco delle raccolte.
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.
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 nel calendario delle trimestrali USA le date dei report imminenti, le stime di EPS/ricavi e la tempistica pre/post mercato. Costruita per il trading event-driven e la ricerca guidati dall'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.