Felo API PlatformFelo API Platform
Tous les endpoints Scholar Search
v0.2.0-beta
OpenAPI 3.1.0

Recherche intelligente combinant résultats web et académiques

Serveur:https://openapi.felo.ai
Bibliothèques clientes

Recherche intelligente combinant résultats web et académiques

​

Recherche à la fois sur le web et dans des sources académiques, pour les questions qui relèvent des deux. ⚠️ Les paramètres vont dans la query string : query (obligatoire), max_num_results, as_ylo/as_yhi. Renvoie un id de recherche et results[] ; la forme des entrées varie selon la source — chaque résultat a title, link et snippet, et les résultats académiques portent en plus authors et number_of_citations, alors traitez ces deux champs comme facultatifs plutôt que de supposer qu'ils sont là. Utilisez-le lorsque vous ne savez pas à l'avance quel type de source répondra. Quand vous le savez, post_scholar_search_web ou post_scholar_search_scholar est plus prévisible. Conservez l'id pour post_scholar_search_explain.

Référence tarifaire

  • Mesure : base de coût fixe par requête réussie.
  • Estimation de référence par requête : USD 0.01.
  • Multiplicateur client de référence : 1.0. Ne pas l'appliquer à nouveau à un montant client déjà réglé.

Métadonnées de référence uniquement, et non un devis de compte, un prix garanti ou un plafond de dépenses. Les crédits de ressources ne sont pas des crédits Felo. Les débits définitifs suivent les enregistrements de facturation Felo.

Paramètres de requête
  • as_yhi
    Type: integer | null
    min.:  
    1900
    max.:  
    2030

    Borne supérieure de l'année de publication

  • as_ylo
    Type: integer | null
    min.:  
    1900
    max.:  
    2030

    Borne inférieure de l'année de publication

  • max_num_results
    Type: integer
    min.:  
    1
    max.:  
    100

    Nombre maximal de résultats de recherche à renvoyer, jusqu'à 100

  • query
    Type: string
    obligatoire

    Requête de recherche de documents académiques

Réponses
  • 200
    Type: object · Response8Da310D1D213_SmartSearchResponse

    Réponse de recherche réussie

    • id
      Type: string
      obligatoire

      Identifiant unique de la requête de recherche

    • results
      Type: array object[] · Response8Da310D1D213_SmartResult[]
      obligatoire

      Liste des résultats de recherche intelligente combinant contenu web et académique

      • link
        Type: string Format: uri
        obligatoire

        URL pour accéder au contenu

      • snippet
        Type: string
        obligatoire

        Bref résumé ou abstract

      • title
        Type: string
        obligatoire

        Titre du résultat

      • authors
        Type: array string[]

        Liste des auteurs (pour le contenu académique)

      • number_of_citations
        Type: integer
        min.:  
        0

        Nombre de citations (pour le contenu académique)

      • relevance_score
        Type: number
        min.:  
        0
        max.:  
        1

        Score de pertinence du résultat

      • type
        Type: string enum

        Type de résultat

        valeurs
        • web
        • academic
    • search_type
      Type: string enum

      Type de résultats de recherche inclus

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

    La requête n'a pas pu être traitée. Vérifiez les paramètres de la requête.

  • 401

    Une clé API Felo valide est requise.

  • 402

    La requête ne peut pas aboutir car une condition de facturation n'est pas remplie.

  • 403

    Le compte n'est pas autorisé à effectuer cette opération.

  • 429

    Une limite de requêtes ou de dépenses a été atteinte.

  • 502

    Le service n'a pas pu terminer la requête.

  • 503

    L'API ou le service de facturation est temporairement indisponible.

  • 504

    Le service a expiré lors du traitement de la requête.

  • default

    Réponse d'erreur ; les réponses transmises depuis l'upstream peuvent utiliser les formats du fournisseur

    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