Felo API PlatformFelo API Platform
Tất cả endpoint của Tavily
v0.2.0-beta
OpenAPI 3.1.0

Tạo sơ đồ trang web toàn diện bằng Tavily Map.

Máy chủ:https://openapi.felo.ai
Thư viện client

Web Content

​

Web crawling, URL discovery and page extraction.

Web Content Thao tác

Tạo sơ đồ trang web toàn diện bằng Tavily Map.

​

Liệt kê URL của một trang web từ url gốc mà không tải nội dung trang. Điều hướng bằng instructions ngôn ngữ tự nhiên và các bộ lọc regex select_paths / exclude_paths / select_domains. Trả về base_url và results — mảng phẳng các chuỗi URL, không phải đối tượng — cùng response_time và request_id. Dùng để ước lượng quy mô trang web trước khi quyết định crawl, sau đó chỉ tải những phần quan trọng bằng extractWebContent. Khi cần nội dung thay vì cấu trúc, post_tavily_crawl thực hiện cả hai trong một lần gọi.

Tham chiếu giá

  • Đo lường: Đơn vị phản hồi được đo lường.
  • Ước tính tham chiếu cho mỗi yêu cầu: USD 0.064.
  • Cơ sở chi phí đơn vị: USD 0.008.
  • Đơn vị tài nguyên: tavily_credit.
  • Hệ số khách hàng tham chiếu: 1.0. Không áp dụng lại cho số tiền khách hàng đã quyết toán.
  • Cơ sở chi phí không xác lập giá cuối cùng cho khách hàng, kể cả khi bằng 0.

Chỉ là siêu dữ liệu tham chiếu, không phải báo giá cho tài khoản, mức giá được bảo đảm hay hạn mức chi tiêu. Tín dụng tài nguyên không phải tín dụng Felo. Khoản phí cuối cùng tuân theo bản ghi thanh toán của Felo.

Phần thân
bắt buộc
application/json
  • url
    Kiểu: string
    bắt buộc

    URL gốc để bắt đầu quá trình lập bản đồ.

  • allow_external
    Kiểu: boolean

    Bao gồm các liên kết miền bên ngoài trong danh sách kết quả cuối cùng.

  • exclude_domains
    Kiểu: array string[]

    Mẫu regex để loại trừ các tên miền hoặc tên miền phụ cụ thể khỏi quá trình lập bản đồ.

  • exclude_paths
    Kiểu: array string[]

    Mẫu regex để loại trừ các URL có mẫu đường dẫn cụ thể.

  • include_usage
    Kiểu: boolean

    Bao gồm thông tin sử dụng tín dụng trong phản hồi.

  • instructions
    Kiểu: string

    Chỉ dẫn bằng ngôn ngữ tự nhiên cho trình thu thập.

  • limit
    Kiểu: integer
    tối thiểu:  
    1

    Tổng số liên kết mà trình thu thập sẽ xử lý trước khi dừng.

  • max_breadth
    Kiểu: integer
    tối thiểu:  
    1
    tối đa:  
    500

    Số liên kết tối đa cần theo dõi mỗi cấp của cây.

  • max_depth
    Kiểu: integer
    tối thiểu:  
    1
    tối đa:  
    5

    Độ sâu tối đa của quá trình lập bản đồ.

  • select_domains
    Kiểu: array string[]

    Mẫu regex để chỉ thu thập các tên miền hoặc tên miền phụ cụ thể.

  • select_paths
    Kiểu: array string[]

    Mẫu regex để chỉ chọn các URL có mẫu đường dẫn cụ thể.

  • timeout
    Kiểu: number Định dạng: float
    tối thiểu:  
    10
    tối đa:  
    150

    Thời gian tối đa tính bằng giây để chờ thao tác lập bản đồ.

Phản hồi
  • 200
    Kiểu: object

    Kết quả lập bản đồ được trả về thành công.

    • base_url
      Kiểu: string

      URL gốc đã được lập bản đồ.

    • request_id
      Kiểu: string

      Mã định danh yêu cầu duy nhất.

    • response_time
      Kiểu: number Định dạng: float

      Thời gian tính bằng giây để hoàn thành yêu cầu.

    • results
      Kiểu: array string[]
    • usage
      Kiểu: object
      • credits
        Kiểu: integer

        Chi tiết sử dụng tín dụng cho yêu cầu.

    application/json
  • 400

    Không thể xử lý yêu cầu. Hãy kiểm tra các tham số yêu cầu.

  • 401

    Cần có khóa API Felo hợp lệ.

  • 402

    Không thể tiếp tục yêu cầu vì chưa đáp ứng yêu cầu thanh toán.

  • 403

    Tài khoản không được phép thực hiện thao tác này.

  • 429

    Đã đạt giới hạn yêu cầu hoặc giới hạn chi tiêu.

  • 502

    Dịch vụ không thể hoàn tất yêu cầu.

  • 503

    API hoặc dịch vụ thanh toán tạm thời không khả dụng.

  • 504

    Dịch vụ đã hết thời gian chờ khi xử lý yêu cầu.

  • default

    Phản hồi lỗi; phản hồi chuyển tiếp từ thượng nguồn có thể dùng định dạng của nhà cung cấp

    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.