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

Tìm kiếm web

Felo API Support
MIT
Máy chủ:https://openapi.felo.ai
Thư viện client
Shell Curl

Tìm kiếm web

​

Tìm kiếm trên web mở và nhận về danh sách kết quả gọn nhẹ. ⚠️ Dù là POST, các tham số vẫn nằm trong query string — query (bắt buộc), max_num_results (mặc định 10, tối đa 100) và as_ylo/as_yhi cho khoảng năm. Body JSON không được chấp nhận. Trả về id tìm kiếm và results[] chỉ mang title, link và snippet. Ưu điểm của nó là trả về rất ít, phù hợp với agent chỉ cần biết thứ gì tồn tại. Nó không cung cấp nội dung trang — nếu cần nội dung, searchWeb trả về luôn trong cùng lần gọi. Giữ id: đó là thứ post_scholar_search_explain cần.

Tham chiếu giá

  • Đo lường: Cơ sở chi phí cố định theo yêu cầu thành công.
  • Ước tính tham chiếu cho mỗi yêu cầu: USD 0.01.
  • 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.

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.

Tham số truy vấn
  • as_yhi
    Kiểu: integer | null
    tối thiểu:  
    1900
    tối đa:  
    2030

    Giới hạn trên của năm xuất bản

  • as_ylo
    Kiểu: integer | null
    tối thiểu:  
    1900
    tối đa:  
    2030

    Giới hạn dưới của năm xuất bản

  • max_num_results
    Kiểu: integer
    tối thiểu:  
    1
    tối đa:  
    100

    Số kết quả tìm kiếm tối đa cần trả về, tối đa 100

  • query
    Kiểu: string
    bắt buộc

    Truy vấn tìm kiếm tài liệu học thuật

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

    Phản hồi tìm kiếm thành công

    • id
      Kiểu: string
      bắt buộc

      Mã định danh duy nhất cho yêu cầu tìm kiếm

    • results
      Kiểu: array object[] · Response8Da310D1D213_WebResult[]
      bắt buộc

      Danh sách kết quả tìm kiếm web

      • link
        Kiểu: string Định dạng: uri
        bắt buộc

        URL để truy cập trang web

      • snippet
        Kiểu: string
        bắt buộc

        Tóm tắt ngắn hoặc bản xem trước nội dung trang web

      • title
        Kiểu: string
        bắt buộc

        Tiêu đề của trang web

      • display_url
        Kiểu: string

        URL thân thiện để hiển thị

      • published_date
        Kiểu: string Định dạng: date-time

        Ngày xuất bản của trang web

    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/scholar/search/web
curl 'https://openapi.felo.ai/v1/beta/scholar/search/web?query=machine%20learning' \
  --request POST \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "id": "string",
  "results": [
    {
      "title": "string",
      "link": "https://example.com",
      "snippet": "string",
      "display_url": "string",
      "published_date": "2026-10-26T08:08:16.607Z"
    }
  ]
}

Phản hồi tìm kiếm thành công

Search the web