{"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":"<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.11 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","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 <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"input\": \"example\",\n  \"research_effort\": \"deep\"\n}'"}]}},"/apis/v1/you-com/web-answer":{"post":{"description":"<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.005 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","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 <token>' \\\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":"<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.001 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","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":"<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.012 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","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 <token>' \\\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<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.005 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","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":"<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.005 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","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 <token>' \\\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":"<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.005 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","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 <token>' \\\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":"<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.0053 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","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"}]}