{
  "components": {
    "securitySchemes": {
      "bearerAuth": {
        "scheme": "bearer",
        "type": "http"
      }
    },
    "schemas": {},
    "responses": {},
    "parameters": {},
    "examples": {},
    "requestBodies": {},
    "headers": {},
    "links": {},
    "callbacks": {},
    "pathItems": {}
  },
  "info": {
    "description": "",
    "title": "Search1API",
    "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/search1api/web-crawl",
      "/apis/v1/search1api/web-extract-structured",
      "/apis/v1/search1api/web-news",
      "/apis/v1/search1api/web-screenshot",
      "/apis/v1/search1api/web-search",
      "/apis/v1/search1api/web-sitemap",
      "/apis/v1/search1api/web-trending"
    ],
    "x-aisa-document": {
      "facts_hash": "5d3c11d91fe5c1a8efbc9c528d4c5728aa68d05f1d980109f4a35d8ef3927a06",
      "generator_version": "3",
      "protocol_version": "1",
      "schema_version": "1",
      "composer_version": "28",
      "response_pending": [
        {
          "operation_id": "search1api.web-crawl",
          "path": "/apis/v1/search1api/web-crawl",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        {
          "operation_id": "search1api.web-news",
          "path": "/apis/v1/search1api/web-news",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        {
          "operation_id": "search1api.web-screenshot",
          "path": "/apis/v1/search1api/web-screenshot",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        {
          "operation_id": "search1api.web-search",
          "path": "/apis/v1/search1api/web-search",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        {
          "operation_id": "search1api.web-sitemap",
          "path": "/apis/v1/search1api/web-sitemap",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        {
          "operation_id": "search1api.web-trending",
          "path": "/apis/v1/search1api/web-trending",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        }
      ],
      "document_hash": "sha256:f7e17551ebfa2c5a538aff75ee128639adf225f680f0bf3a5337e8fb9641dbf6"
    },
    "x-aisa-plans": {
      "builder": 1.0,
      "display_plan": "payg",
      "payg": 1.0,
      "similarweb_payg": 1.0,
      "team": 1.0,
      "version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb"
    },
    "x-aisa-provider": "search1api",
    "x-aisa-catalogs": {
      "search1api": {
        "title": "Search1API",
        "description": "",
        "x-aisa-document": {
          "facts_hash": "5d3c11d91fe5c1a8efbc9c528d4c5728aa68d05f1d980109f4a35d8ef3927a06",
          "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/search1api/web-crawl": {
      "post": {
        "description": "A target page's 404 or 410 costs Search1API one credit; treg cannot prove that charge from the error body, so its shared tier absorbs it.\n\n<!-- aisa-pricing:start -->\n按用量计费；默认请求预估费用：$0.001 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n<!-- aisa-pricing:end -->",
        "operationId": "search1api.web-crawl",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "minLength": 1,
                    "type": "string"
                  },
                  "enableFallback": {
                    "type": "boolean",
                    "default": true
                  }
                },
                "additionalProperties": false,
                "required": [
                  "url"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Read a web page",
        "tags": [
          "Search1API"
        ],
        "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": "03cc4525efe1"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "mixed",
        "x-aisa-catalog-id": "search1api",
        "x-aisa-runtime-operation": {
          "operation_id": "search1api.web-crawl",
          "method": "POST",
          "path": "/apis/v1/search1api/web-crawl"
        },
        "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": "search1api.web-crawl",
          "path": "/apis/v1/search1api/web-crawl",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search1api/search1api-web-crawl"
      }
    },
    "/apis/v1/search1api/web-news": {
      "post": {
        "description": "Single query without result crawling; a team's raw tool can send batch requests.\n\n<!-- aisa-pricing:start -->\n按用量计费；默认请求预估费用：$0.001 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n<!-- aisa-pricing:end -->",
        "operationId": "search1api.web-news",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "query": {
                    "minLength": 1,
                    "type": "string",
                    "examples": [
                      "OpenAI"
                    ]
                  },
                  "search_service": {
                    "type": "string",
                    "enum": [
                      "google",
                      "bing",
                      "duckduckgo",
                      "yahoo",
                      "hackernews",
                      "reuters"
                    ]
                  },
                  "max_results": {
                    "maximum": 50,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "image": {
                    "type": "boolean",
                    "default": false
                  },
                  "include_sites": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "exclude_sites": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "language": {
                    "type": "string"
                  },
                  "time_range": {
                    "type": "string",
                    "enum": [
                      "day",
                      "week",
                      "month",
                      "year"
                    ]
                  }
                },
                "additionalProperties": false,
                "required": [
                  "max_results",
                  "query"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Search recent news",
        "tags": [
          "Search1API"
        ],
        "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": "db25c5e71d04"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "mixed",
        "x-aisa-catalog-id": "search1api",
        "x-aisa-runtime-operation": {
          "operation_id": "search1api.web-news",
          "method": "POST",
          "path": "/apis/v1/search1api/web-news"
        },
        "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": "search1api.web-news",
          "path": "/apis/v1/search1api/web-news",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search1api/search1api-web-news"
      }
    },
    "/apis/v1/search1api/web-screenshot": {
      "post": {
        "description": "Success returns image bytes; use a binary-capable client. Full-page and selector cannot both be set.\n\n<!-- aisa-pricing:start -->\n按用量计费；默认请求预估费用：$0.002 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n<!-- aisa-pricing:end -->",
        "operationId": "search1api.web-screenshot",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "minLength": 1,
                    "type": "string"
                  },
                  "format": {
                    "type": "string",
                    "default": "png",
                    "enum": [
                      "png",
                      "jpeg",
                      "webp"
                    ]
                  },
                  "full_page": {
                    "type": "boolean",
                    "default": false
                  },
                  "viewport": {
                    "type": "object",
                    "properties": {
                      "width": {
                        "type": "integer",
                        "default": 1440,
                        "minimum": 320,
                        "maximum": 2560
                      },
                      "height": {
                        "type": "integer",
                        "default": 900,
                        "minimum": 200,
                        "maximum": 1440
                      },
                      "device_scale_factor": {
                        "type": "number",
                        "default": 1,
                        "minimum": 1,
                        "maximum": 2
                      }
                    },
                    "description": "Browser viewport object ({width, height, device_scale_factor}); omit for provider defaults."
                  },
                  "wait_until": {
                    "type": "string",
                    "enum": [
                      "domcontentloaded",
                      "load",
                      "networkidle"
                    ]
                  },
                  "wait_for_selector": {
                    "type": "string"
                  },
                  "selector": {
                    "type": "string",
                    "description": "Cannot be combined with full_page."
                  },
                  "delay_ms": {
                    "type": "integer",
                    "minimum": 0,
                    "maximum": 5000
                  },
                  "timeout_ms": {
                    "type": "integer",
                    "minimum": 1000,
                    "maximum": 30000
                  },
                  "quality": {
                    "type": "integer",
                    "minimum": 1,
                    "maximum": 100
                  },
                  "omit_background": {
                    "type": "boolean"
                  },
                  "color_scheme": {
                    "type": "string",
                    "enum": [
                      "light",
                      "dark"
                    ]
                  },
                  "animations": {
                    "type": "string",
                    "enum": [
                      "disabled",
                      "allow"
                    ]
                  }
                },
                "additionalProperties": false,
                "required": [
                  "url"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Capture a web page",
        "tags": [
          "Search1API"
        ],
        "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.002,
          "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": "0539bca30e88"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "mixed",
        "x-aisa-catalog-id": "search1api",
        "x-aisa-runtime-operation": {
          "operation_id": "search1api.web-screenshot",
          "method": "POST",
          "path": "/apis/v1/search1api/web-screenshot"
        },
        "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": "search1api.web-screenshot",
          "path": "/apis/v1/search1api/web-screenshot",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search1api/search1api-web-screenshot"
      }
    },
    "/apis/v1/search1api/web-search": {
      "post": {
        "description": "Single search only. Full-page result crawling uses the BYOK tool because its successful-page charge is not reported per call.\n\n<!-- aisa-pricing:start -->\n按用量计费；默认请求预估费用：$0.001 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n<!-- aisa-pricing:end -->",
        "operationId": "search1api.web-search",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "query": {
                    "minLength": 1,
                    "type": "string",
                    "examples": [
                      "site:example.com Example Domain"
                    ]
                  },
                  "search_service": {
                    "type": "string",
                    "enum": [
                      "google",
                      "bing",
                      "bingcn",
                      "duckduckgo",
                      "yahoo",
                      "yandex",
                      "youtube",
                      "x",
                      "reddit",
                      "github",
                      "arxiv",
                      "wechat",
                      "bilibili",
                      "imdb",
                      "wikipedia",
                      "baidu",
                      "360",
                      "quark"
                    ]
                  },
                  "max_results": {
                    "maximum": 50,
                    "minimum": 1,
                    "type": "integer"
                  },
                  "page": {
                    "type": "integer",
                    "default": 1,
                    "minimum": 1,
                    "maximum": 100,
                    "description": "Only some engines support pagination."
                  },
                  "image": {
                    "type": "boolean",
                    "default": false
                  },
                  "include_sites": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "exclude_sites": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "language": {
                    "type": "string"
                  },
                  "time_range": {
                    "type": "string",
                    "enum": [
                      "day",
                      "week",
                      "month",
                      "year"
                    ]
                  }
                },
                "additionalProperties": false,
                "required": [
                  "max_results",
                  "query"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Search the live web",
        "tags": [
          "Search1API"
        ],
        "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": "247d1250ba91"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "mixed",
        "x-aisa-catalog-id": "search1api",
        "x-aisa-runtime-operation": {
          "operation_id": "search1api.web-search",
          "method": "POST",
          "path": "/apis/v1/search1api/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": "search1api.web-search",
          "path": "/apis/v1/search1api/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/search1api/search1api-web-search"
      }
    },
    "/apis/v1/search1api/web-sitemap": {
      "post": {
        "description": "<!-- aisa-pricing:start -->\n按用量计费；默认请求预估费用：$0.001 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n<!-- aisa-pricing:end -->",
        "operationId": "search1api.web-sitemap",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "minLength": 1,
                    "type": "string"
                  },
                  "type": {
                    "type": "string",
                    "enum": [
                      "sitemap",
                      "all"
                    ]
                  }
                },
                "additionalProperties": false,
                "required": [
                  "url"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Discover site URLs",
        "tags": [
          "Search1API"
        ],
        "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": "2963dcb33fea"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "mixed",
        "x-aisa-catalog-id": "search1api",
        "x-aisa-runtime-operation": {
          "operation_id": "search1api.web-sitemap",
          "method": "POST",
          "path": "/apis/v1/search1api/web-sitemap"
        },
        "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": "search1api.web-sitemap",
          "path": "/apis/v1/search1api/web-sitemap",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search1api/search1api-web-sitemap"
      }
    },
    "/apis/v1/search1api/web-trending": {
      "post": {
        "description": "<!-- aisa-pricing:start -->\n按用量计费；默认请求预估费用：$0.001 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n<!-- aisa-pricing:end -->",
        "operationId": "search1api.web-trending",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "search_service": {
                    "minLength": 1,
                    "type": "string"
                  },
                  "max_results": {
                    "type": "integer",
                    "minimum": 1,
                    "examples": [
                      5
                    ]
                  }
                },
                "additionalProperties": false,
                "required": [
                  "search_service"
                ]
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "成功响应"
          },
          "default": {
            "content": {
              "application/json": {
                "schema": {}
              }
            },
            "description": "Error response; upstream passthrough responses may use provider formats"
          }
        },
        "summary": "Find trending developer topics",
        "tags": [
          "Search1API"
        ],
        "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": "a3b91ff8bd49"
        },
        "x-aisa-status": "enabled",
        "x-aisa-validation": "mixed",
        "x-aisa-catalog-id": "search1api",
        "x-aisa-runtime-operation": {
          "operation_id": "search1api.web-trending",
          "method": "POST",
          "path": "/apis/v1/search1api/web-trending"
        },
        "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": "search1api.web-trending",
          "path": "/apis/v1/search1api/web-trending",
          "method": "POST",
          "statuses": [
            "200"
          ],
          "reason": "public success response has no authoritative payload declaration"
        },
        "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search1api/search1api-web-trending"
      }
    }
  }
}