Felo API PlatformFelo API Platform
v0.1.0-beta
OpenAPI 3.1.0

Graph-based website traversal tool using Tavily Crawl.

サーバー:https://openapi.felo.ai
クライアントライブラリ

Web Content

​

Web crawling, URL discovery and page extraction.

Web Content 操作

Graph-based website traversal tool using Tavily Crawl.

​

Walk a site from a root url and return the content of the pages it finds. Steer it with natural-language instructions plus regex path and domain filters, and bound it with max_depth, max_breadth and limit. Returns base_url and results[] with url and raw_content. Use it for broad coverage of one site — documentation, a catalogue, a competitor's blog. It answers synchronously, which post_firecrawl_crawl does not: that one runs as a background job and suits crawls too large to wait on.

リクエストボディ
必須
application/json
  • url
    型: string
    必須

    The root URL to begin the crawl.

  • allow_external
    型: boolean

    Include external domain links in the final results list.

  • chunks_per_source
    型: integer
    最小値:  
    1
    最大値:  
    5

    Maximum number of relevant chunks returned per source.

  • exclude_domains
    型: array string[]

    Regex patterns to exclude specific domains or subdomains from crawling.

  • exclude_paths
    型: array string[]

    Regex patterns to exclude URLs with specific path patterns.

  • extract_depth
    型: string 列挙値

    Depth of the extraction process.

    値
    • basic
    • advanced
  • format
    型: string 列挙値

    Format of the extracted web page content.

    値
    • markdown
    • text
  • include_favicon
    型: boolean

    Include the favicon URL for each result.

  • include_images
    型: boolean

    Include images in the crawl results.

  • include_usage
    型: boolean

    Include credit usage information in the response.

  • instructions
    型: string

    Natural language instructions for the crawler.

  • limit
    型: integer
    最小値:  
    1

    Total number of links the crawler will process before stopping.

  • max_breadth
    型: integer
    最小値:  
    1
    最大値:  
    500

    Max number of links to follow per level of the tree.

  • max_depth
    型: integer
    最小値:  
    1
    最大値:  
    5

    Max depth of the crawl.

  • select_domains
    型: array string[]

    Regex patterns to select crawling to specific domains or subdomains.

  • select_paths
    型: array string[]

    Regex patterns to select only URLs with specific path patterns.

  • timeout
    型: number 形式: float
    最小値:  
    10
    最大値:  
    150

    Maximum time in seconds to wait for the crawl operation.

レスポンス
  • 200
    型: object

    Crawl results returned successfully.

    • base_url
      型: string

      The base URL that was crawled.

    • request_id
      型: string

      Unique request identifier.

    • response_time
      型: number 形式: float

      Time in seconds it took to complete the request.

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

        Favicon URL of the crawled page.

      • raw_content
        型: string

        Extracted raw content from the page.

      • url
        型: string

        URL of the crawled page.

    • usage
      型: object
      • credits
        型: integer

        Credit usage details for the request.

    application/json
  • 400

    The request could not be processed. Check the request parameters.

  • 401

    A valid Felo API key is required.

  • 402

    The request cannot proceed because a billing requirement is not met.

  • 403

    The account is not permitted to perform this operation.

  • 429

    A request or spending limit has been reached.

  • 502

    The service could not complete the request.

  • 503

    The API or billing service is temporarily unavailable.

  • 504

    The service timed out while processing the request.

  • default

    The operation failed. Keep the response request ID when contacting Felo support.

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.