Web Search
Search public web content with Tavily.
Ricerca Tavily
Cerca sul web e restituisce risultati classificati con titoli, URL e frammenti di contenuto. query è obbligatorio. Usa max_results per controllare il numero di risultati e search_depth per selezionare la modalità di ricerca. Risposta aggiuntiva, immagini e contenuto grezzo vengono restituiti solo su richiesta. Imposta include_usage per ricevere informazioni sull'utilizzo delle risorse; usage.credits non è un addebito Felo.
Riferimento prezzi
- Misurazione: unità di risposta misurate.
- Stima di riferimento per richiesta: USD 0.016.
- Base di costo unitario: USD 0.008.
- Unità di risorsa:
tavily_credit. - Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.
- Le basi di costo non determinano il prezzo finale per il cliente, anche quando sono zero.
Solo metadati di riferimento, non un preventivo dell'account né un prezzo o un limite di spesa garantito. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.
- Tipo: stringqueryobbligatorio
La query di ricerca da eseguire con Tavily.
- Tipo: booleanauto
_parameters Configura automaticamente i parametri di ricerca in base al contenuto della query.
- Tipo: integerchunks
_per _source min:1max:3Numero massimo di chunk rilevanti restituiti per fonte.
- Tipo: string enumcountry
Dai priorità ai risultati di ricerca da un paese specifico. Disponibile solo quando topic è general.
valori- afghanistan
- albania
- algeria
- andorra
- angola
- Tipo: string Formato: dateend
_date Restituisce i risultati precedenti alla data di fine specificata.
- Tipo: array string[] …150exclude
_domains Elenco di domini da escludere esplicitamente dai risultati di ricerca.
- include
_answer Includi una risposta generata da un LLM. true usa la modalità di risposta predefinita; basic o advanced seleziona la modalità di generazione della risposta.
- Tipo: boolean
Includi una risposta generata da un LLM. true usa la modalità di risposta predefinita; basic o advanced seleziona la modalità di generazione della risposta.
- Tipo: array string[] …300include
_domains Elenco di domini da includere esplicitamente nei risultati di ricerca.
- Tipo: booleaninclude
_favicon Includi l'URL del favicon per ogni risultato.
- Tipo: booleaninclude
_image _descriptions Aggiungi un testo descrittivo per ogni immagine quando include_images è true.
- Tipo: booleaninclude
_images Esegui una ricerca di immagini e includi i risultati.
- include
_raw _content Includi contenuto pulito e analizzato per ogni risultato di ricerca. true o markdown restituisce markdown; text restituisce testo semplice e può aumentare la latenza.
- Tipo: boolean
Includi contenuto pulito e analizzato per ogni risultato di ricerca. true o markdown restituisce markdown; text restituisce testo semplice e può aumentare la latenza.
- Tipo: booleaninclude
_usage Includi le informazioni sull'utilizzo delle risorse nella risposta. Non sono informazioni di fatturazione Felo.
- Tipo: integermax
_results min:0max:20Numero massimo di risultati di ricerca da restituire.
- Tipo: booleansafe
_search Filtra i contenuti per adulti o non sicuri dai risultati di ricerca. Solo Enterprise; non supportato quando search_depth è fast o ultra-fast.
- Tipo: string enumsearch
_depth Controlla il compromesso tra latenza e rilevanza. advanced offre la massima rilevanza con latenza e costi più elevati; basic è equilibrato; fast e ultra-fast ottimizzano per una latenza inferiore.
valori- advanced
- basic
- fast
- ultra
-fast
- Tipo: string Formato: datestart
_date Restituisce i risultati successivi alla data di inizio specificata.
- Tipo: string enumtime
_range Intervallo di tempo per filtrare i risultati in base alla data di pubblicazione.
valori- day
- week
- month
- year
- d
- w
- m
- y
- Tipo: string enumtopic
Categoria della ricerca.
valori- general
- news
- finance
- Tipo: object200
Risultati della ricerca restituiti correttamente.
- Tipo: string | nullanswer
Una breve risposta generata da un LLM. È null quando include_answer è false o non viene generata alcuna risposta.
- Tipo: array object[]images
- descriptionTipo: string
Descrizione dell'immagine.
- urlTipo: string
URL dell'immagine.
- Tipo: stringquery
La query di ricerca eseguita.
- Tipo: stringrequest
_id Identificatore univoco della richiesta.
- Tipo: number Formato: floatresponse
_time Tempo in secondi impiegato per completare la richiesta.
- Tipo: array object[]results
- contentTipo: string
Snippet del contenuto del risultato di ricerca.
- faviconTipo: string | null
URL del favicon del risultato di ricerca.
- rawTipo: string | null
_content Contenuto di origine pulito e analizzato. Null, a meno che include_raw_content non sia richiesto o non sia disponibile contenuto grezzo.
- scoreTipo: number Formato: float
Punteggio di rilevanza del risultato di ricerca.
- titleTipo: string
Titolo del risultato di ricerca.
- urlTipo: string
URL del risultato di ricerca.
- Tipo: objectusage
- creditsTipo: integer
Unità di risorsa consumate da questa richiesta, non USD né crediti Felo.
application/json - 400
Impossibile elaborare la richiesta. Controlla i parametri della richiesta.
- 401
È richiesta una chiave API Felo valida.
- 402
Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.
- 403
L'account non è autorizzato a eseguire questa operazione.
- 429
È stato raggiunto un limite di richieste o di spesa.
- 502
Il servizio non è riuscito a completare la richiesta.
- 503
L'API o il servizio di fatturazione è temporaneamente non disponibile.
- 504
Si è verificato un timeout durante l'elaborazione della richiesta.
- default
Risposta di errore; le risposte passthrough upstream possono usare formati del provider
application/json
curl --request POST https://openapi.felo.ai/v1/beta/tavily/search \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"query": "Python official documentation", "search_depth": "basic", "max_results": 2, "include_usage": true}'
{
"query": "Python official documentation",
"answer": null,
"images": [],
"results": [
{
"title": "Python Documentation",
"url": "https://docs.python.org/3/",
"content": "Documentation for the Python programming language.",
"score": 0.98,
"raw_content": null
}
],
"response_time": 1.2,
"usage": {
"credits": 1
},
"request_id": "example-search-request"
}