Умный поиск, объединяющий веб- и академические результаты
Scholar Search
Scholarly and web search with result explanations.
Умный поиск, объединяющий веб- и академические результаты
Ищет одновременно в вебе и академических источниках для вопросов, затрагивающих обе области. ⚠️ Параметры передаются в строке запроса: query (обязателен), max_num_results, as_ylo/as_yhi. Возвращает id поиска и results[]; структура записи зависит от источника — у каждого результата есть title, link и snippet, а академические дополнительно содержат authors и number_of_citations, поэтому считайте эти два поля необязательными, а не предполагайте их наличие. Используйте, когда заранее неизвестно, какой тип источника даст ответ. Когда известно, post_scholar_search_web или post_scholar_search_scholar предсказуемее. Сохраните id для post_scholar_search_explain.
Справочные цены
- Тарификация: фиксированная базовая стоимость успешного запроса.
- Справочная оценка запроса: USD 0.01.
- Справочный множитель для клиента: 1.0. Не применяйте его повторно к уже рассчитанной сумме клиента.
Справочные метаданные, а не коммерческое предложение для аккаунта, гарантированная цена или лимит расходов. Кредиты ресурсов — не кредиты Felo. Итоговые списания определяются записями биллинга Felo.
- Тип: integer | nullas
_yhi мин.:1900макс.:2030Верхняя граница года публикации
- Тип: integer | nullas
_ylo мин.:1900макс.:2030Нижняя граница года публикации
- Тип: integermax
_num _results мин.:1макс.:100Максимальное количество результатов поиска, до 100
- Тип: stringqueryобязательно
Поисковый запрос для научных материалов
- Тип: object · Response8Da310D1D213_SmartSearchResponse200
Успешный ответ на поиск
- Тип: stringidобязательно
Уникальный идентификатор поискового запроса
- Тип: array object[] · Response8Da310D1D213_SmartResult[]resultsобязательно
Список результатов умного поиска, объединяющих веб- и научный контент
- linkТип: string Формат: uriобязательно
URL для доступа к контенту
- snippetТип: stringобязательно
Краткое резюме или аннотация
- titleТип: stringобязательно
Название результата
- authorsТип: array string[]
Список авторов (для научного контента)
- numberТип: integer
_of _citations мин.:0Число цитирований (для научного контента)
- relevanceТип: number
_score мин.:0макс.:1Оценка релевантности результата
- typeТип: string enum
Тип результата
значения- web
- academic
- Тип: string enumsearch
_type Тип включённых результатов поиска
значения- web
- academic
- hybrid
application/json - 400
Запрос не удалось обработать. Проверьте параметры запроса.
- 401
Требуется действительный API-ключ Felo.
- 402
Запрос не может быть выполнен: не выполнено требование биллинга.
- 403
Аккаунту не разрешено выполнять эту операцию.
- 429
Достигнут лимит запросов или расходов.
- 502
Сервис не смог выполнить запрос.
- 503
API или сервис биллинга временно недоступны.
- 504
Истекло время ожидания обработки запроса.
- default
Ответ с ошибкой; сквозные ответы upstream могут использовать форматы провайдера
application/json
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"
}