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 thông minh kết hợp kết quả web và học thuật

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

Tìm kiếm thông minh kết hợp kết quả web và học thuật

​

Tìm kiếm web và nguồn học thuật cùng lúc, cho những câu hỏi trải rộng cả hai. ⚠️ Các tham số nằm trong query string: query (bắt buộc), max_num_results, as_ylo/as_yhi. Trả về id tìm kiếm và results[]; hình dạng mục thay đổi theo nguồn — mọi kết quả đều có title, link và snippet, còn kết quả học thuật mang thêm authors và number_of_citations, nên hãy coi hai trường đó là tùy chọn thay vì mặc định chúng có mặt. Dùng khi bạn chưa biết trước loại nguồn nào sẽ trả lời. Khi đã biết, post_scholar_search_web hoặc post_scholar_search_scholar dễ đoán hơn. Giữ id cho post_scholar_search_explain.

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_SmartSearchResponse

    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_SmartResult[]
      bắt buộc

      Danh sách kết quả tìm kiếm thông minh kết hợp nội dung web và nội dung học thuật

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

        URL để truy cập nội dung

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

        Tóm tắt ngắn hoặc phần tóm lược

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

        Tiêu đề của kết quả

      • authors
        Kiểu: array string[]

        Danh sách tác giả (cho nội dung học thuật)

      • number_of_citations
        Kiểu: integer
        tối thiểu:  
        0

        Số lượt trích dẫn (cho nội dung học thuật)

      • relevance_score
        Kiểu: number
        tối thiểu:  
        0
        tối đa:  
        1

        Điểm liên quan của kết quả

      • type
        Kiểu: string enum

        Loại kết quả

        giá trị
        • web
        • academic
    • search_type
      Kiểu: string enum

      Loại kết quả tìm kiếm được bao gồm

      giá trị
      • web
      • academic
      • hybrid
    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/mixed
curl 'https://openapi.felo.ai/v1/beta/scholar/search/mixed?query=machine%20learning' \
  --request POST \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
  "id": "string",
  "results": [
    {
      "title": "string",
      "link": "https://example.com",
      "snippet": "string",
      "authors": [
        "string"
      ],
      "number_of_citations": 0,
      "type": "web",
      "relevance_score": 0
    }
  ],
  "search_type": "web"
}
Smart search combining web and academic results