Web Content
Web crawling, URL discovery and page extraction.
Estrazione Tavily
Estrae contenuti leggibili da un URL o da un array di URL. Seleziona testo o Markdown con format. Controlla sia results sia failed_results: un URL non riuscito può essere segnalato in una risposta HTTP altrimenti riuscita. 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.024.
- 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.
- urlsobbligatorio
L'URL o gli URL da cui estrarre il contenuto. Sono accettati sia una singola stringa URL sia un array di stringhe URL.
- Tipo: string
L'URL o gli URL da cui estrarre il contenuto. Sono accettati sia una singola stringa URL sia un array di stringhe URL.
- Tipo: integerchunks
_per _source min:1max:5Numero massimo di chunk rilevanti restituiti per fonte. Disponibile solo quando query è fornito.
- Tipo: string enumextract
_depth Profondità del processo di estrazione.
valori- basic
- advanced
- Tipo: string enumformat
Formato del contenuto della pagina web estratto.
valori- markdown
- text
- Tipo: booleaninclude
_favicon Includi l'URL del favicon per ogni risultato.
- Tipo: booleaninclude
_images Includi un elenco di immagini estratte dagli URL.
- Tipo: booleaninclude
_usage Includi le informazioni sull'utilizzo delle risorse nella risposta. Non sono informazioni di fatturazione Felo.
- Tipo: stringquery
Intento dell'utente per il reranking dei chunk di contenuto estratti.
- Tipo: number Formato: floattimeoutmin:1max:60
Tempo massimo in secondi di attesa per l'estrazione dell'URL. Se omesso, i timeout predefiniti dipendono da extract_depth: 10 secondi per basic e 30 secondi per advanced.
- Tipo: object200
Risultati di estrazione restituiti correttamente.
- Tipo: array string[]failed
_results Elenco degli URL che non è stato possibile elaborare.
- Tipo: stringrequest
_id Identificatore univoco della richiesta.
- Tipo: number Formato: floatresponse
_time Tempo in secondi impiegato per completare la richiesta.
- Tipo: array object[]results
- faviconTipo: string | null
URL del favicon del contenuto estratto.
- imagesTipo: array string[]
Immagini estratte dall'URL quando include_images è true.
- rawTipo: string
_content Contenuto grezzo estratto dall'URL.
- titleTipo: string
Titolo della pagina estratta.
- urlTipo: string
URL del contenuto estratto.
- 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/extract \
--header "Authorization: Bearer ${FELO_API_KEY:?Set FELO_API_KEY}" \
--header 'Content-Type: application/json' \
--data '{"urls": ["https://example.com"], "extract_depth": "basic", "format": "text", "include_usage": true}'
{
"results": [
{
"url": "https://example.com",
"title": "Example Domain",
"raw_content": "This domain is for use in documentation examples.",
"images": []
}
],
"failed_results": [],
"response_time": 0.5,
"usage": {
"credits": 1
},
"request_id": "example-extract-request"
}