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

Generuj kompleksowe mapy witryny za pomocą Tavily Map.

Serwer:https://openapi.felo.ai
Biblioteki klienckie

Web Content

​

Web crawling, URL discovery and page extraction.

Web Content Operacje

Generuj kompleksowe mapy witryny za pomocą Tavily Map.

​

Wyświetla adresy URL witryny od głównego url bez pobierania treści stron. Steruj nim za pomocą instructions w języku naturalnym oraz filtrów select_paths / exclude_paths / select_domains opartych na wyrażeniach regularnych. Zwraca base_url i results — płaską tablicę ciągów URL, a nie obiektów — wraz z response_time i request_id. Użyj go, aby ocenić rozmiar witryny przed rozpoczęciem indeksowania, a następnie pobierz tylko istotne części za pomocą extractWebContent. Jeśli chcesz treść, a nie strukturę, post_tavily_crawl robi jedno i drugie w jednym wywołaniu.

Cennik referencyjny

  • Rozliczanie: naliczone jednostki odpowiedzi.
  • Szacunek referencyjny dla żądania: USD 0.064.
  • 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ę mapowanie.

  • allow_external
    Typ: boolean

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

  • exclude_domains
    Typ: array string[]

    Wzorce regex wykluczające określone domeny lub subdomeny z mapowania.

  • exclude_paths
    Typ: array string[]

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

  • 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ść mapowania.

  • 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ę mapowania w sekundach.

Odpowiedzi
  • 200
    Typ: object

    Wyniki mapy zwrócone pomyślnie.

    • base_url
      Typ: string

      Bazowy adres URL, który został zmapowany.

    • request_id
      Typ: string

      Unikalny identyfikator żądania.

    • response_time
      Typ: number Format: float

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

    • results
      Typ: array string[]
    • 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/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.