{ "components": { "callbacks": {}, "examples": {}, "headers": {}, "links": {}, "parameters": {}, "pathItems": {}, "requestBodies": {}, "responses": {}, "schemas": {}, "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } }, "info": { "description": "", "title": "Serper", "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": { "serper": { "description": "", "title": "Serper", "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": "8bc115d1f8bde92adda9a817ccc8a3209c42d5e6b6fca193b1621425d312ca56", "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/serper/google-serp-autocomplete", "/apis/v1/serper/google-serp-images", "/apis/v1/serper/google-serp-lens", "/apis/v1/serper/google-serp-maps", "/apis/v1/serper/google-serp-news", "/apis/v1/serper/google-serp-patents", "/apis/v1/serper/google-serp-places", "/apis/v1/serper/google-serp-reviews", "/apis/v1/serper/google-serp-scholar", "/apis/v1/serper/google-serp-shopping", "/apis/v1/serper/google-serp-videos", "/apis/v1/serper/web-extract", "/apis/v1/serper/web-search" ], "x-aisa-document": { "composer_version": "28", "document_hash": "sha256:3f9dbf1465dc6f23e8055af8708da11add2f2015bab30c306d6bf3b0c056e819", "facts_hash": "8bc115d1f8bde92adda9a817ccc8a3209c42d5e6b6fca193b1621425d312ca56", "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": "serper" }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "paths": { "/apis/v1/serper/google-serp-autocomplete": { "post": { "description": "Answers arrive in suggestions as objects with a value field.\n\n\n按用量计费；默认请求预估费用：$0.001 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "serper.google-serp-autocomplete", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "gl": { "default": "us", "examples": [ "us" ], "type": "string" }, "hl": { "default": "en", "examples": [ "en" ], "type": "string" }, "location": { "type": "string" }, "q": { "examples": [ "how to build an ai" ], "minLength": 1, "type": "string" } }, "required": [ "q" ], "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": "Get Google autocomplete suggestions", "tags": [ "Serper" ], "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": "serper", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/serper/serper-google-serp-autocomplete", "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": "15170d0eb1f6" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "serper.google-serp-autocomplete", "path": "/apis/v1/serper/google-serp-autocomplete" }, "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": "provider", "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/serper/google-serp-autocomplete \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"q\": \"how to build an ai\"\n}'" } ] } }, "/apis/v1/serper/google-serp-images": { "post": { "description": "\n按用量计费；默认请求预估费用：$0.001 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "serper.google-serp-images", "requestBody": { "content": { "application/json": { "examples": { "default": { "value": { "num": 10 } }, "minimal": { "value": { "num": 10 } } }, "schema": { "additionalProperties": true, "properties": { "num": { "enum": [ 10, 100 ], "maximum": 100, "minimum": 10, "type": "integer" } }, "required": [ "num" ], "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 Google Images", "tags": [ "Serper" ], "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": "serper", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/serper/serper-google-serp-images", "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": "runtime_binding", "response": "generic", "status": "unreviewed" }, "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "28d7aca06096" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "serper.google-serp-images", "path": "/apis/v1/serper/google-serp-images" }, "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/serper/google-serp-images \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"num\": 10\n}'" } ] } }, "/apis/v1/serper/google-serp-lens": { "post": { "description": "Answers arrive in organic. Two valid public-image probes returned HTTP 200 with an empty organic array and credits: 3; an empty match set is therefore a paid, valid answer, not an error.\n\n\n按用量计费；默认请求预估费用：$0.003 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "serper.google-serp-lens", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "gl": { "default": "us", "examples": [ "us" ], "type": "string" }, "hl": { "default": "en", "examples": [ "en" ], "type": "string" }, "location": { "type": "string" }, "tbs": { "type": "string" }, "url": { "description": "Publicly fetchable JPG or PNG image URL.", "examples": [ "https://upload.wikimedia.org/wikipedia/commons/3/3f/Fronalpstock_big.jpg" ], "format": "uri", "minLength": 1, "type": "string" } }, "required": [ "url" ], "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": "Reverse-search an image with Google Lens", "tags": [ "Serper" ], "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": "serper", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/serper/serper-google-serp-lens", "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.003, "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": "af6390b64ce9" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "serper.google-serp-lens", "path": "/apis/v1/serper/google-serp-lens" }, "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": "provider", "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/serper/google-serp-lens \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"url\": \"https://upload.wikimedia.org/wikipedia/commons/3/3f/Fronalpstock_big.jpg\"\n}'" } ] } }, "/apis/v1/serper/google-serp-maps": { "post": { "description": "Answers arrive in places. Keyword calls may return cid, fid, and placeId values suitable for the Reviews endpoint.\n\n\n按用量计费；默认请求预估费用：$0.003 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "serper.google-serp-maps", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "cid": { "type": "string" }, "hl": { "default": "en", "examples": [ "en" ], "type": "string" }, "ll": { "description": "Map center and zoom as @latitude,longitude,zoomz.", "examples": [ "@37.7749,-122.4194,12z" ], "type": "string" }, "page": { "default": 1, "minimum": 1, "type": "integer" }, "placeId": { "type": "string" }, "q": { "examples": [ "OpenAI San Francisco" ], "minLength": 1, "type": "string" } }, "required": [ "q" ], "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 Google Maps", "tags": [ "Serper" ], "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": "serper", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/serper/serper-google-serp-maps", "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.003, "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": "ae9b6943f32e" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "serper.google-serp-maps", "path": "/apis/v1/serper/google-serp-maps" }, "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": "provider", "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/serper/google-serp-maps \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"q\": \"OpenAI San Francisco\"\n}'" } ] } }, "/apis/v1/serper/google-serp-news": { "post": { "description": "Answers arrive in news.\n\n\n按用量计费；默认请求预估费用：$0.001 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "serper.google-serp-news", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "autocorrect": { "default": true, "type": "boolean" }, "gl": { "default": "us", "examples": [ "us" ], "type": "string" }, "hl": { "default": "en", "examples": [ "en" ], "type": "string" }, "location": { "type": "string" }, "num": { "description": "Requested article count.", "maximum": 100, "minimum": 1, "type": "integer" }, "page": { "default": 1, "minimum": 1, "type": "integer" }, "q": { "examples": [ "OpenAI" ], "minLength": 1, "type": "string" }, "tbs": { "description": "Google date filter. A valid but over-restrictive value can return HTTP 200 with an empty news array and still costs one credit.", "type": "string" } }, "required": [ "q" ], "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 Google News", "tags": [ "Serper" ], "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": "serper", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/serper/serper-google-serp-news", "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": "662bf34882fd" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "serper.google-serp-news", "path": "/apis/v1/serper/google-serp-news" }, "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": "provider", "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/serper/google-serp-news \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"q\": \"OpenAI\"\n}'" } ] } }, "/apis/v1/serper/google-serp-patents": { "post": { "description": "Answers arrive in organic. Serper's current Patents playground does not offer country or language parameters.\n\n\n按用量计费；默认请求预估费用：$0.001 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "serper.google-serp-patents", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "autocorrect": { "default": true, "type": "boolean" }, "page": { "default": 1, "minimum": 1, "type": "integer" }, "q": { "examples": [ "transformer neural network" ], "minLength": 1, "type": "string" } }, "required": [ "q" ], "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 Google Patents", "tags": [ "Serper" ], "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": "serper", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/serper/serper-google-serp-patents", "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": "0f156964be62" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "serper.google-serp-patents", "path": "/apis/v1/serper/google-serp-patents" }, "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": "provider", "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/serper/google-serp-patents \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"q\": \"transformer neural network\"\n}'" } ] } }, "/apis/v1/serper/google-serp-places": { "post": { "description": "Answers arrive in places. The returned cid can be used with serper.google.serp.reviews.\n\n\n按用量计费；默认请求预估费用：$0.001 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "serper.google-serp-places", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "autocorrect": { "default": true, "type": "boolean" }, "gl": { "default": "us", "examples": [ "us" ], "type": "string" }, "hl": { "default": "en", "examples": [ "en" ], "type": "string" }, "location": { "examples": [ "New York, New York, United States" ], "type": "string" }, "page": { "default": 1, "minimum": 1, "type": "integer" }, "q": { "examples": [ "coffee near Times Square" ], "minLength": 1, "type": "string" } }, "required": [ "q" ], "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 Google Places", "tags": [ "Serper" ], "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": "serper", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/serper/serper-google-serp-places", "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": "936a0a2f35b4" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "serper.google-serp-places", "path": "/apis/v1/serper/google-serp-places" }, "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": "provider", "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/serper/google-serp-places \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"q\": \"coffee near Times Square\"\n}'" } ] } }, "/apis/v1/serper/google-serp-reviews": { "post": { "description": "This is Serper's only cursor-paginated stable endpoint and does not support mini-batch. The catalog schema cannot express one-of-required, so callers must supply cid, fid, or placeId; omitting all three produces an unbilled upstream error.\n\n\n按用量计费；默认请求预估费用：$0.001 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "serper.google-serp-reviews", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "cid": { "description": "Google customer ID. Supply at least one of cid, fid, or placeId.", "examples": [ "855637193957362546" ], "type": "string" }, "fid": { "description": "Google feature ID. Supply at least one of cid, fid, or placeId.", "type": "string" }, "gl": { "default": "us", "examples": [ "us" ], "type": "string" }, "hl": { "default": "en", "examples": [ "en" ], "type": "string" }, "nextPageToken": { "description": "Opaque cursor from the preceding response.", "type": "string" }, "placeId": { "description": "Google place ID. Supply at least one of cid, fid, or placeId.", "type": "string" }, "sortBy": { "enum": [ "mostRelevant", "newest", "highestRating", "lowestRating" ], "type": "string" }, "topicId": { "type": "string" } }, "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": "Get Google place reviews", "tags": [ "Serper" ], "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": "serper", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/serper/serper-google-serp-reviews", "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": "6ec4874be4fa" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "serper.google-serp-reviews", "path": "/apis/v1/serper/google-serp-reviews" }, "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": "provider" } }, "/apis/v1/serper/google-serp-scholar": { "post": { "description": "Answers arrive in organic; num is not accepted by Serper's current Scholar playground.\n\n\n按用量计费；默认请求预估费用：$0.001 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "serper.google-serp-scholar", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "autocorrect": { "default": true, "type": "boolean" }, "gl": { "default": "us", "examples": [ "us" ], "type": "string" }, "hl": { "default": "en", "examples": [ "en" ], "type": "string" }, "location": { "type": "string" }, "page": { "default": 1, "minimum": 1, "type": "integer" }, "q": { "examples": [ "attention is all you need" ], "minLength": 1, "type": "string" } }, "required": [ "q" ], "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 Google Scholar", "tags": [ "Serper" ], "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": "serper", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/serper/serper-google-serp-scholar", "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": "d2ec779379cb" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "serper.google-serp-scholar", "path": "/apis/v1/serper/google-serp-scholar" }, "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": "provider", "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/serper/google-serp-scholar \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"q\": \"attention is all you need\"\n}'" } ] } }, "/apis/v1/serper/google-serp-shopping": { "post": { "description": "Answers arrive in shopping. Serper's current playground fixes a shopping page at 40 results and charges two credits.\n\n\n按用量计费；默认请求预估费用：$0.002 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "serper.google-serp-shopping", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "autocorrect": { "default": true, "type": "boolean" }, "gl": { "default": "us", "examples": [ "us" ], "type": "string" }, "hl": { "default": "en", "examples": [ "en" ], "type": "string" }, "location": { "type": "string" }, "num": { "enum": [ 40 ], "maximum": 40, "minimum": 40, "type": "integer" }, "page": { "default": 1, "minimum": 1, "type": "integer" }, "q": { "examples": [ "wireless headphones" ], "minLength": 1, "type": "string" }, "tbs": { "type": "string" } }, "required": [ "num", "q" ], "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 Google Shopping", "tags": [ "Serper" ], "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": "serper", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/serper/serper-google-serp-shopping", "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-review": { "request": "reviewed_source", "response": "generic", "status": "unreviewed" }, "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "81c959d570d5" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "serper.google-serp-shopping", "path": "/apis/v1/serper/google-serp-shopping" }, "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/serper/google-serp-videos": { "post": { "description": "Answers arrive in videos.\n\n\n按用量计费；默认请求预估费用：$0.001 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "serper.google-serp-videos", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "autocorrect": { "default": true, "type": "boolean" }, "gl": { "default": "us", "examples": [ "us" ], "type": "string" }, "hl": { "default": "en", "examples": [ "en" ], "type": "string" }, "location": { "type": "string" }, "page": { "default": 1, "minimum": 1, "type": "integer" }, "q": { "examples": [ "OpenAI developer keynote" ], "minLength": 1, "type": "string" }, "tbs": { "type": "string" } }, "required": [ "q" ], "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 Google Videos", "tags": [ "Serper" ], "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": "serper", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/serper/serper-google-serp-videos", "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": "8989ac07bb2a" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "serper.google-serp-videos", "path": "/apis/v1/serper/google-serp-videos" }, "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": "provider", "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/serper/google-serp-videos \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"q\": \"OpenAI developer keynote\"\n}'" } ] } }, "/apis/v1/serper/web-extract": { "post": { "description": "\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "serper.web-extract", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "includeImages": { "enum": [ false, true ], "type": "boolean" }, "includeLinks": { "enum": [ false, true ], "type": "boolean" }, "includeMarkdown": { "enum": [ false, true ], "type": "boolean" }, "includeVideos": { "enum": [ false, true ], "type": "boolean" }, "url": { "format": "uri", "maxLength": 2048, "minLength": 1, "pattern": "^https://[^/?#@]+([/?#]|$)", "type": "string" } }, "required": [ "includeImages", "includeLinks", "includeMarkdown", "includeVideos", "url" ], "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 a web page", "tags": [ "Serper" ], "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": "serper", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/serper/serper-web-extract", "x-aisa-pricing": { "cost_contract": "response_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "estimate_source": "unavailable", "estimate_unavailable_reason": "reference_request_unavailable", "evidence_source": "response_header", "unit": "provider_credit", "unit_rate_usd": 1e-06 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-upstream-origin-sha256": "ee07509144cafbd5e3d183b49ccff2d261749fdb61ea649e385bf9803e6d4e3d", "x-aisa-response-upstream-path-sha256": "55398a22ed47b0b54392a340c4ed460b48b706a02004c2c608fa8192dc196e74", "x-aisa-review": { "request": "reviewed_source", "response": "generic", "status": "unreviewed" }, "x-aisa-revision": { "customer_pricing_ref": "fda7874df42d", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "0e1f4a68b1e8" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "serper.web-extract", "path": "/apis/v1/serper/web-extract" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime" } }, "/apis/v1/serper/web-search": { "post": { "description": "Answers arrive primarily in organic. A successful HTTP 200 costs one credit even when organic is empty; HTTP failures are unbilled. Catalog calls accept one query, while Serper's array mini-batch remains available through a team's raw BYOK tool.\n\n\n按用量计费；默认请求预估费用：$0.001 USD（不是固定价格）。 声明的单位费率：每 provider_credit $0.000001 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "serper.web-search", "requestBody": { "content": { "application/json": { "schema": { "additionalProperties": false, "properties": { "autocorrect": { "default": true, "type": "boolean" }, "gl": { "default": "us", "description": "Two-letter country code.", "examples": [ "us" ], "type": "string" }, "hl": { "default": "en", "description": "Google interface language code.", "examples": [ "en" ], "type": "string" }, "location": { "description": "Canonical Google location name; discover supported values with Serper's public /locations route.", "examples": [ "New York, New York, United States" ], "type": "string" }, "num": { "enum": [ 10 ], "maximum": 10, "minimum": 10, "type": "integer" }, "page": { "default": 1, "minimum": 1, "type": "integer" }, "q": { "examples": [ "OpenAI API documentation" ], "minLength": 1, "type": "string" }, "tbs": { "description": "Google advanced-search/date filter, for example qdr:w for the past week.", "type": "string" } }, "required": [ "num", "q" ], "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 open web with Google", "tags": [ "Serper" ], "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": "serper", "x-aisa-category": "search", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/serper/serper-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.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": "24a6443ae469" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "serper.web-search", "path": "/apis/v1/serper/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" } } }, "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://api.aisa.one" } ] }