{"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<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.001 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"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 <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"q\": \"how to build an ai\"\n}'"}]}},"/apis/v1/serper/google-serp-images":{"post":{"description":"<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.001 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"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 <token>' \\\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<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.003 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"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 <token>' \\\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<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.003 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"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 <token>' \\\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<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.001 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"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 <token>' \\\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<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.001 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"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 <token>' \\\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<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.001 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"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 <token>' \\\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<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.001 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"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<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.001 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"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 <token>' \\\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<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.002 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"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<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.001 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"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 <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"q\": \"OpenAI developer keynote\"\n}'"}]}},"/apis/v1/serper/web-extract":{"post":{"description":"<!-- aisa-pricing:start -->\nA request reference price is not currently available; use a request quote where supported. Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","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<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.001 USD (not a fixed price). Declared unit rate: $0.000001 USD per provider_credit. Account-specific pricing and final settlement may differ.\n<!-- aisa-pricing:end -->","operationId":"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"}]}