{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{},"pathItems":{},"requestBodies":{},"responses":{},"schemas":{"Manual8Da310D1D213_ExplainSearchRequest":{"properties":{"detail_level":{"default":"MODERATE","description":"Level of detail in the explanation","enum":["BRIEF","MODERATE","DETAILED"],"type":"string"},"language":{"default":"en","description":"Language code for the explanation (e.g., en, zh, ar)","example":"ar","type":"string"},"response_mode":{"default":"NON_STREAMING","description":"Format of the explanation response. COMPLETE and INCREMENTAL stream server-sent events; NON_STREAMING returns a JSON response.","enum":["COMPLETE","INCREMENTAL","NON_STREAMING"],"type":"string"},"search_id":{"description":"ID of the search to explain","type":"string"}},"required":["search_id"],"type":"object"},"Response8Da310D1D213_ExplainSearchResponse":{"description":"JSON explanation response returned when response_mode is NON_STREAMING.","properties":{"message":{"description":"Generated explanation text.","type":"string"}},"required":["message"],"type":"object"},"Response8Da310D1D213_ScholarResult":{"properties":{"authors":{"description":"List of authors","items":{"type":"string"},"type":"array"},"journal":{"description":"Journal or conference name","type":"string"},"link":{"description":"URL to access the full paper","format":"uri","type":"string"},"number_of_citations":{"description":"Number of citations the paper has received","minimum":0,"type":"integer"},"snippet":{"description":"Brief summary or abstract of the paper","type":"string"},"title":{"description":"Title of the academic paper","type":"string"},"year":{"description":"Publication year","maximum":2030,"minimum":1900,"type":"integer"}},"required":["title","link","snippet","authors","number_of_citations"],"type":"object"},"Response8Da310D1D213_ScholarSearchResponse":{"properties":{"id":{"description":"Unique identifier for the search request","type":"string"},"results":{"description":"List of academic paper results","items":{"$ref":"#/components/schemas/Response8Da310D1D213_ScholarResult"},"type":"array"}},"required":["id","results"],"type":"object"},"Response8Da310D1D213_SmartResult":{"properties":{"authors":{"description":"List of authors (for academic content)","items":{"type":"string"},"type":"array"},"link":{"description":"URL to access the content","format":"uri","type":"string"},"number_of_citations":{"description":"Number of citations (for academic content)","minimum":0,"type":"integer"},"relevance_score":{"description":"Relevance score of the result","maximum":1,"minimum":0,"type":"number"},"snippet":{"description":"Brief summary or abstract","type":"string"},"title":{"description":"Title of the result","type":"string"},"type":{"description":"Type of the result","enum":["web","academic"],"type":"string"}},"required":["title","link","snippet"],"type":"object"},"Response8Da310D1D213_SmartSearchResponse":{"properties":{"id":{"description":"Unique identifier for the search request","type":"string"},"results":{"description":"List of smart search results combining web and academic content","items":{"$ref":"#/components/schemas/Response8Da310D1D213_SmartResult"},"type":"array"},"search_type":{"description":"Type of search results included","enum":["web","academic","hybrid"],"type":"string"}},"required":["id","results"],"type":"object"},"Response8Da310D1D213_WebResult":{"properties":{"display_url":{"description":"Display-friendly URL","type":"string"},"link":{"description":"URL to access the web page","format":"uri","type":"string"},"published_date":{"description":"Publication date of the web page","format":"date-time","type":"string"},"snippet":{"description":"Brief summary or preview of the web page content","type":"string"},"title":{"description":"Title of the web page","type":"string"}},"required":["title","link","snippet"],"type":"object"},"Response8Da310D1D213_WebSearchResponse":{"properties":{"id":{"description":"Unique identifier for the search request","type":"string"},"results":{"description":"List of web search results","items":{"$ref":"#/components/schemas/Response8Da310D1D213_WebResult"},"type":"array"}},"required":["id","results"],"type":"object"}},"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"}}},"info":{"description":"","title":"Scholar","version":"1","x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","quote":{"header":"X-AISA-Cost-Mode","value":"quote"}},"x-aisa-catalogs":{"scholar":{"description":"","title":"Scholar","x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","quote":{"header":"X-AISA-Cost-Mode","value":"quote"}},"x-aisa-document":{"facts_hash":"60c867b8f9840a96a156bdf04dd69950d866b01ed2d659222e3225a3a7facb5e","generator_version":"3","protocol_version":"1","schema_version":"1"},"x-aisa-plans":{"builder":1.0,"display_plan":"payg","payg":1.0,"similarweb_payg":1.0,"team":1.0,"version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"}}},"x-aisa-configured-paths":["/apis/v1/scholar/search/explain","/apis/v1/scholar/search/mixed","/apis/v1/scholar/search/scholar","/apis/v1/scholar/search/web"],"x-aisa-document":{"composer_version":"26","document_hash":"sha256:e4e1e1e8a17d1f1dfd09123684c5a1a0f8316784a719f5dd4be7a38c89f47622","facts_hash":"60c867b8f9840a96a156bdf04dd69950d866b01ed2d659222e3225a3a7facb5e","generator_version":"3","protocol_version":"1","response_pending":[],"schema_version":"1"},"x-aisa-plans":{"builder":1.0,"display_plan":"payg","payg":1.0,"similarweb_payg":1.0,"team":1.0,"version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"},"x-aisa-provider":"scholar"},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","openapi":"3.1.0","paths":{"/apis/v1/scholar/search/explain":{"post":{"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 -->","operationId":"post_scholar_search_explain","requestBody":{"content":{"application/json":{"schema":{"properties":{"detail_level":{"default":"MODERATE","description":"Level of detail in the explanation","enum":["BRIEF","MODERATE","DETAILED"],"type":"string"},"language":{"default":"en","description":"Language code for the explanation (e.g., en, zh, ar)","example":"ar","type":"string"},"response_mode":{"default":"NON_STREAMING","description":"Format of the explanation response. COMPLETE and INCREMENTAL stream server-sent events; NON_STREAMING returns a JSON response.","enum":["COMPLETE","INCREMENTAL","NON_STREAMING"],"type":"string"},"search_id":{"description":"ID of the search to explain","type":"string"}},"required":["search_id"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response8Da310D1D213_ExplainSearchResponse"}},"text/event-stream":{"schema":{"type":"string"}}},"description":"Successful explanation response. COMPLETE/INCREMENTAL stream text/event-stream; NON_STREAMING returns application/json."},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Explain Search Results","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":true,"mpp_methods":["POST"],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"scholar","x-aisa-category":"6","x-aisa-docs-url":"https://aisa.one/docs/api-reference/scholar/post_scholar-search-explain","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.01,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-response-source":{"content_hash":"sha256:e9ea98ee334d24bdb50a7283681d46fbc4ec97aafe53cd7794784401d4a5ff23","kind":"upstream_success_contract","source":{"content_hash":"sha256:344cbd3ae2de5312a40328dadd67b2a426a96be33f21a6eb7782bf330d28aba7","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:66c781477d09309828b8ef02e760671252531c5445ea4257c764f2ba4f96ddad","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/platform-txyz-openapi.json"}},"x-aisa-revision":{"customer_pricing_ref":"915dc59f87b4","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"e2810d892a58"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_scholar_search_explain","path":"/apis/v1/scholar/search/explain"},"x-aisa-source":{"content_hash":"sha256:344cbd3ae2de5312a40328dadd67b2a426a96be33f21a6eb7782bf330d28aba7","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:66c781477d09309828b8ef02e760671252531c5445ea4257c764f2ba4f96ddad","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/platform-txyz-openapi.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v1/search/explain","x-aisa-validation":"provider"}},"/apis/v1/scholar/search/mixed":{"post":{"description":"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. Measured at about 3 seconds. 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`.\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 -->","operationId":"post_scholar_search_mixed","parameters":[{"description":"Year of publication upper bound","in":"query","name":"as_yhi","schema":{"maximum":2030,"minimum":1900,"type":["integer","null"]}},{"description":"Year of publication lower bound","in":"query","name":"as_ylo","schema":{"maximum":2030,"minimum":1900,"type":["integer","null"]}},{"description":"Maximum number of search results to return, up to 100","in":"query","name":"max_num_results","schema":{"default":10,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Search query for scholarly materials","in":"query","name":"query","required":true,"schema":{"example":"machine learning","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response8Da310D1D213_SmartSearchResponse"}}},"description":"Successful search response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Search Mixed Content","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"scholar","x-aisa-category":"6","x-aisa-docs-url":"https://aisa.one/docs/api-reference/scholar/post_scholar-search-mixed","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.01,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-response-source":{"content_hash":"sha256:d7b950f0f02acb8773d3ed01862537a167a7b4ea10f9f0c00ab3ba8fa6618232","kind":"upstream_success_contract","source":{"content_hash":"sha256:344cbd3ae2de5312a40328dadd67b2a426a96be33f21a6eb7782bf330d28aba7","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:66c781477d09309828b8ef02e760671252531c5445ea4257c764f2ba4f96ddad","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/platform-txyz-openapi.json"}},"x-aisa-revision":{"customer_pricing_ref":"915dc59f87b4","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"7236f229670e"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_scholar_search_mixed","path":"/apis/v1/scholar/search/mixed"},"x-aisa-source":{"content_hash":"sha256:344cbd3ae2de5312a40328dadd67b2a426a96be33f21a6eb7782bf330d28aba7","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:66c781477d09309828b8ef02e760671252531c5445ea4257c764f2ba4f96ddad","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/platform-txyz-openapi.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v1/search/smart","x-aisa-validation":"provider"}},"/apis/v1/scholar/search/scholar":{"post":{"description":"Search academic literature. ⚠️ Parameters go in the **query string**, not a body: `query` (required), `max_num_results`, and `as_ylo`/`as_yhi` to bound publication years. Returns a search `id` and `results[]` with `title`, `link`, `snippet`, `authors` and `number_of_citations` — that last field is what a general web search cannot give you. Measured at under 2 seconds. Use it when the question calls for peer-reviewed sources or when citation counts matter. For current events and product pages a general engine is better: `post_tavily_search`. To cover both at once, `post_scholar_search_mixed`. Keep the `id` for `post_scholar_search_explain`.\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 -->","operationId":"post_scholar_search_scholar","parameters":[{"description":"Year of publication upper bound","in":"query","name":"as_yhi","schema":{"maximum":2030,"minimum":1900,"type":["integer","null"]}},{"description":"Year of publication lower bound","in":"query","name":"as_ylo","schema":{"maximum":2030,"minimum":1900,"type":["integer","null"]}},{"description":"Maximum number of search results to return, up to 100","in":"query","name":"max_num_results","schema":{"default":10,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Search query for scholarly materials","in":"query","name":"query","required":true,"schema":{"example":"machine learning","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response8Da310D1D213_ScholarSearchResponse"}}},"description":"Successful search response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Search Scholarly Articles","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"scholar","x-aisa-category":"6","x-aisa-docs-url":"https://aisa.one/docs/api-reference/scholar/post_scholar-search-scholar","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.01,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-response-source":{"content_hash":"sha256:13d9faf98bae557e0a89f4817af6f926de07c6ef662bce701f3951110bd3ff1c","kind":"upstream_success_contract","source":{"content_hash":"sha256:344cbd3ae2de5312a40328dadd67b2a426a96be33f21a6eb7782bf330d28aba7","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:66c781477d09309828b8ef02e760671252531c5445ea4257c764f2ba4f96ddad","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/platform-txyz-openapi.json"}},"x-aisa-revision":{"customer_pricing_ref":"915dc59f87b4","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"1cd7490b6769"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_scholar_search_scholar","path":"/apis/v1/scholar/search/scholar"},"x-aisa-source":{"content_hash":"sha256:344cbd3ae2de5312a40328dadd67b2a426a96be33f21a6eb7782bf330d28aba7","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:66c781477d09309828b8ef02e760671252531c5445ea4257c764f2ba4f96ddad","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/platform-txyz-openapi.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v1/search/scholar","x-aisa-validation":"provider"}},"/apis/v1/scholar/search/web":{"post":{"description":"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`. Measured at about 4 seconds for a roughly 600-byte response. 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, `post_tavily_search` returns it in the same call. Keep the `id`: it is what `post_scholar_search_explain` needs.\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 -->","operationId":"post_scholar_search_web","parameters":[{"description":"Year of publication upper bound","in":"query","name":"as_yhi","schema":{"maximum":2030,"minimum":1900,"type":["integer","null"]}},{"description":"Year of publication lower bound","in":"query","name":"as_ylo","schema":{"maximum":2030,"minimum":1900,"type":["integer","null"]}},{"description":"Maximum number of search results to return, up to 100","in":"query","name":"max_num_results","schema":{"default":10,"maximum":100,"minimum":1,"type":"integer"}},{"description":"Search query for scholarly materials","in":"query","name":"query","required":true,"schema":{"example":"machine learning","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/Response8Da310D1D213_WebSearchResponse"}}},"description":"Successful search response"},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Search Web Content","tags":["default"],"x-aisa-capabilities":{"idempotency":"Idempotency-Key","max_price":"X-AISA-Max-Price-USD","mpp":false,"mpp_methods":[],"quote":{"header":"X-AISA-Cost-Mode","value":"quote"},"x402":false},"x-aisa-catalog-id":"scholar","x-aisa-category":"6","x-aisa-docs-url":"https://aisa.one/docs/api-reference/scholar/post_scholar-search-web","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"fixed_success","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.01,"estimate_source":"profile_seed","evidence_source":"request_snapshot"},"x-aisa-query-policy":{"ignore_undeclared":false,"request_wins":true},"x-aisa-response-source":{"content_hash":"sha256:66c0f41cb361d4074c91498315e0dcbb46eebb3d94b694d7c89a3074a2bf87e5","kind":"upstream_success_contract","source":{"content_hash":"sha256:344cbd3ae2de5312a40328dadd67b2a426a96be33f21a6eb7782bf330d28aba7","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:66c781477d09309828b8ef02e760671252531c5445ea4257c764f2ba4f96ddad","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/platform-txyz-openapi.json"}},"x-aisa-revision":{"customer_pricing_ref":"915dc59f87b4","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"219b5c4f138f"},"x-aisa-runtime-operation":{"method":"ANY","operation_id":"post_scholar_search_web","path":"/apis/v1/scholar/search/web"},"x-aisa-source":{"content_hash":"sha256:344cbd3ae2de5312a40328dadd67b2a426a96be33f21a6eb7782bf330d28aba7","converter":"scripts/import_existing_contracts.py@1","fetched_at":"2026-09-29T21:25:55+08:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:66c781477d09309828b8ef02e760671252531c5445ea4257c764f2ba4f96ddad","refresh_policy":"manual","review_period_days":30,"url":"https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/platform-txyz-openapi.json"},"x-aisa-status":"enabled","x-aisa-upstream-path":"/v1/search/web","x-aisa-validation":"provider"}}},"security":[{"bearerAuth":[]}],"servers":[{"url":"https://api.aisa.one"}]}