Scholar Search
Scholarly and web search with result explanations.
Explain search results
Explain previously fetched search results. Supply the search_id returned by a Scholar search, with optional detail_level and language. response_mode=NON_STREAMING returns JSON with message; COMPLETE and INCREMENTAL return text/event-stream, where each event contains the accumulated explanation. This operation explains an existing search and does not start another search.
- Type: stringsearch
_id requiredID of the search to explain
- Type: string enumdetail
_level Level of detail in the explanation
values- B
R I E F - M
O D E R A T E - D
E T A I L E D
- Type: stringlanguage
Language code for the explanation (e.g., en, zh, ar)
- Type: string enumresponse
_mode Format of the explanation response. COMPLETE and INCREMENTAL stream server-sent events; NON_STREAMING returns a JSON response.
values- C
O M P L E T E - I
N C R E M E N T A L - N
O N _ S T R E A M I N G
- Type: object · ExplainSearchResponse200
Successful explanation response. COMPLETE/INCREMENTAL stream text/event-stream; NON_STREAMING returns application/json.
JSON explanation response returned when response_mode is NON_STREAMING.
- Type: stringmessagerequired
Generated explanation text.
- Type: object · ErrorResponse400
Bad request - invalid parameters
- Type: stringerror
A short error message.
- Type: stringmessage
A more detailed error message.
application/json - Type: object · ErrorResponse401
Unauthorized - invalid or missing API key
- Type: stringerror
A short error message.
- Type: 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.
- Type: object · ErrorResponse404
Search ID not found
- Type: stringerror
A short error message.
- Type: stringmessage
A more detailed error message.
application/json - Type: object · ErrorResponse429
Rate limit exceeded
- Type: stringerror
A short error message.
- Type: stringmessage
A more detailed error message.
application/json - Type: object · ErrorResponse500
Internal server error
- Type: stringerror
A short error message.
- Type: 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/explain \
--request POST \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
--data '{
"search_id": "",
"response_mode": "NON_STREAMING",
"language": "ar",
"detail_level": "MODERATE"
}'
{
"message": "string"
}