Felo API PlatformFelo API Platform
Tutti gli endpoint di Scholar Search
v0.2.0-beta
OpenAPI 3.1.0

Ricerca intelligente che combina risultati web e accademici

Server:https://openapi.felo.ai
Librerie client

Ricerca intelligente che combina risultati web e accademici

​

Cerca insieme sul web e su fonti accademiche, per domande che toccano entrambi. ⚠️ I parametri vanno nella query string: query (obbligatorio), max_num_results, as_ylo/as_yhi. Restituisce uno id di ricerca e results[]; la forma delle voci varia in base all'origine – ogni risultato ha title, link e snippet, e quelli accademici hanno in più authors e number_of_citations, quindi tratta questi due come facoltativi invece di dare per scontato che ci siano. Usalo quando non sai in anticipo quale tipo di fonte risponderà. Quando lo sai, post_scholar_search_web o post_scholar_search_scholar sono più prevedibili. Conserva lo id per post_scholar_search_explain.

Riferimento prezzi

  • Misurazione: base di costo fissa per richiesta riuscita.
  • Stima di riferimento per richiesta: USD 0.01.
  • Moltiplicatore di riferimento per il cliente: 1.0. Non applicarlo di nuovo a un importo già addebitato al cliente.

Solo metadati di riferimento, non un preventivo dell'account, né un prezzo garantito o un limite di spesa. I crediti delle risorse non sono crediti Felo. Gli addebiti finali seguono le registrazioni di fatturazione Felo.

Parametri di query
  • as_yhi
    Tipo: integer | null
    min:  
    1900
    max:  
    2030

    Limite superiore dell'anno di pubblicazione

  • as_ylo
    Tipo: integer | null
    min:  
    1900
    max:  
    2030

    Limite inferiore dell'anno di pubblicazione

  • max_num_results
    Tipo: integer
    min:  
    1
    max:  
    100

    Numero massimo di risultati di ricerca da restituire, fino a 100

  • query
    Tipo: string
    obbligatorio

    Query di ricerca per materiali accademici

Risposte
  • 200
    Tipo: object · Response8Da310D1D213_SmartSearchResponse

    Risposta di ricerca riuscita

    • id
      Tipo: string
      obbligatorio

      Identificatore univoco per la richiesta di ricerca

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

      Elenco dei risultati di ricerca intelligente che combinano contenuti web e accademici

      • link
        Tipo: string Formato: uri
        obbligatorio

        URL per accedere al contenuto

      • snippet
        Tipo: string
        obbligatorio

        Breve riassunto o abstract

      • title
        Tipo: string
        obbligatorio

        Titolo del risultato

      • authors
        Tipo: array string[]

        Elenco degli autori (per contenuti accademici)

      • number_of_citations
        Tipo: integer
        min:  
        0

        Numero di citazioni (per contenuti accademici)

      • relevance_score
        Tipo: number
        min:  
        0
        max:  
        1

        Punteggio di rilevanza del risultato

      • type
        Tipo: string enum

        Tipo di risultato

        valori
        • web
        • academic
    • search_type
      Tipo: string enum

      Tipo di risultati di ricerca inclusi

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

    Impossibile elaborare la richiesta. Controlla i parametri della richiesta.

  • 401

    È richiesta una chiave API Felo valida.

  • 402

    Impossibile procedere con la richiesta perché non è soddisfatto un requisito di fatturazione.

  • 403

    L'account non è autorizzato a eseguire questa operazione.

  • 429

    È stato raggiunto un limite di richieste o di spesa.

  • 502

    Il servizio non è riuscito a completare la richiesta.

  • 503

    L'API o il servizio di fatturazione è temporaneamente non disponibile.

  • 504

    Si è verificato un timeout durante l'elaborazione della richiesta.

  • default

    Risposta di errore; le risposte passthrough upstream possono usare formati del provider

    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