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

Búsqueda inteligente que combina resultados web y académicos

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

Búsqueda inteligente que combina resultados web y académicos

​

Busca a la vez en la web y en fuentes académicas, para preguntas que abarcan ambas. ⚠️ Los parámetros van en la query string: query (obligatorio), max_num_results, as_ylo/as_yhi. Devuelve un id de búsqueda y results[]; la forma de las entradas varía según el origen — todo resultado tiene title, link y snippet, y los académicos además llevan authors y number_of_citations, así que trata esos dos como opcionales en lugar de darlos por hechos. Úsalo cuando no sepas de antemano qué tipo de fuente responderá. Cuando lo sepas, post_scholar_search_web o post_scholar_search_scholar es más predecible. Conserva el id para post_scholar_search_explain.

Referencia de precios

  • Medición: base de costo fija por solicitud exitosa.
  • Estimación de referencia por solicitud: USD 0.01.
  • Multiplicador de referencia del cliente: 1.0. No lo apliques de nuevo a un importe de cliente ya liquidado.

Solo metadatos de referencia, no una cotización de la cuenta, un precio garantizado ni un límite de gasto. Los créditos de recursos no son créditos de Felo. Los cargos finales se rigen por los registros de facturación de Felo.

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

    Límite superior del año de publicación

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

    Límite inferior del año de publicación

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

    Número máximo de resultados de búsqueda que se devolverán, hasta 100

  • query
    Tipo: string
    obligatorio

    Consulta de búsqueda de material académico

Respuestas
  • 200
    Tipo: object · Response8Da310D1D213_SmartSearchResponse

    Respuesta de búsqueda correcta

    • id
      Tipo: string
      obligatorio

      Identificador exclusivo de la solicitud de búsqueda

    • results
      Tipo: array object[] · Response8Da310D1D213_SmartResult[]
      obligatorio

      Lista de resultados de búsqueda inteligente que combinan contenido web y académico

      • link
        Tipo: string Formato: uri
        obligatorio

        URL para acceder al contenido

      • snippet
        Tipo: string
        obligatorio

        Breve resumen o abstract

      • title
        Tipo: string
        obligatorio

        Título del resultado

      • authors
        Tipo: array string[]

        Lista de autores (para contenido académico)

      • number_of_citations
        Tipo: integer
        mín.:  
        0

        Número de citas (para contenido académico)

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

        Puntuación de relevancia del resultado

      • type
        Tipo: string enum

        Tipo de resultado

        valores
        • web
        • academic
    • search_type
      Tipo: string enum

      Tipo de resultados de búsqueda incluidos

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

    No se pudo procesar la solicitud. Comprueba los parámetros de la solicitud.

  • 401

    Se requiere una clave de API de Felo válida.

  • 402

    La solicitud no puede continuar porque no se cumple un requisito de facturación.

  • 403

    La cuenta no tiene permiso para realizar esta operación.

  • 429

    Se ha alcanzado un límite de solicitudes o de gasto.

  • 502

    El servicio no pudo completar la solicitud.

  • 503

    La API o el servicio de facturación no están disponibles temporalmente.

  • 504

    El servicio agotó el tiempo de espera al procesar la solicitud.

  • default

    Respuesta de error; las respuestas de paso del upstream pueden usar formatos del proveedor

    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