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

Pesquisar na web

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

Pesquisar na web

​

Pesquisa na web aberta e retorna uma lista enxuta de resultados. ⚠️ Apesar de ser um POST, os parâmetros vão na query string — query (obrigatório), max_num_results (padrão 10, máximo 100) e as_ylo/as_yhi para um intervalo de anos. Um corpo JSON não é aceito. Retorna um id de pesquisa e results[] contendo apenas title, link e snippet. Sua virtude é retornar pouco, o que serve a um agente que só precisa saber o que existe. Ele não fornece o texto da página — se precisar do conteúdo, searchWeb o retorna na mesma chamada. Guarde o id: é o que post_scholar_search_explain exige.

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_WebSearchResponse

    Resposta de pesquisa bem-sucedida

    • id
      Tipo: string
      obrigatório

      Identificador exclusivo da solicitação de pesquisa

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

      Lista de resultados de pesquisa na web

      • link
        Tipo: string Formato: uri
        obrigatório

        URL para acessar a página da web

      • snippet
        Tipo: string
        obrigatório

        Breve resumo ou prévia do conteúdo da página da web

      • title
        Tipo: string
        obrigatório

        Título da página da web

      • display_url
        Tipo: string

        URL amigável para exibição

      • published_date
        Tipo: string Formato: date-time

        Data de publicação da página da web

    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/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"
    }
  ]
}
Search the web