{ "components": { "callbacks": {}, "examples": {}, "headers": {}, "links": {}, "parameters": {}, "pathItems": {}, "requestBodies": {}, "responses": {}, "schemas": { "Manual576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH": { "properties": { "count": { "default": 10, "description": "Maximum number of search results to return per section (web/news). Valid range: 1-20.", "maximum": 20, "minimum": 1, "type": "integer" }, "country": { "description": "Country code for localized results (ISO 3166-1 alpha-2 format).", "examples": [ "US", "GB", "CA", "AU", "DE", "FR", "JP", "IN", "BR", "MX" ], "type": "string" }, "freshness": { "description": "Filter results by recency. Options: 'day', 'week', 'month', 'year', or date range in format 'YYYY-MM-DDtoYYYY-MM-DD'.", "examples": [ "day", "week", "month", "2024-01-01to2024-12-31" ], "type": "string" }, "language": { "description": "Language code in BCP 47 format (e.g., EN, FR, DE, ES, ZH-HANS, JA).", "examples": [ "EN", "FR", "DE", "ES", "ZH-HANS", "JA" ], "type": "string" }, "offset": { "default": 0, "description": "Pagination offset in multiples of count. For example, if count=10 and offset=1, returns results 10-20. Valid range: 0-9.", "maximum": 9, "minimum": 0, "type": "integer" }, "query": { "description": "Search query string. Supports search operators for refined searches.", "examples": [ "How to sleep early", "Python programming tutorial", "climate change news" ], "type": "string" }, "safesearch": { "description": "Content filtering level. Options: 'off', 'moderate', 'strict'.", "examples": [ "off", "moderate", "strict" ], "type": "string" } }, "required": [ "query" ], "type": "object" }, "Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__1545ff2d46542f8e": { "properties": { "news": { "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__5b461eaa06fa0d02" }, "type": "array" }, "web": { "items": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__d82e15be136065ea" }, "type": "array" } }, "type": "object" }, "Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__44b3ef276bbe62b1": { "properties": { "latency": { "type": "number" }, "query": { "type": "string" }, "search_uuid": { "type": "string" } }, "type": "object" }, "Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__5b461eaa06fa0d02": { "properties": { "description": { "type": "string" }, "page_age": { "type": "string" }, "thumbnail_url": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" } }, "required": [ "url", "title", "description" ], "type": "object" }, "Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__b5a843f787d810d8": { "properties": { "metadata": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__44b3ef276bbe62b1" }, "results": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__1545ff2d46542f8e" } }, "required": [ "results" ], "type": "object" }, "Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__d82e15be136065ea": { "properties": { "authors": { "items": { "type": "string" }, "type": "array" }, "description": { "type": "string" }, "favicon_url": { "type": "string" }, "page_age": { "type": "string" }, "snippets": { "items": { "type": "string" }, "type": "array" }, "thumbnail_url": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" } }, "required": [ "url", "title", "description" ], "type": "object" }, "Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__public_data": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__b5a843f787d810d8" } }, "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } }, "info": { "description": "", "title": "You.com", "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": { "you-com": { "description": "", "title": "You.com", "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": "2854e92a22d99e01078c6b9c27a10c34f63b9ee6752791254b07e997291a8727", "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/you-com/finance-research", "/apis/v1/you-com/web-answer", "/apis/v1/you-com/web-contents", "/apis/v1/you-com/web-research", "/apis/v1/you-com/web-search", "/apis/v1/you-com/web-search-full-page-cache", "/apis/v1/you-com/web-search-highlights", "/apis/v1/you-com/you-search" ], "x-aisa-document": { "composer_version": "28", "document_hash": "sha256:0313ea4a7855dd08b342cc73c879ce1ef57b48317e40bad027964bc1308287cc", "facts_hash": "2854e92a22d99e01078c6b9c27a10c34f63b9ee6752791254b07e997291a8727", "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": "you-com" }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "paths": { "/apis/v1/you-com/finance-research": { "post": { "description": "\n按用量计费；默认请求预估费用：$0.11 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "you-com.finance-research", "requestBody": { "content": { "application/json": { "examples": { "default": { "value": { "input": "example", "research_effort": "deep" } }, "minimal": { "value": { "input": "example", "research_effort": "deep" } } }, "schema": { "additionalProperties": true, "properties": { "input": { "maxLength": 40000, "minLength": 1, "type": "string" }, "research_effort": { "enum": [ "deep" ], "minLength": 1, "type": "string" } }, "required": [ "input", "research_effort" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful response. The payload schema has not been reviewed yet." }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Research a financial question", "tags": [ "You.com" ], "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": "you-com", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/you-com/you-com-finance-research", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.11, "estimate_source": "profile_seed", "evidence_source": "response_header", "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "open_query": true, "request_wins": false }, "x-aisa-review": { "request": "runtime_binding", "response": "generic", "status": "unreviewed" }, "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "f32b643314ac" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "you-com.finance-research", "path": "/apis/v1/you-com/finance-research" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-codeSamples": [ { "label": "Reference example", "lang": "text", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/you-com/finance-research \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"input\": \"example\",\n \"research_effort\": \"deep\"\n}'" } ] } }, "/apis/v1/you-com/web-answer": { "post": { "description": "\n按用量计费；默认请求预估费用：$0.005 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "you-com.web-answer", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "boost_domains": { "items": { "type": "string" }, "maxItems": 500, "type": "array" }, "country": { "type": "string" }, "exclude_domains": { "items": { "type": "string" }, "maxItems": 500, "type": "array" }, "freshness": { "type": "string" }, "include_domains": { "items": { "type": "string" }, "maxItems": 500, "type": "array" }, "language": { "type": "string" }, "query": { "examples": [ "What is the purpose of example.com?" ], "maxLength": 400, "minLength": 1, "type": "string" }, "safesearch": { "enum": [ false, "moderate", "strict" ], "type": "string" } }, "required": [ "query" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful response. The payload schema has not been reviewed yet." }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Answer a web question", "tags": [ "You.com" ], "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": "you-com", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/you-com/you-com-web-answer", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.005, "estimate_source": "profile_seed", "evidence_source": "response_header", "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "open_query": true, "request_wins": false }, "x-aisa-review": { "request": "reviewed_source", "response": "generic", "status": "unreviewed" }, "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "3565a71b01ed" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "you-com.web-answer", "path": "/apis/v1/you-com/web-answer" }, "x-aisa-source": { "content_hash": "sha256:3ba9b222c7b0d3b69c4895ec21da5d6e6d8a55ffb2152b5d5c1a65bcc2973566", "converter": "scripts/prepare_treg_public_reference.py@1", "fetched_at": "2026-11-07T11:52:30.302332+00:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:5284e1076511154e5bd27c88cf8f1f29cf6ca5b51a779bd931e39faa66f99978", "qualification": "Request-only source review candidate. Exact declarations retained; unsupported shapes remain pending. No formal approval or response schema asserted.", "raw_content_hash": "sha256:0804b46b6fb80c59d215e1ed43032d11e13328e2c2ade48d85c75ae00fd9cb68", "refresh_policy": "pinned", "refresh_reason": "Review immutable provider declarations and both gateway HTTP boundaries together.", "review_period_days": 30, "source_git_revision": "95670bbae5561fce0ea55c1e0ee4216eb34cbf18", "source_pages": [ { "scope": "pathParams arrive as query; array enum and numeric bounds semantics", "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/application/call/resolve.py" }, { "scope": "Parameter declaration vocabulary and optional required flag", "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/domain/catalog/schema/common.py" } ], "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/catalog/" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-codeSamples": [ { "label": "Reference example", "lang": "text", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/you-com/web-answer \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"query\": \"What is the purpose of example.com?\"\n}'" } ] } }, "/apis/v1/you-com/web-contents": { "post": { "description": "\n按用量计费；默认请求预估费用：$0.001 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "you-com.web-contents", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "crawl_timeout": { "default": 10, "maximum": 60, "minimum": 1, "type": "integer" }, "formats": { "examples": [ [ "markdown" ] ], "items": { "enum": [ "html", "markdown", "metadata" ], "type": "string" }, "type": "array" }, "max_age": { "description": "Maximum age of cached content in seconds.", "minimum": 0, "type": "integer" }, "urls": { "items": { "type": "string" }, "maxItems": 100, "minItems": 1, "type": "array" } }, "required": [ "urls" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful response. The payload schema has not been reviewed yet." }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Extract page content", "tags": [ "You.com" ], "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": "you-com", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/you-com/you-com-web-contents", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.001, "estimate_source": "profile_seed", "evidence_source": "response_header", "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "open_query": true, "request_wins": false }, "x-aisa-review": { "request": "reviewed_source", "response": "generic", "status": "unreviewed" }, "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "b64d0a715941" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "you-com.web-contents", "path": "/apis/v1/you-com/web-contents" }, "x-aisa-source": { "content_hash": "sha256:3ba9b222c7b0d3b69c4895ec21da5d6e6d8a55ffb2152b5d5c1a65bcc2973566", "converter": "scripts/prepare_treg_public_reference.py@1", "fetched_at": "2026-11-07T11:52:30.302332+00:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:5284e1076511154e5bd27c88cf8f1f29cf6ca5b51a779bd931e39faa66f99978", "qualification": "Request-only source review candidate. Exact declarations retained; unsupported shapes remain pending. No formal approval or response schema asserted.", "raw_content_hash": "sha256:0804b46b6fb80c59d215e1ed43032d11e13328e2c2ade48d85c75ae00fd9cb68", "refresh_policy": "pinned", "refresh_reason": "Review immutable provider declarations and both gateway HTTP boundaries together.", "review_period_days": 30, "source_git_revision": "95670bbae5561fce0ea55c1e0ee4216eb34cbf18", "source_pages": [ { "scope": "pathParams arrive as query; array enum and numeric bounds semantics", "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/application/call/resolve.py" }, { "scope": "Parameter declaration vocabulary and optional required flag", "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/domain/catalog/schema/common.py" } ], "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/catalog/" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed" } }, "/apis/v1/you-com/web-research": { "post": { "description": "\n按用量计费；默认请求预估费用：$0.012 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "you-com.web-research", "requestBody": { "content": { "application/json": { "examples": { "default": { "value": { "input": "example", "research_effort": "lite" } }, "minimal": { "value": { "input": "example", "research_effort": "lite" } } }, "schema": { "additionalProperties": true, "properties": { "input": { "maxLength": 40000, "minLength": 1, "type": "string" }, "research_effort": { "enum": [ "lite", "standard" ], "minLength": 1, "type": "string" } }, "required": [ "input", "research_effort" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful response. The payload schema has not been reviewed yet." }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Research a web question", "tags": [ "You.com" ], "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": "you-com", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/you-com/you-com-web-research", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.012, "estimate_source": "profile_seed", "evidence_source": "response_header", "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "open_query": true, "request_wins": false }, "x-aisa-review": { "request": "runtime_binding", "response": "generic", "status": "unreviewed" }, "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7f3163815a6d" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "you-com.web-research", "path": "/apis/v1/you-com/web-research" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-codeSamples": [ { "label": "Reference example", "lang": "text", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/you-com/web-research \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"input\": \"example\",\n \"research_effort\": \"lite\"\n}'" } ] } }, "/apis/v1/you-com/web-search": { "post": { "description": "For query-focused passages use you.web.search.highlights. Full-page extraction has separate cache-only and BYOK live catalog tools.\n\n\n按用量计费；默认请求预估费用：$0.005 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "you-com.web-search", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "boost_domains": { "items": { "type": "string" }, "maxItems": 500, "type": "array" }, "count": { "description": "Maximum per result section; web and news can each return this many.", "examples": [ 1 ], "maximum": 100, "minimum": 1, "type": "integer" }, "country": { "description": "Supported country code.", "type": "string" }, "exclude_domains": { "items": { "type": "string" }, "maxItems": 500, "type": "array" }, "freshness": { "description": "day | week | month | year, or YYYY-MM-DDtoYYYY-MM-DD", "type": "string" }, "include_domains": { "items": { "type": "string" }, "maxItems": 500, "type": "array" }, "knowledge": { "description": "Include licensed structured results at no extra charge.", "enum": [ "core" ], "type": "string" }, "language": { "description": "Supported BCP 47 language tag.", "type": "string" }, "offset": { "maximum": 9, "minimum": 0, "type": "integer" }, "query": { "examples": [ "site:example.com Example Domain" ], "minLength": 1, "type": "string" }, "safesearch": { "enum": [ false, "moderate", "strict" ], "type": "string" } }, "required": [ "count", "query" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful response. The payload schema has not been reviewed yet." }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search the web and news", "tags": [ "You.com" ], "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": "you-com", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/you-com/you-com-web-search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.005, "estimate_source": "profile_seed", "evidence_source": "response_header", "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "open_query": true, "request_wins": false }, "x-aisa-review": { "request": "reviewed_source", "response": "generic", "status": "unreviewed" }, "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "93f79106f3e7" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "you-com.web-search", "path": "/apis/v1/you-com/web-search" }, "x-aisa-source": { "content_hash": "sha256:3ba9b222c7b0d3b69c4895ec21da5d6e6d8a55ffb2152b5d5c1a65bcc2973566", "converter": "scripts/prepare_treg_public_reference.py@1", "fetched_at": "2026-11-07T11:52:30.302332+00:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:5284e1076511154e5bd27c88cf8f1f29cf6ca5b51a779bd931e39faa66f99978", "qualification": "Request-only source review candidate. Exact declarations retained; unsupported shapes remain pending. No formal approval or response schema asserted.", "raw_content_hash": "sha256:0804b46b6fb80c59d215e1ed43032d11e13328e2c2ade48d85c75ae00fd9cb68", "refresh_policy": "pinned", "refresh_reason": "Review immutable provider declarations and both gateway HTTP boundaries together.", "review_period_days": 30, "source_git_revision": "95670bbae5561fce0ea55c1e0ee4216eb34cbf18", "source_pages": [ { "scope": "pathParams arrive as query; array enum and numeric bounds semantics", "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/application/call/resolve.py" }, { "scope": "Parameter declaration vocabulary and optional required flag", "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/domain/catalog/schema/common.py" } ], "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/catalog/" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed" } }, "/apis/v1/you-com/web-search-full-page-cache": { "post": { "description": "\n按用量计费；默认请求预估费用：$0.005 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "you-com.web-search-full-page-cache", "requestBody": { "content": { "application/json": { "examples": { "default": { "value": { "count": 1, "extraction": { "extraction_mode": "full_page", "extraction_source": "cache" }, "query": "nike" } }, "minimal": { "value": { "count": 1, "extraction": { "extraction_mode": "full_page", "extraction_source": "cache" }, "query": "nike" } } }, "schema": { "additionalProperties": true, "properties": { "count": { "maximum": 100, "minimum": 1, "type": "integer" }, "extraction": { "additionalProperties": true, "properties": { "extraction_mode": { "enum": [ "full_page" ], "minLength": 1, "type": "string" }, "extraction_source": { "enum": [ "cache" ], "minLength": 1, "type": "string" } }, "required": [ "extraction_mode", "extraction_source" ], "type": "object" }, "query": { "minLength": 1, "type": "string" } }, "required": [ "count", "extraction", "query" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful response. The payload schema has not been reviewed yet." }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search with cached page text", "tags": [ "You.com" ], "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": "you-com", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/you-com/you-com-web-search-full-page-cache", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.005, "estimate_source": "profile_seed", "evidence_source": "response_header", "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "open_query": true, "request_wins": false }, "x-aisa-review": { "request": "runtime_binding", "response": "generic", "status": "unreviewed" }, "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "5fd5684a583e" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "you-com.web-search-full-page-cache", "path": "/apis/v1/you-com/web-search-full-page-cache" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-codeSamples": [ { "label": "Reference example", "lang": "text", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/you-com/web-search-full-page-cache \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"count\": 1,\n \"extraction\": {\n \"extraction_mode\": \"full_page\",\n \"extraction_source\": \"cache\"\n },\n \"query\": \"nike\"\n}'" } ] } }, "/apis/v1/you-com/web-search-highlights": { "post": { "description": "\n按用量计费；默认请求预估费用：$0.005 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "you-com.web-search-highlights", "requestBody": { "content": { "application/json": { "examples": { "default": { "value": { "count": 1, "extraction": { "extraction_mode": "highlights" }, "query": "nike" } }, "minimal": { "value": { "count": 1, "extraction": { "extraction_mode": "highlights" }, "query": "nike" } } }, "schema": { "additionalProperties": true, "properties": { "count": { "maximum": 50, "minimum": 1, "type": "integer" }, "extraction": { "additionalProperties": true, "properties": { "extraction_mode": { "enum": [ "highlights" ], "minLength": 1, "type": "string" } }, "required": [ "extraction_mode" ], "type": "object" }, "query": { "minLength": 1, "type": "string" } }, "required": [ "count", "extraction", "query" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": {} } }, "description": "Successful response. The payload schema has not been reviewed yet." }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Search with page highlights", "tags": [ "You.com" ], "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": "you-com", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/you-com/you-com-web-search-highlights", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.005, "estimate_source": "profile_seed", "evidence_source": "response_header", "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "open_query": true, "request_wins": false }, "x-aisa-review": { "request": "runtime_binding", "response": "generic", "status": "unreviewed" }, "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0822fd545037" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "you-com.web-search-highlights", "path": "/apis/v1/you-com/web-search-highlights" }, "x-aisa-status": "enabled", "x-aisa-validation": "mixed", "x-codeSamples": [ { "label": "Reference example", "lang": "text", "source": "# Fixed reference example. Playground inputs do not update this sample.\ncurl --request POST \\\n --url https://api.aisa.one/apis/v1/you-com/web-search-highlights \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"count\": 1,\n \"extraction\": {\n \"extraction_mode\": \"highlights\"\n },\n \"query\": \"nike\"\n}'" } ] } }, "/apis/v1/you-com/you-search": { "post": { "description": "\n按用量计费；默认请求预估费用：$0.0053 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "you-com.you-search", "requestBody": { "content": { "application/json": { "schema": { "properties": { "count": { "default": 10, "description": "Maximum number of search results to return per section (web/news). Valid range: 1-20.", "maximum": 20, "minimum": 1, "type": "integer" }, "country": { "description": "Country code for localized results (ISO 3166-1 alpha-2 format).", "examples": [ "US", "GB", "CA", "AU", "DE", "FR", "JP", "IN", "BR", "MX" ], "type": "string" }, "freshness": { "description": "Filter results by recency. Options: 'day', 'week', 'month', 'year', or date range in format 'YYYY-MM-DDtoYYYY-MM-DD'.", "examples": [ "day", "week", "month", "2024-01-01to2024-12-31" ], "type": "string" }, "language": { "description": "Language code in BCP 47 format (e.g., EN, FR, DE, ES, ZH-HANS, JA).", "examples": [ "EN", "FR", "DE", "ES", "ZH-HANS", "JA" ], "type": "string" }, "offset": { "default": 0, "description": "Pagination offset in multiples of count. For example, if count=10 and offset=1, returns results 10-20. Valid range: 0-9.", "maximum": 9, "minimum": 0, "type": "integer" }, "query": { "description": "Search query string. Supports search operators for refined searches.", "examples": [ "How to sleep early", "Python programming tutorial", "climate change news" ], "type": "string" }, "safesearch": { "description": "Content filtering level. Options: 'off', 'moderate', 'strict'.", "examples": [ "off", "moderate", "strict" ], "type": "string" } }, "required": [ "query" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "$ref": "#/components/schemas/Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__public_data" } } }, "description": "Tool result data" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "You.com Web Search", "tags": [ "You.com" ], "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": "you-com", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/you-com/you-com-you-search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.0053, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 10000000, "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-source": { "content_hash": "sha256:008833ed4c207e366756009ef5fa9f8a6e36c78fe94c9ba2e4a7ac0e43bc7d9d", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da", "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "review_period_days": 30, "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "source_pages": [ { "scope": "Captured input schemas only; no current-source review asserted", "url": "https://connect.composio.dev/mcp" }, { "scope": "Exact provider tool slug to public route mapping", "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json" }, { "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input", "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go" }, { "scope": "PublicResponse returns only the one completed tool response data as HTTP 200", "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go" } ], "url": "https://connect.composio.dev/mcp" } }, "x-aisa-revision": { "customer_pricing_ref": "541c4271fcd0", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7006258efd88" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "you-com.you-search", "path": "/apis/v1/you-com/you-search" }, "x-aisa-source": { "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f", "converter": "scripts/prepare_composio_public_reference.py@1", "fetched_at": "unknown: historical capture did not retain an acquisition timestamp", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da", "qualification": "Historical pinned metadata conversion requiring independent source review. Public responses project the declared data property through the fixed HTTP adapter. No live acquisition or formal approval asserted.", "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7", "refresh_policy": "pinned", "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.", "review_period_days": 30, "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa", "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500", "source_pages": [ { "scope": "Captured input schemas only; no current-source review asserted", "url": "https://connect.composio.dev/mcp" }, { "scope": "Exact provider tool slug to public route mapping", "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json" }, { "scope": "wrapGatewayBody: caller root arguments are wrapped internally; the internal envelope is not a public input", "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go" }, { "scope": "PublicResponse returns only the one completed tool response data as HTTP 200", "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/composioconnect/workbench.go" } ], "url": "https://connect.composio.dev/mcp" }, "x-aisa-status": "enabled", "x-aisa-validation": "provider" } } }, "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://api.aisa.one" } ] }