{"uid":"cap_TrpYcbpWY0CN917Gbr4lr","slug":"aisa-mpp-data-apis-aisa-scholar-search-explain-92aeb273","name":"AIsa Scholar Search Explain","description":"Explain a result set you already fetched. Unlike the three search endpoints this one takes a **JSON body**: `search_id` (required — the `id` returned by `post_scholar_search_web`, `post_scholar_search_scholar` or `post_scholar_search_mixed`), plus `detail_level` (BRIEF / MODERATE / DETAILED), `language`, and `response_mode`. ⚠️ Use `response_mode: NON_STREAMING`. It returns `{\"message\": \"…\"}` as JSON, measured at about 2 KB. The COMPLETE and INCREMENTAL modes emit server-sent events in which **each event repeats the whole answer so far** — the identical explanation measured 177 KB that way, roughly 90 times larger, and a tool call cannot consume a stream incrementally anyway. It only ever explains an existing search; it cannot run one.\n\n<!-- aisa-pricing:start -->\nPublished reference price: $0.01 USD per successful request. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","url":"https://api.aisa.one/apis/v1/scholar/search/explain?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","required":["search_id"],"properties":{"language":{"type":"string","default":"en","example":"ar","description":"Language code for the explanation (e.g., en, zh, ar)"},"search_id":{"type":"string","description":"ID of the search to explain"},"detail_level":{"enum":["BRIEF","MODERATE","DETAILED"],"type":"string","default":"MODERATE","description":"Level of detail in the explanation"},"response_mode":{"enum":["COMPLETE","INCREMENTAL","NON_STREAMING"],"type":"string","default":"NON_STREAMING","description":"Format of the explanation response. COMPLETE and INCREMENTAL stream server-sent events; NON_STREAMING returns a JSON response."}}},"responseSchema":{"type":"object","required":["message"],"properties":{"message":{"type":"string","description":"Generated explanation text."}},"description":"JSON explanation response returned when response_mode is NON_STREAMING."},"example":null,"exampleRequest":null,"tags":["web-search","financial-data","prediction-markets","weather","travel","data","search"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"mpp","network":"tempo","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_7V2DH0AAjcsRdruZdK0kM","protocol":"mpp","methodType":"crypto","chain":"tempo","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x20C000000000000000000000b9537d11c60E8b50","unit":"request","depositMicros":null,"planRef":null}],"brandName":"AIsa MPP Data APIs","brandSlug":"aisa-mpp-data-apis-mpp","brandBaseUrl":"https://aisa.one","brandDocsUrl":null,"whatItDoes":"Generates a natural-language explanation of an existing scholar search result set, given a prior search ID.","exampleAgentPrompt":"I just ran a scholar search and got back search ID 'abc123' — can you give me a detailed explanation of those results in English using non-streaming mode?","exampleUseCases":[{"title":"Academic literature briefing for researcher","prompt":"I searched for papers on CRISPR gene editing and got search ID 'srch_892xz' — can you give me a detailed explanation of those results in English?"},{"title":"Quick summary of web search results","prompt":"I just did a web search and the ID came back as 'ws_4421bb' — give me a brief explanation of what those results show, please."},{"title":"Multilingual explanation for non-English reader","prompt":"My mixed scholar search returned ID 'mix_77qqr' — can you explain those results in Arabic at a moderate detail level?"}],"resultDescription":"A JSON object with a single 'message' field containing a natural-language explanation of the previously fetched search results. Approximately 2 KB when using NON_STREAMING mode. The explanation reflects the requested detail level (BRIEF, MODERATE, or DETAILED) and language.","failureModes":["Invalid or expired search_id returns an error — the search must have been fetched recently and the ID must be valid","Using COMPLETE or INCREMENTAL response_mode causes server-sent event streaming that cannot be consumed by tool calls and inflates payload size ~90x (177 KB vs 2 KB)","Unsupported language code may result in fallback to English or an error","Missing required search_id field returns a validation error","Requesting explanation for a search that belongs to a different session or account returns an authorization error"],"whenToPreferThis":"Use this endpoint after you have already fetched results from post_scholar_search_web, post_scholar_search_scholar, or post_scholar_search_mixed and want a readable natural-language explanation rather than raw results. Always set response_mode to NON_STREAMING to receive a compact ~2 KB JSON response. Prefer this over re-running a search when you need an explanation of an existing result set.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-18T06:47:50.178Z","isFirstParty":false,"canonicalSlug":"aisa-mpp-data-apis-aisa-scholar-search-explain-92aeb273"}