Felo API PlatformFelo API Platform
Všechny endpointy Tavily
v0.2.0-beta
OpenAPI 3.1.0

Nástroj pro procházení webu založený na grafu, využívající Tavily Crawl.

Felo API Support
MIT
Server:https://openapi.felo.ai
Klientské knihovny
Shell Curl

Web Content

​

Web crawling, URL discovery and page extraction.

Web Content Operace

Nástroj pro procházení webu založený na grafu, využívající Tavily Crawl.

​

Prochází web od kořenového url a vrací obsah nalezených stránek. Řiďte jej instructions v přirozeném jazyce a filtry cest a domén založenými na regulárních výrazech, rozsah ohraničte pomocí max_depth, max_breadth a limit. Vrací base_url a results[] s url a raw_content. Použijte jej pro široké pokrytí jednoho webu — dokumentace, katalogu, blogu konkurenta. Odpovídá synchronně, což post_firecrawl_crawl nedělá: ten běží jako úloha na pozadí a hodí se pro procházení příliš velká na čekání.

Cenová reference

  • Účtování: měřené jednotky odpovědi.
  • Referenční odhad požadavku: USD 0.024.
  • Základ jednotkových nákladů: USD 0.008.
  • Jednotka prostředku: tavily_credit.
  • Referenční multiplikátor zákazníka: 1.0. Neaplikujte jej znovu na zúčtovanou částku zákazníka.
  • Nákladové základny neurčují konečnou cenu pro zákazníka, a to ani když jsou nulové.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Tělo
povinné
application/json
  • url
    Typ: string
    povinné

    Kořenová adresa URL, od které procházení začíná.

  • allow_external
    Typ: boolean

    Zahrnout do konečného seznamu výsledků odkazy na externí domény.

  • chunks_per_source
    Typ: integer
    min:  
    1
    max:  
    5

    Maximální počet relevantních částí vrácených na zdroj.

  • exclude_domains
    Typ: array string[]

    Vzory regex pro vyloučení konkrétních domén nebo subdomén z procházení.

  • exclude_paths
    Typ: array string[]

    Vzory regex pro vyloučení adres URL s konkrétními vzory cest.

  • extract_depth
    Typ: string enum

    Hloubka procesu extrakce.

    hodnoty
    • basic
    • advanced
  • format
    Typ: string enum

    Formát extrahovaného obsahu webové stránky.

    hodnoty
    • markdown
    • text
  • include_favicon
    Typ: boolean

    Zahrnout adresu URL favikony pro každý výsledek.

  • include_images
    Typ: boolean

    Zahrnout obrázky do výsledků procházení.

  • include_usage
    Typ: boolean

    Zahrnout do odpovědi informace o spotřebě kreditů.

  • instructions
    Typ: string

    Pokyny v přirozeném jazyce pro procházející nástroj.

  • limit
    Typ: integer
    min:  
    1

    Celkový počet odkazů, které nástroj zpracuje, než se zastaví.

  • max_breadth
    Typ: integer
    min:  
    1
    max:  
    500

    Maximální počet odkazů k následování na každé úrovni stromu.

  • max_depth
    Typ: integer
    min:  
    1
    max:  
    5

    Maximální hloubka procházení.

  • select_domains
    Typ: array string[]

    Vzory regex pro omezení procházení na konkrétní domény nebo subdomény.

  • select_paths
    Typ: array string[]

    Vzory regex pro výběr pouze adres URL s konkrétními vzory cest.

  • timeout
    Typ: number Formát: float
    min:  
    10
    max:  
    150

    Maximální doba čekání na operaci procházení v sekundách.

Odpovědi
  • 200
    Typ: object

    Výsledky procházení byly úspěšně vráceny.

    • base_url
      Typ: string

      Základní adresa URL, která byla procházena.

    • request_id
      Typ: string

      Jedinečný identifikátor požadavku.

    • response_time
      Typ: number Formát: float

      Doba v sekundách, za kterou byl požadavek dokončen.

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

        Adresa URL favikony procházené stránky.

      • raw_content
        Typ: string

        Extrahovaný surový obsah ze stránky.

      • url
        Typ: string

        Adresa URL procházené stránky.

    • usage
      Typ: object
      • credits
        Typ: integer

        Podrobnosti o spotřebě kreditů pro požadavek.

    application/json
  • 400

    Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.

  • 401

    Je vyžadován platný API klíč Felo.

  • 402

    V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.

  • 403

    Účet nemá oprávnění tuto operaci provést.

  • 429

    Byl dosažen limit požadavků nebo útraty.

  • 502

    Služba nemohla požadavek dokončit.

  • 503

    API nebo fakturační služba je dočasně nedostupná.

  • 504

    Při zpracování požadavku vypršel časový limit služby.

  • default

    Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

    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"
}

Výsledky procházení byly úspěšně vráceny.

Graph-based website traversal tool using Tavily Crawl.