Felo API PlatformFelo API Platform
Wszystkie endpointy Scholar Search
v0.2.0-beta
OpenAPI 3.1.0

Inteligentne wyszukiwanie łączące wyniki sieciowe i akademickie

Serwer:https://openapi.felo.ai
Biblioteki klienckie

Inteligentne wyszukiwanie łączące wyniki sieciowe i akademickie

​

Przeszukuje sieć i źródła akademickie jednocześnie, dla pytań obejmujących oba obszary. ⚠️ Parametry przekazuj w ciągu zapytania: query (wymagany), max_num_results, as_ylo/as_yhi. Zwraca id wyszukiwania i results[]; kształt wpisu zależy od źródła — każdy wynik ma title, link i snippet, a wyniki akademickie dodatkowo authors i number_of_citations, więc traktuj te dwa pola jako opcjonalne, zamiast zakładać, że są obecne. Używaj, gdy nie wiesz z góry, jaki rodzaj źródła odpowie. Gdy wiesz, post_scholar_search_web lub post_scholar_search_scholar jest bardziej przewidywalny. Zachowaj id dla post_scholar_search_explain.

Cennik referencyjny

  • Rozliczanie: stała podstawa kosztu za udane żądanie.
  • Szacunek referencyjny dla żądania: USD 0.01.
  • Referencyjny mnożnik klienta: 1.0. Nie stosuj go ponownie do rozliczonej kwoty klienta.

Wyłącznie metadane referencyjne, a nie wycena konta, gwarantowana cena lub limit wydatków. Kredyty zasobów nie są kredytami Felo. Ostateczne obciążenia są zgodne z zapisami rozliczeniowymi Felo.

Parametry zapytania
  • as_yhi
    Typ: integer | null
    min.:  
    1900
    maks.:  
    2030

    Górna granica roku publikacji

  • as_ylo
    Typ: integer | null
    min.:  
    1900
    maks.:  
    2030

    Dolna granica roku publikacji

  • max_num_results
    Typ: integer
    min.:  
    1
    maks.:  
    100

    Maksymalna liczba wyników wyszukiwania do zwrócenia, do 100

  • query
    Typ: string
    wymagane

    Zapytanie wyszukiwania materiałów naukowych

Odpowiedzi
  • 200
    Typ: object · Response8Da310D1D213_SmartSearchResponse

    Pomyślna odpowiedź wyszukiwania

    • id
      Typ: string
      wymagane

      Unikalny identyfikator żądania wyszukiwania

    • results
      Typ: array object[] · Response8Da310D1D213_SmartResult[]
      wymagane

      Lista wyników wyszukiwania inteligentnego łączących treści internetowe i naukowe

      • link
        Typ: string Format: uri
        wymagane

        URL dostępu do treści

      • snippet
        Typ: string
        wymagane

        Krótkie streszczenie lub abstrakt

      • title
        Typ: string
        wymagane

        Tytuł wyniku

      • authors
        Typ: array string[]

        Lista autorów (dla treści naukowych)

      • number_of_citations
        Typ: integer
        min.:  
        0

        Liczba cytowań (dla treści naukowych)

      • relevance_score
        Typ: number
        min.:  
        0
        maks.:  
        1

        Ocena trafności wyniku

      • type
        Typ: string enum

        Typ wyniku

        wartości
        • web
        • academic
    • search_type
      Typ: string enum

      Typ uwzględnionych wyników wyszukiwania

      wartości
      • web
      • academic
      • hybrid
    application/json
  • 400

    Nie można przetworzyć żądania. Sprawdź parametry żądania.

  • 401

    Wymagany jest prawidłowy klucz API Felo.

  • 402

    Nie można kontynuować żądania, ponieważ nie spełniono wymogu rozliczeniowego.

  • 403

    Konto nie ma uprawnień do wykonania tej operacji.

  • 429

    Osiągnięto limit żądań lub wydatków.

  • 502

    Usługa nie mogła ukończyć żądania.

  • 503

    API lub usługa rozliczeniowa jest tymczasowo niedostępna.

  • 504

    Upłynął limit czasu usługi podczas przetwarzania żądania.

  • default

    Odpowiedź błędu; odpowiedzi przekazywane bezpośrednio od dostawcy upstream mogą używać formatów dostawcy

    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