Smart search combining web and academic results
Scholar Search
Scholarly and web search with result explanations.
Smart search combining web and academic results
Search the web and academic sources together, for questions that straddle both. ⚠️ Parameters go in the query string: query (required), max_num_results, as_ylo/as_yhi. Returns a search id and results[]; the entry shape varies by source — every result has title, link and snippet, and academic ones additionally carry authors and number_of_citations, so treat those two as optional rather than assuming they are there. Use it when you do not know in advance which kind of source will answer. When you do, post_scholar_search_web or post_scholar_search_scholar is more predictable. Keep the id for post_scholar_search_explain.
- Тип: stringqueryобязательно
Search query for scholarly materials
- Тип: integermax
_num _results мин.:1макс.:100Maximum number of search results to return, up to 100
- Тип: integeras
_ylo мин.:1900макс.:2030может быть nullYear of publication lower bound
- Тип: integeras
_yhi мин.:1900макс.:2030может быть nullYear of publication upper bound
- Тип: object · SmartSearchResponse200
Successful search response
- Тип: stringidобязательно
Unique identifier for the search request
- Тип: array object[] · SmartResult[]resultsобязательно
List of smart search results combining web and academic content
- linkТип: string Формат: uriобязательно
URL to access the content
- snippetТип: stringобязательно
Brief summary or abstract
- titleТип: stringобязательно
Title of the result
- authorsТип: array string[]
List of authors (for academic content)
- numberТип: integer
_of _citations мин.:0Number of citations (for academic content)
- relevanceТип: number
_score мин.:0макс.:1Relevance score of the result
- typeТип: string enum
Type of the result
значения- web
- academic
- Тип: string enumsearch
_type Type of search results included
значения- web
- academic
- hybrid
application/json - Тип: object · ErrorResponse400
Bad request - invalid parameters
- Тип: stringerror
A short error message.
- Тип: stringmessage
A more detailed error message.
application/json - Тип: object · ErrorResponse401
Unauthorized - invalid or missing API key
- Тип: stringerror
A short error message.
- Тип: stringmessage
A more detailed error message.
application/json - 402
The request cannot proceed because a billing requirement is not met.
- 403
The account is not permitted to perform this operation.
- Тип: object · ErrorResponse429
Rate limit exceeded
- Тип: stringerror
A short error message.
- Тип: stringmessage
A more detailed error message.
application/json - Тип: object · ErrorResponse500
Internal server error
- Тип: stringerror
A short error message.
- Тип: stringmessage
A more detailed error message.
application/json - 502
The service could not complete the request.
- 503
The API or billing service is temporarily unavailable.
- 504
The service timed out while processing the request.
- default
The operation failed. Keep the response request ID when contacting Felo support.
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"
}