Skip to main content
POST
https://api.aisa.one/apis/v1
/
scholar
/
search
/
explain
Explain search results
curl --request POST \
  --url https://api.aisa.one/apis/v1/scholar/search/explain \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "search_id": "<string>",
  "response_mode": "NON_STREAMING",
  "language": "ar",
  "detail_level": "MODERATE"
}
'
{
  "message": "<string>"
}
Generate an explanation from a previous Scholar Search, Web Search, or Smart Search request. Pass the returned search id as search_id. Best for: Summarizing search results, producing localized explanations, and turning search output into a readable answer.

​
Example

curl -X POST "https://api.aisa.one/apis/v1/scholar/search/explain" \
  -H "Authorization: Bearer ${AISA_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{
    "search_id": "search_id",
    "response_mode": "NON_STREAMING",
    "language": "en",
    "detail_level": "BRIEF"
  }'

​
Response

NON_STREAMING returns a JSON object with a message field. COMPLETE and INCREMENTAL stream server-sent events for clients that can consume streaming responses.

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json
​
search_id
string
required

ID of the search to explain

​
response_mode
enum<string>
default:NON_STREAMING

Format of the explanation response. COMPLETE and INCREMENTAL stream server-sent events; NON_STREAMING returns a JSON response.

Available options:
COMPLETE,
INCREMENTAL,
NON_STREAMING
​
language
string
default:en

Language code for the explanation (e.g., en, zh, ar)

Example:

"ar"

​
detail_level
enum<string>
default:MODERATE

Level of detail in the explanation

Available options:
BRIEF,
MODERATE,
DETAILED

Response

Successful explanation response. COMPLETE/INCREMENTAL stream text/event-stream; NON_STREAMING returns application/json.

JSON explanation response returned when response_mode is NON_STREAMING.

​
message
string
required

Generated explanation text.