Felo API PlatformFelo API Platform
Wszystkie endpointy Tavily
v0.2.0-beta
OpenAPI 3.1.0

Narzędzie do przechodzenia po witrynie oparte na grafie, wykorzystujące Tavily Crawl.

Felo API Support
MIT
Serwer:https://openapi.felo.ai
Biblioteki klienckie
Shell Curl

Web Content

​

Web crawling, URL discovery and page extraction.

Web Content Operacje

Narzędzie do przechodzenia po witrynie oparte na grafie, wykorzystujące Tavily Crawl.

​

Przechodzi witrynę od głównego url i zwraca treść znalezionych stron. Steruj nim za pomocą instructions w języku naturalnym oraz filtrów ścieżek i domen opartych na wyrażeniach regularnych, a ograniczaj go przez max_depth, max_breadth i limit. Zwraca base_url oraz results[] z url i raw_content. Używaj go do szerokiego pokrycia jednej witryny — dokumentacji, katalogu, bloga konkurenta. Odpowiada synchronicznie, czego nie robi post_firecrawl_crawl: ten działa jako zadanie w tle i nadaje się do indeksowań zbyt dużych, by na nie czekać.

Cennik referencyjny

  • Rozliczanie: naliczone jednostki odpowiedzi.
  • Szacunek referencyjny dla żądania: USD 0.024.
  • Podstawa kosztu jednostkowego: USD 0.008.
  • Jednostka zasobu: tavily_credit.
  • Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.
  • Podstawy kosztu nie ustalają ostatecznej ceny dla klienta, również gdy wynoszą zero.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Treść
wymagane
application/json
  • url
    Typ: string
    wymagane

    Główny adres URL, od którego rozpoczyna się skanowanie.

  • allow_external
    Typ: boolean

    Uwzględnij w końcowej liście wyników linki do zewnętrznych domen.

  • chunks_per_source
    Typ: integer
    min.:  
    1
    maks.:  
    5

    Maksymalna liczba odpowiednich fragmentów zwracanych na źródło.

  • exclude_domains
    Typ: array string[]

    Wzorce regex wykluczające określone domeny lub subdomeny ze skanowania.

  • exclude_paths
    Typ: array string[]

    Wzorce regex wykluczające adresy URL o określonych wzorcach ścieżek.

  • extract_depth
    Typ: string enum

    Głębokość procesu ekstrakcji.

    wartości
    • basic
    • advanced
  • format
    Typ: string enum

    Format wyodrębnionej treści strony internetowej.

    wartości
    • markdown
    • text
  • include_favicon
    Typ: boolean

    Uwzględnij adres URL favikony dla każdego wyniku.

  • include_images
    Typ: boolean

    Uwzględnij obrazy w wynikach skanowania.

  • include_usage
    Typ: boolean

    Uwzględnij informacje o zużyciu kredytów w odpowiedzi.

  • instructions
    Typ: string

    Instrukcje w języku naturalnym dla skanera.

  • limit
    Typ: integer
    min.:  
    1

    Łączna liczba linków, które skaner przetworzy przed zatrzymaniem.

  • max_breadth
    Typ: integer
    min.:  
    1
    maks.:  
    500

    Maksymalna liczba linków do odwiedzenia na każdym poziomie drzewa.

  • max_depth
    Typ: integer
    min.:  
    1
    maks.:  
    5

    Maksymalna głębokość skanowania.

  • select_domains
    Typ: array string[]

    Wzorce regex ograniczające skanowanie do określonych domen lub subdomen.

  • select_paths
    Typ: array string[]

    Wzorce regex wybierające tylko adresy URL o określonych wzorcach ścieżek.

  • timeout
    Typ: number Format: float
    min.:  
    10
    maks.:  
    150

    Maksymalny czas oczekiwania na operację skanowania w sekundach.

Odpowiedzi
  • 200
    Typ: object

    Wyniki indeksowania zwrócone pomyślnie.

    • base_url
      Typ: string

      Bazowy adres URL, który został przeskanowany.

    • request_id
      Typ: string

      Unikalny identyfikator żądania.

    • response_time
      Typ: number Format: float

      Czas w sekundach potrzebny na ukończenie żądania.

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

        Adres URL favikony przeskanowanej strony.

      • raw_content
        Typ: string

        Wyodrębniona surowa treść ze strony.

      • url
        Typ: string

        Adres URL przeskanowanej strony.

    • usage
      Typ: object
      • credits
        Typ: integer

        Szczegóły zużycia kredytów dla żądania.

    application/json
  • 400

    Nie można przetworzyć żądania. Sprawdź parametry żądania.

  • 401

    Wymagany jest prawidłowy klucz API Felo.

  • 402

    Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.

  • 403

    Konto nie ma uprawnień do wykonania tej operacji.

  • 429

    Osiągnięto limit żądań lub wydatków.

  • 502

    Usługa nie mogła ukończyć żądania.

  • 503

    API lub usługa rozliczeniowa jest tymczasowo niedostępna.

  • 504

    Upłynął limit czasu usługi podczas przetwarzania żądania.

  • default

    Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

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

Wyniki indeksowania zwrócone pomyślnie.

Graph-based website traversal tool using Tavily Crawl.