{
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    },
    "schemas": {
      "Manual576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH": {
        "type": "object",
        "required": [
          "query"
        ],
        "properties": {
          "count": {
            "type": "integer",
            "default": 10,
            "maximum": 20,
            "minimum": 1,
            "description": "Maximum number of search results to return per section (web/news). Valid range: 1-20."
          },
          "query": {
            "type": "string",
            "examples": [
              "How to sleep early",
              "Python programming tutorial",
              "climate change news"
            ],
            "description": "Search query string. Supports search operators for refined searches."
          },
          "offset": {
            "type": "integer",
            "default": 0,
            "maximum": 9,
            "minimum": 0,
            "description": "Pagination offset in multiples of count. For example, if count=10 and offset=1, returns results 10-20. Valid range: 0-9."
          },
          "country": {
            "type": "string",
            "examples": [
              "US",
              "GB",
              "CA",
              "AU",
              "DE",
              "FR",
              "JP",
              "IN",
              "BR",
              "MX"
            ],
            "description": "Country code for localized results (ISO 3166-1 alpha-2 format)."
          },
          "language": {
            "type": "string",
            "examples": [
              "EN",
              "FR",
              "DE",
              "ES",
              "ZH-HANS",
              "JA"
            ],
            "description": "Language code in BCP 47 format (e.g., EN, FR, DE, ES, ZH-HANS, JA)."
          },
          "freshness": {
            "type": "string",
            "examples": [
              "day",
              "week",
              "month",
              "2024-01-01to2024-12-31"
            ],
            "description": "Filter results by recency. Options: 'day', 'week', 'month', 'year', or date range in format 'YYYY-MM-DDtoYYYY-MM-DD'."
          },
          "safesearch": {
            "type": "string",
            "examples": [
              "off",
              "moderate",
              "strict"
            ],
            "description": "Content filtering level. Options: 'off', 'moderate', 'strict'."
          }
        }
      },
      "Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__public_data": {
        "$ref": "#/components/schemas/Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__b5a843f787d810d8"
      },
      "Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__b5a843f787d810d8": {
        "type": "object",
        "required": [
          "results"
        ],
        "properties": {
          "results": {
            "$ref": "#/components/schemas/Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__1545ff2d46542f8e"
          },
          "metadata": {
            "$ref": "#/components/schemas/Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__44b3ef276bbe62b1"
          }
        }
      },
      "Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__1545ff2d46542f8e": {
        "type": "object",
        "properties": {
          "web": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__d82e15be136065ea"
            }
          },
          "news": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__5b461eaa06fa0d02"
            }
          }
        }
      },
      "Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__d82e15be136065ea": {
        "type": "object",
        "required": [
          "url",
          "title",
          "description"
        ],
        "properties": {
          "url": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "authors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "page_age": {
            "type": "string"
          },
          "snippets": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "description": {
            "type": "string"
          },
          "favicon_url": {
            "type": "string"
          },
          "thumbnail_url": {
            "type": "string"
          }
        }
      },
      "Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__5b461eaa06fa0d02": {
        "type": "object",
        "required": [
          "url",
          "title",
          "description"
        ],
        "properties": {
          "url": {
            "type": "string"
          },
          "title": {
            "type": "string"
          },
          "page_age": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "thumbnail_url": {
            "type": "string"
          }
        }
      },
      "Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__44b3ef276bbe62b1": {
        "type": "object",
        "properties": {
          "query": {
            "type": "string"
          },
          "latency": {
            "type": "number"
          },
          "search_uuid": {
            "type": "string"
          }
        }
      }
    },
    "responses": {},
    "parameters": {},
    "examples": {},
    "requestBodies": {},
    "headers": {},
    "links": {},
    "callbacks": {},
    "pathItems": {}
  },
  "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-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": {
      "facts_hash": "2854e92a22d99e01078c6b9c27a10c34f63b9ee6752791254b07e997291a8727",
      "generator_version": "3",
      "protocol_version": "1",
      "schema_version": "1",
      "composer_version": "28",
      "response_pending": [
        {
          "operation_id": "you-com.web-answer",
          "path": "/apis/v1/you-com/web-answer",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        {
          "operation_id": "you-com.web-contents",
          "path": "/apis/v1/you-com/web-contents",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        {
          "operation_id": "you-com.web-search",
          "path": "/apis/v1/you-com/web-search",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        }
      ],
      "document_hash": "sha256:0f0f0ef8f1c0c8e3f6a859f2348c126661bbfca2ac35234aebb60c54bd5b230a"
    },
    "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",
    "x-aisa-catalogs": {
      "you-com": {
        "title": "You.com",
        "description": "",
        "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-capabilities": {
          "idempotency": "Idempotency-Key",
          "max_price": "X-AISA-Max-Price-USD",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          }
        }
      }
    }
  },
  "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema",
  "openapi": "3.1.0",
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "servers": [
    {
      "url": "https://api.aisa.one"
    }
  ],
  "paths": {
    "/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": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "query": {
                    "maxLength": 400,
                    "minLength": 1,
                    "type": "string",
                    "examples": [
                      "What is the purpose of example.com?"
                    ]
                  },
                  "freshness": {
                    "type": "string"
                  },
                  "country": {
                    "type": "string"
                  },
                  "language": {
                    "type": "string"
                  },
                  "safesearch": {
                    "type": "string",
                    "enum": [
                      false,
                      "moderate",
                      "strict"
                    ]
                  },
                  "include_domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 500
                  },
                  "exclude_domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 500
                  },
                  "boost_domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 500
                  }
                },
                "additionalProperties": false,
                "required": [
                  "query"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response"
          },
          "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",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": false,
          "mpp_methods": [],
          "x402": false
        },
        "x-aisa-category": "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-revision": {
          "customer_pricing_ref": "fda7874df42d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "3565a71b01ed"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "mixed",
        "x-aisa-catalog-id": "you-com",
        "x-aisa-runtime-operation": {
          "operation_id": "you-com.web-answer",
          "method": "POST",
          "path": "/apis/v1/you-com/web-answer"
        },
        "x-aisa-source": {
          "kind": "manual",
          "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/catalog/",
          "fetched_at": "2026-11-07T11:52:30.302332+00:00",
          "content_hash": "sha256:3ba9b222c7b0d3b69c4895ec21da5d6e6d8a55ffb2152b5d5c1a65bcc2973566",
          "raw_content_hash": "sha256:0804b46b6fb80c59d215e1ed43032d11e13328e2c2ade48d85c75ae00fd9cb68",
          "converter": "scripts/prepare_treg_public_reference.py@1",
          "path_space": "public",
          "refresh_policy": "pinned",
          "refresh_reason": "Review immutable provider declarations and both gateway HTTP boundaries together.",
          "source_git_revision": "95670bbae5561fce0ea55c1e0ee4216eb34cbf18",
          "source_pages": [
            {
              "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/application/call/resolve.py",
              "scope": "pathParams arrive as query; array enum and numeric bounds semantics"
            },
            {
              "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/domain/catalog/schema/common.py",
              "scope": "Parameter declaration vocabulary and optional required flag"
            }
          ],
          "qualification": "Request-only source review candidate. Exact declarations retained; unsupported shapes remain pending. No formal approval or response schema asserted.",
          "owner": "AIsa-team/docs",
          "review_period_days": 30,
          "policy_revision": "sha256:5284e1076511154e5bd27c88cf8f1f29cf6ca5b51a779bd931e39faa66f99978"
        },
        "x-aisa-response-pending": {
          "operation_id": "you-com.web-answer",
          "path": "/apis/v1/you-com/web-answer",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        "x-codeSamples": [
          {
            "lang": "text",
            "label": "Reference example",
            "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}'"
          }
        ],
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/you-com/you-com-web-answer"
      }
    },
    "/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": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "urls": {
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 100,
                    "minItems": 1,
                    "type": "array"
                  },
                  "formats": {
                    "type": "array",
                    "items": {
                      "type": "string",
                      "enum": [
                        "html",
                        "markdown",
                        "metadata"
                      ]
                    },
                    "examples": [
                      [
                        "markdown"
                      ]
                    ]
                  },
                  "crawl_timeout": {
                    "type": "integer",
                    "default": 10,
                    "minimum": 1,
                    "maximum": 60
                  },
                  "max_age": {
                    "type": "integer",
                    "minimum": 0,
                    "description": "Maximum age of cached content in seconds."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "urls"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response"
          },
          "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",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": false,
          "mpp_methods": [],
          "x402": false
        },
        "x-aisa-category": "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.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-revision": {
          "customer_pricing_ref": "fda7874df42d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "b64d0a715941"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "mixed",
        "x-aisa-catalog-id": "you-com",
        "x-aisa-runtime-operation": {
          "operation_id": "you-com.web-contents",
          "method": "POST",
          "path": "/apis/v1/you-com/web-contents"
        },
        "x-aisa-source": {
          "kind": "manual",
          "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/catalog/",
          "fetched_at": "2026-11-07T11:52:30.302332+00:00",
          "content_hash": "sha256:3ba9b222c7b0d3b69c4895ec21da5d6e6d8a55ffb2152b5d5c1a65bcc2973566",
          "raw_content_hash": "sha256:0804b46b6fb80c59d215e1ed43032d11e13328e2c2ade48d85c75ae00fd9cb68",
          "converter": "scripts/prepare_treg_public_reference.py@1",
          "path_space": "public",
          "refresh_policy": "pinned",
          "refresh_reason": "Review immutable provider declarations and both gateway HTTP boundaries together.",
          "source_git_revision": "95670bbae5561fce0ea55c1e0ee4216eb34cbf18",
          "source_pages": [
            {
              "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/application/call/resolve.py",
              "scope": "pathParams arrive as query; array enum and numeric bounds semantics"
            },
            {
              "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/domain/catalog/schema/common.py",
              "scope": "Parameter declaration vocabulary and optional required flag"
            }
          ],
          "qualification": "Request-only source review candidate. Exact declarations retained; unsupported shapes remain pending. No formal approval or response schema asserted.",
          "owner": "AIsa-team/docs",
          "review_period_days": 30,
          "policy_revision": "sha256:5284e1076511154e5bd27c88cf8f1f29cf6ca5b51a779bd931e39faa66f99978"
        },
        "x-aisa-response-pending": {
          "operation_id": "you-com.web-contents",
          "path": "/apis/v1/you-com/web-contents",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/you-com/you-com-web-contents"
      }
    },
    "/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": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "query": {
                    "minLength": 1,
                    "type": "string",
                    "examples": [
                      "site:example.com Example Domain"
                    ]
                  },
                  "count": {
                    "maximum": 100,
                    "minimum": 1,
                    "type": "integer",
                    "description": "Maximum per result section; web and news can each return this many.",
                    "examples": [
                      1
                    ]
                  },
                  "offset": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 9
                  },
                  "freshness": {
                    "type": "string",
                    "description": "day | week | month | year, or YYYY-MM-DDtoYYYY-MM-DD"
                  },
                  "country": {
                    "type": "string",
                    "description": "Supported country code."
                  },
                  "language": {
                    "type": "string",
                    "description": "Supported BCP 47 language tag."
                  },
                  "safesearch": {
                    "type": "string",
                    "enum": [
                      false,
                      "moderate",
                      "strict"
                    ]
                  },
                  "include_domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 500
                  },
                  "exclude_domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 500
                  },
                  "boost_domains": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "maxItems": 500
                  },
                  "knowledge": {
                    "type": "string",
                    "enum": [
                      "core"
                    ],
                    "description": "Include licensed structured results at no extra charge."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "count",
                  "query"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful response"
          },
          "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",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": false,
          "mpp_methods": [],
          "x402": false
        },
        "x-aisa-category": "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-revision": {
          "customer_pricing_ref": "fda7874df42d",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "93f79106f3e7"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "mixed",
        "x-aisa-catalog-id": "you-com",
        "x-aisa-runtime-operation": {
          "operation_id": "you-com.web-search",
          "method": "POST",
          "path": "/apis/v1/you-com/web-search"
        },
        "x-aisa-source": {
          "kind": "manual",
          "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/catalog/",
          "fetched_at": "2026-11-07T11:52:30.302332+00:00",
          "content_hash": "sha256:3ba9b222c7b0d3b69c4895ec21da5d6e6d8a55ffb2152b5d5c1a65bcc2973566",
          "raw_content_hash": "sha256:0804b46b6fb80c59d215e1ed43032d11e13328e2c2ade48d85c75ae00fd9cb68",
          "converter": "scripts/prepare_treg_public_reference.py@1",
          "path_space": "public",
          "refresh_policy": "pinned",
          "refresh_reason": "Review immutable provider declarations and both gateway HTTP boundaries together.",
          "source_git_revision": "95670bbae5561fce0ea55c1e0ee4216eb34cbf18",
          "source_pages": [
            {
              "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/application/call/resolve.py",
              "scope": "pathParams arrive as query; array enum and numeric bounds semantics"
            },
            {
              "url": "https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/domain/catalog/schema/common.py",
              "scope": "Parameter declaration vocabulary and optional required flag"
            }
          ],
          "qualification": "Request-only source review candidate. Exact declarations retained; unsupported shapes remain pending. No formal approval or response schema asserted.",
          "owner": "AIsa-team/docs",
          "review_period_days": 30,
          "policy_revision": "sha256:5284e1076511154e5bd27c88cf8f1f29cf6ca5b51a779bd931e39faa66f99978"
        },
        "x-aisa-response-pending": {
          "operation_id": "you-com.web-search",
          "path": "/apis/v1/you-com/web-search",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/you-com/you-com-web-search"
      }
    },
    "/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": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "required": [
                  "query"
                ],
                "properties": {
                  "count": {
                    "type": "integer",
                    "default": 10,
                    "maximum": 20,
                    "minimum": 1,
                    "description": "Maximum number of search results to return per section (web/news). Valid range: 1-20."
                  },
                  "query": {
                    "type": "string",
                    "examples": [
                      "How to sleep early",
                      "Python programming tutorial",
                      "climate change news"
                    ],
                    "description": "Search query string. Supports search operators for refined searches."
                  },
                  "offset": {
                    "type": "integer",
                    "default": 0,
                    "maximum": 9,
                    "minimum": 0,
                    "description": "Pagination offset in multiples of count. For example, if count=10 and offset=1, returns results 10-20. Valid range: 0-9."
                  },
                  "country": {
                    "type": "string",
                    "examples": [
                      "US",
                      "GB",
                      "CA",
                      "AU",
                      "DE",
                      "FR",
                      "JP",
                      "IN",
                      "BR",
                      "MX"
                    ],
                    "description": "Country code for localized results (ISO 3166-1 alpha-2 format)."
                  },
                  "language": {
                    "type": "string",
                    "examples": [
                      "EN",
                      "FR",
                      "DE",
                      "ES",
                      "ZH-HANS",
                      "JA"
                    ],
                    "description": "Language code in BCP 47 format (e.g., EN, FR, DE, ES, ZH-HANS, JA)."
                  },
                  "freshness": {
                    "type": "string",
                    "examples": [
                      "day",
                      "week",
                      "month",
                      "2024-01-01to2024-12-31"
                    ],
                    "description": "Filter results by recency. Options: 'day', 'week', 'month', 'year', or date range in format 'YYYY-MM-DDtoYYYY-MM-DD'."
                  },
                  "safesearch": {
                    "type": "string",
                    "examples": [
                      "off",
                      "moderate",
                      "strict"
                    ],
                    "description": "Content filtering level. Options: 'off', 'moderate', 'strict'."
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Tool result data",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Response576A0Ea506F3_connect_YOUSEARCH_YOU_SEARCH__output__public_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",
          "quote": {
            "header": "X-AISA-Cost-Mode",
            "value": "quote"
          },
          "mpp": false,
          "mpp_methods": [],
          "x402": false
        },
        "x-aisa-category": "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-revision": {
          "customer_pricing_ref": "541c4271fcd0",
          "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb",
          "profile_ref": "7006258efd88"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "provider",
        "x-aisa-catalog-id": "you-com",
        "x-aisa-runtime-operation": {
          "operation_id": "you-com.you-search",
          "method": "POST",
          "path": "/apis/v1/you-com/you-search"
        },
        "x-aisa-source": {
          "kind": "manual",
          "url": "https://connect.composio.dev/mcp",
          "fetched_at": "unknown: historical capture did not retain an acquisition timestamp",
          "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f",
          "converter": "scripts/prepare_composio_public_reference.py@1",
          "path_space": "public",
          "refresh_policy": "pinned",
          "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.",
          "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500",
          "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7",
          "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa",
          "source_pages": [
            {
              "url": "https://connect.composio.dev/mcp",
              "scope": "Captured input schemas only; no current-source review asserted"
            },
            {
              "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json",
              "scope": "Exact provider tool slug to public route mapping"
            },
            {
              "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go",
              "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/packages/composioconnect/workbench.go",
              "scope": "PublicResponse returns only the one completed tool response data as HTTP 200"
            }
          ],
          "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.",
          "owner": "AIsa-team/docs",
          "review_period_days": 30,
          "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da"
        },
        "x-aisa-response-source": {
          "kind": "upstream_success_contract",
          "source": {
            "kind": "manual",
            "url": "https://connect.composio.dev/mcp",
            "fetched_at": "unknown: historical capture did not retain an acquisition timestamp",
            "content_hash": "sha256:342defd4bbb364173f6f4dbfeeae2056fa539e0c0fd021df1d45b18d0003be5f",
            "converter": "scripts/prepare_composio_public_reference.py@1",
            "path_space": "public",
            "refresh_policy": "pinned",
            "refresh_reason": "Review captured provider argument schemas and the pinned owning HTTP request adapter together before replacement.",
            "source_git_revision": "3c55acbef31c1aae0648aaa48b0bc92184594500",
            "raw_content_hash": "sha256:f2b7e11cfb5bebbbe6dccf14f1e20bed99d24378de2ba765250101f592f999b7",
            "routes_content_hash": "sha256:60c8b6059312ec36d7cdfd57b8ee3d909da3c55d3956b408747b82fbc5f2d6aa",
            "source_pages": [
              {
                "url": "https://connect.composio.dev/mcp",
                "scope": "Captured input schemas only; no current-source review asserted"
              },
              {
                "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/packages/integrationcatalog/vendors.json",
                "scope": "Exact provider tool slug to public route mapping"
              },
              {
                "url": "https://raw.githubusercontent.com/AIsa-team/AIsaServices/3c55acbef31c1aae0648aaa48b0bc92184594500/services/api-service/internal/httpapi/integration_gateway_body.go",
                "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/packages/composioconnect/workbench.go",
                "scope": "PublicResponse returns only the one completed tool response data as HTTP 200"
              }
            ],
            "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.",
            "owner": "AIsa-team/docs",
            "review_period_days": 30,
            "policy_revision": "sha256:2eaa3a85fb7f3c50982c51dcede3aa2251e4f385404e955a0ee32072ef7f79da"
          },
          "content_hash": "sha256:008833ed4c207e366756009ef5fa9f8a6e36c78fe94c9ba2e4a7ac0e43bc7d9d"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/you-com/you-com-you-search"
      }
    }
  }
}
