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

Generujte komplexní mapy webu pomocí Tavily Map.

Server:https://openapi.felo.ai
Klientské knihovny

Web Content

​

Web crawling, URL discovery and page extraction.

Web Content Operace

Generujte komplexní mapy webu pomocí Tavily Map.

​

Vypíše URL webu z kořenového url bez načítání obsahu stránek. Řiďte jej instructions v přirozeném jazyce a filtry select_paths / exclude_paths / select_domains založenými na regulárních výrazech. Vrací base_url a results — ploché pole řetězců URL, nikoli objekty — spolu s response_time a request_id. Použijte jej k odhadu velikosti webu před zahájením procházení a poté načtěte jen důležité části pomocí extractWebContent. Pokud chcete obsah, nikoli strukturu, post_tavily_crawl zvládne obojí v jednom volání.

Cenová reference

  • Účtování: měřené jednotky odpovědi.
  • Referenční odhad požadavku: USD 0.064.
  • 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é mapování začíná.

  • allow_external
    Typ: boolean

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

  • exclude_domains
    Typ: array string[]

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

  • exclude_paths
    Typ: array string[]

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

  • 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 mapování.

  • 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 mapování v sekundách.

Odpovědi
  • 200
    Typ: object

    Výsledky mapy byly úspěšně vráceny.

    • base_url
      Typ: string

      Základní adresa URL, která byla zmapována.

    • 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 string[]
    • 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/map
curl https://openapi.felo.ai/v1/beta/tavily/map \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "url": "docs.tavily.com",
  "instructions": "",
  "max_depth": 1,
  "max_breadth": 20,
  "limit": 50,
  "select_paths": [
    ""
  ],
  "select_domains": [
    ""
  ],
  "exclude_paths": [
    ""
  ],
  "exclude_domains": [
    ""
  ],
  "allow_external": true,
  "timeout": 150,
  "include_usage": false
}'
{
  "base_url": "string",
  "results": [
    "string"
  ],
  "response_time": 1,
  "usage": {
    "credits": 1
  },
  "request_id": "string"
}
Generate comprehensive site maps using Tavily Map.