Felo API PlatformFelo API Platform
Tutti gli endpoint di Tavily
v0.2.0-beta
OpenAPI 3.1.0

Strumento basato su grafo per l'esplorazione di siti web con Tavily Crawl.

Server:https://openapi.felo.ai
Librerie client

Web Content

​

Web crawling, URL discovery and page extraction.

Web Content Operazioni

Strumento basato su grafo per l'esplorazione di siti web con Tavily Crawl.

​

Percorre un sito da un url radice e restituisce il contenuto delle pagine trovate. Guidalo con instructions in linguaggio naturale e filtri regex su percorsi e domini, e limitane l'estensione con max_depth, max_breadth e limit. Restituisce base_url e results[] con url e raw_content. Usalo per una copertura ampia di un singolo sito: documentazione, un catalogo, il blog di un concorrente. Risponde in modo sincrono, cosa che post_firecrawl_crawl non fa: quello viene eseguito come job in background ed è adatto a crawl troppo grandi per attendere.

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.

Corpo
obbligatorio
application/json
  • url
    Tipo: string
    obbligatorio

    L'URL radice da cui iniziare la scansione.

  • allow_external
    Tipo: boolean

    Includi i link a domini esterni nell'elenco finale dei risultati.

  • chunks_per_source
    Tipo: integer
    min:  
    1
    max:  
    5

    Numero massimo di chunk rilevanti restituiti per fonte.

  • exclude_domains
    Tipo: array string[]

    Pattern regex per escludere domini o sottodomini specifici dalla scansione.

  • exclude_paths
    Tipo: array string[]

    Pattern regex per escludere URL con specifici pattern di percorso.

  • extract_depth
    Tipo: string enum

    Profondità del processo di estrazione.

    valori
    • basic
    • advanced
  • format
    Tipo: string enum

    Formato del contenuto della pagina web estratto.

    valori
    • markdown
    • text
  • include_favicon
    Tipo: boolean

    Includi l'URL del favicon per ogni risultato.

  • include_images
    Tipo: boolean

    Includi le immagini nei risultati della scansione.

  • include_usage
    Tipo: boolean

    Includi le informazioni sull'utilizzo dei crediti nella risposta.

  • instructions
    Tipo: string

    Istruzioni in linguaggio naturale per il crawler.

  • limit
    Tipo: integer
    min:  
    1

    Numero totale di link che il crawler elaborerà prima di fermarsi.

  • max_breadth
    Tipo: integer
    min:  
    1
    max:  
    500

    Numero massimo di link da seguire per livello dell'albero.

  • max_depth
    Tipo: integer
    min:  
    1
    max:  
    5

    Profondità massima della scansione.

  • select_domains
    Tipo: array string[]

    Pattern regex per limitare la scansione a domini o sottodomini specifici.

  • select_paths
    Tipo: array string[]

    Pattern regex per selezionare solo URL con specifici pattern di percorso.

  • timeout
    Tipo: number Formato: float
    min:  
    10
    max:  
    150

    Tempo massimo in secondi di attesa per l'operazione di scansione.

Risposte
  • 200
    Tipo: object

    Risultati della scansione restituiti correttamente.

    • base_url
      Tipo: string

      L'URL di base sottoposto a scansione.

    • request_id
      Tipo: string

      Identificatore univoco della richiesta.

    • response_time
      Tipo: number Formato: float

      Tempo in secondi impiegato per completare la richiesta.

    • results
      Tipo: array object[]
      • favicon
        Tipo: string

        URL del favicon della pagina sottoposta a scansione.

      • raw_content
        Tipo: string

        Contenuto grezzo estratto dalla pagina.

      • url
        Tipo: string

        URL della pagina sottoposta a scansione.

    • usage
      Tipo: object
      • credits
        Tipo: integer

        Dettagli sull'utilizzo dei crediti per la richiesta.

    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
Request Example for post/v1/beta/tavily/crawl
curl https://openapi.felo.ai/v1/beta/tavily/crawl \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "url": "docs.tavily.com",
  "instructions": "",
  "chunks_per_source": 3,
  "max_depth": 1,
  "max_breadth": 20,
  "limit": 50,
  "select_paths": [
    ""
  ],
  "select_domains": [
    ""
  ],
  "exclude_paths": [
    ""
  ],
  "exclude_domains": [
    ""
  ],
  "allow_external": true,
  "include_images": false,
  "extract_depth": "basic",
  "format": "markdown",
  "include_favicon": false,
  "timeout": 150,
  "include_usage": false
}'
{
  "base_url": "string",
  "results": [
    {
      "url": "string",
      "raw_content": "string",
      "favicon": "string"
    }
  ],
  "response_time": 1,
  "usage": {
    "credits": 1
  },
  "request_id": "string"
}
Graph-based website traversal tool using Tavily Crawl.