Felo API PlatformFelo API Platform
Všechny endpointy Scholar Search
v0.2.0-beta
OpenAPI 3.1.0

Chytré hledání kombinující webové a akademické výsledky

Server:https://openapi.felo.ai
Klientské knihovny

Chytré hledání kombinující webové a akademické výsledky

​

Prohledává web a akademické zdroje současně, pro otázky, které zasahují do obou. ⚠️ Parametry patří do query stringu: query (povinné), max_num_results, as_ylo/as_yhi. Vrací id vyhledávání a results[]; tvar položky se liší podle zdroje — každý výsledek má title, link a snippet a akademické navíc authors a number_of_citations, proto tyto dva považujte za volitelné, místo abyste předpokládali, že tam jsou. Použijte, když předem nevíte, který druh zdroje odpoví. Když to víte, post_scholar_search_web nebo post_scholar_search_scholar je předvídatelnější. Uchovejte id pro post_scholar_search_explain.

Cenová reference

  • Měření: pevná nákladová základna za úspěšný požadavek.
  • Referenční odhad požadavku: USD 0.01.
  • Referenční multiplikátor zákazníka: 1.0. Znovu jej neaplikujte na již zúčtovanou částku zákazníka.

Pouze referenční metadata, nikoli nabídka pro účet, garantovaná cena či limit utrácení. Kredity prostředků nejsou kredity Felo. Konečné účtování se řídí fakturačními záznamy Felo.

Parametry dotazu
  • as_yhi
    Typ: integer | null
    min:  
    1900
    max:  
    2030

    Horní mez roku publikace

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

    Dolní mez roku publikace

  • max_num_results
    Typ: integer
    min:  
    1
    max:  
    100

    Maximální počet výsledků vyhledávání, které se mají vrátit, až 100

  • query
    Typ: string
    povinné

    Vyhledávací dotaz na odborné materiály

Odpovědi
  • 200
    Typ: object · Response8Da310D1D213_SmartSearchResponse

    Úspěšná odpověď hledání

    • id
      Typ: string
      povinné

      Jedinečný identifikátor požadavku vyhledávání

    • results
      Typ: array object[] · Response8Da310D1D213_SmartResult[]
      povinné

      Seznam výsledků chytrého vyhledávání kombinujících webový a odborný obsah

      • link
        Typ: string Formát: uri
        povinné

        URL pro přístup k obsahu

      • snippet
        Typ: string
        povinné

        Stručné shrnutí nebo abstrakt

      • title
        Typ: string
        povinné

        Název výsledku

      • authors
        Typ: array string[]

        Seznam autorů (pro odborný obsah)

      • number_of_citations
        Typ: integer
        min:  
        0

        Počet citací (pro odborný obsah)

      • relevance_score
        Typ: number
        min:  
        0
        max:  
        1

        Skóre relevance výsledku

      • type
        Typ: string enum

        Typ výsledku

        hodnoty
        • web
        • academic
    • search_type
      Typ: string enum

      Typ zahrnutých výsledků vyhledávání

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

    Požadavek se nepodařilo zpracovat. Zkontrolujte parametry požadavku.

  • 401

    Je vyžadován platný API klíč Felo.

  • 402

    V požadavku nelze pokračovat, protože není splněn požadavek na fakturaci.

  • 403

    Účet nemá oprávnění tuto operaci provést.

  • 429

    Byl dosažen limit požadavků nebo útraty.

  • 502

    Služba nemohla požadavek dokončit.

  • 503

    API nebo fakturační služba je dočasně nedostupná.

  • 504

    Při zpracování požadavku vypršel časový limit služby.

  • default

    Chybová odpověď; odpovědi předávané přímo od upstream poskytovatele mohou používat formáty poskytovatele

    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