Scholar Search
Scholarly and web search with result explanations.
Search the web
Search the open web and get back a lean result list. ⚠️ Despite being a POST, parameters go in the query string — query (required), max_num_results (default 10, max 100), and as_ylo/as_yhi for a year range. A JSON body is not accepted. Returns a search id and results[] carrying only title, link and snippet. Its virtue is how little it returns, which suits an agent that only needs to know what exists. It gives you no page text — if you need the content, searchWeb returns it in the same call. Keep the id: it is what post_scholar_search_explain needs.
- 型: stringquery必須
Search query for scholarly materials
- 型: integermax
_num _results 最小値:1最大値:100Maximum number of search results to return, up to 100
- 型: integeras
_ylo 最小値:1900最大値:2030null 許容Year of publication lower bound
- 型: integeras
_yhi 最小値:1900最大値:2030null 許容Year of publication upper bound
- 型: object · WebSearchResponse200
Successful search response
- 型: stringid必須
Unique identifier for the search request
- 型: array object[] · WebResult[]results必須
List of web search results
- link型: string 形式: uri必須
URL to access the web page
- snippet型: string必須
Brief summary or preview of the web page content
- title型: string必須
Title of the web page
- display型: string
_url Display-friendly URL
- published型: string 形式: date-time
_date Publication date of the web page
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/web?query=machine%20learning' \
--request POST \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN'
{
"id": "string",
"results": [
{
"title": "string",
"link": "https://example.com",
"snippet": "string",
"display_url": "string",
"published_date": "2026-09-30T03:09:45.799Z"
}
]
}