Felo API PlatformFelo API Platform
Todos os endpoints de Scholar Search
v0.2.0-beta
OpenAPI 3.1.0

Pesquisa inteligente que combina resultados da web e acadêmicos

Servidor:https://openapi.felo.ai
Bibliotecas Cliente

Pesquisa inteligente que combina resultados da web e acadêmicos

​

Pesquisa na web e em fontes acadêmicas ao mesmo tempo, para perguntas que transitam entre as duas. ⚠️ Os parâmetros vão na query string: query (obrigatório), max_num_results, as_ylo/as_yhi. Retorna um id de pesquisa e results[]; o formato das entradas varia conforme a fonte — todo resultado tem title, link e snippet, e os acadêmicos também trazem authors e number_of_citations, então trate esses dois como opcionais em vez de presumir que existem. Use quando não souber de antemão que tipo de fonte vai responder. Quando souber, post_scholar_search_web ou post_scholar_search_scholar é mais previsível. Guarde o id para post_scholar_search_explain.

Referência de preços

  • Medição: base de custo fixa por requisição bem-sucedida.
  • Estimativa de referência por requisição: USD 0.01.
  • Multiplicador de referência do cliente: 1.0. Não o aplique novamente a um valor de cliente já liquidado.

Apenas metadados de referência, não uma cotação da conta, um preço garantido ou um limite de gastos. Créditos de recursos não são créditos Felo. As cobranças finais seguem os registros de cobrança da Felo.

Parâmetros de Consulta
  • as_yhi
    Tipo: integer | null
    mín:  
    1900
    máx:  
    2030

    Limite superior do ano de publicação

  • as_ylo
    Tipo: integer | null
    mín:  
    1900
    máx:  
    2030

    Limite inferior do ano de publicação

  • max_num_results
    Tipo: integer
    mín:  
    1
    máx:  
    100

    Número máximo de resultados de pesquisa a retornar, até 100

  • query
    Tipo: string
    obrigatório

    Consulta de pesquisa para materiais acadêmicos

Respostas
  • 200
    Tipo: object · Response8Da310D1D213_SmartSearchResponse

    Resposta de pesquisa bem-sucedida

    • id
      Tipo: string
      obrigatório

      Identificador exclusivo da solicitação de pesquisa

    • results
      Tipo: array object[] · Response8Da310D1D213_SmartResult[]
      obrigatório

      Lista de resultados de pesquisa inteligente que combinam conteúdo da web e conteúdo acadêmico

      • link
        Tipo: string Formato: uri
        obrigatório

        URL para acessar o conteúdo

      • snippet
        Tipo: string
        obrigatório

        Breve resumo ou abstract

      • title
        Tipo: string
        obrigatório

        Título do resultado

      • authors
        Tipo: array string[]

        Lista de autores (para conteúdo acadêmico)

      • number_of_citations
        Tipo: integer
        mín:  
        0

        Número de citações (para conteúdo acadêmico)

      • relevance_score
        Tipo: number
        mín:  
        0
        máx:  
        1

        Pontuação de relevância do resultado

      • type
        Tipo: string enum

        Tipo do resultado

        valores
        • web
        • academic
    • search_type
      Tipo: string enum

      Tipo de resultados de pesquisa incluídos

      valores
      • web
      • academic
      • hybrid
    application/json
  • 400

    Não foi possível processar a requisição. Verifique os parâmetros da requisição.

  • 401

    É necessária uma chave de API da Felo válida.

  • 402

    A requisição não pode prosseguir porque um requisito de cobrança não foi atendido.

  • 403

    A conta não tem permissão para realizar esta operação.

  • 429

    Um limite de requisições ou de gastos foi atingido.

  • 502

    O serviço não pôde concluir a requisição.

  • 503

    A API ou o serviço de cobrança está temporariamente indisponível.

  • 504

    O serviço atingiu o tempo limite ao processar a requisição.

  • default

    Resposta de erro; respostas repassadas do upstream podem usar formatos do provedor

    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