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

Search academic papers

Felo API Support
MIT
Сервер:https://openapi.felo.ai
Клиентские библиотеки
Shell Curl

Search academic papers

​

Search academic literature. ⚠️ Parameters go in the query string, not a body: query (required), max_num_results, and as_ylo/as_yhi to bound publication years. Returns a search id and results[] with title, link, snippet, authors and number_of_citations — that last field is what a general web search cannot give you. Use it when the question calls for peer-reviewed sources or when citation counts matter. For current events and product pages a general engine is better: searchWeb. To cover both at once, post_scholar_search_mixed. Keep the id for post_scholar_search_explain.

Query-параметры
  • query
    Тип: string
    обязательно

    Search query for scholarly materials

  • max_num_results
    Тип: integer
    мин.:  
    1
    макс.:  
    100

    Maximum number of search results to return, up to 100

  • as_ylo
    Тип: integer
    мин.:  
    1900
    макс.:  
    2030    может быть null

    Year of publication lower bound

  • as_yhi
    Тип: integer
    мин.:  
    1900
    макс.:  
    2030    может быть null

    Year of publication upper bound

Ответы
  • 200
    Тип: object · ScholarSearchResponse

    Successful search response

    • id
      Тип: string
      обязательно

      Unique identifier for the search request

    • results
      Тип: array object[] · ScholarResult[]
      обязательно

      List of academic paper results

      • authors
        Тип: array string[]
        обязательно

        List of authors

      • link
        Тип: string Формат: uri
        обязательно

        URL to access the full paper

      • number_of_citations
        Тип: integer
        мин.:  
        0
        обязательно

        Number of citations the paper has received

      • snippet
        Тип: string
        обязательно

        Brief summary or abstract of the paper

      • title
        Тип: string
        обязательно

        Title of the academic paper

      • journal
        Тип: string

        Journal or conference name

      • year
        Тип: integer
        мин.:  
        1900
        макс.:  
        2030

        Publication year

    application/json
  • 400
    Тип: object · ErrorResponse

    Bad request - invalid parameters

    • error
      Тип: string

      A short error message.

    • message
      Тип: string

      A more detailed error message.

    application/json
  • 401
    Тип: object · ErrorResponse

    Unauthorized - invalid or missing API key

    • error
      Тип: string

      A short error message.

    • message
      Тип: string

      A more detailed error message.

    application/json
  • 402

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

  • 403

    The account is not permitted to perform this operation.

  • 429
    Тип: object · ErrorResponse

    Rate limit exceeded

    • error
      Тип: string

      A short error message.

    • message
      Тип: string

      A more detailed error message.

    application/json
  • 500
    Тип: object · ErrorResponse

    Internal server error

    • error
      Тип: string

      A short error message.

    • message
      Тип: string

      A more detailed error message.

    application/json
  • 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/scholar/search/scholar
curl 'https://openapi.felo.ai/v1/beta/scholar/search/scholar?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,
      "year": 1900,
      "journal": "string"
    }
  ]
}

Successful search response

Search academic papers