{"components":{"callbacks":{},"examples":{},"headers":{},"links":{},"parameters":{},"pathItems":{},"requestBodies":{},"responses":{},"schemas":{},"securitySchemes":{"bearerAuth":{"scheme":"bearer","type":"http"}}},"info":{"description":"","title":"Olostep","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":{"olostep":{"description":"","title":"Olostep","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":"38c943bb476bb18b1fd99fb8db9bcad82d14ebb7b44a3a9a333afafc8c0ebc6d","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/olostep/web-answer","/apis/v1/olostep/web-map-search","/apis/v1/olostep/web-scrape","/apis/v1/olostep/web-search"],"x-aisa-document":{"composer_version":"28","document_hash":"sha256:10d6dbb22f49f20808cc8ce7279deec4793b03f45519ca0742b0a2f2155cccb2","facts_hash":"38c943bb476bb18b1fd99fb8db9bcad82d14ebb7b44a3a9a333afafc8c0ebc6d","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":"olostep"},"jsonSchemaDialect":"https://json-schema.org/draft/2020-12/schema","openapi":"3.1.0","paths":{"/apis/v1/olostep/web-answer":{"post":{"description":"<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.04 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":"olostep.web-answer","requestBody":{"content":{"application/json":{"examples":{"default":{"value":{"task":"example"}},"minimal":{"value":{"task":"example"}}},"schema":{"additionalProperties":true,"properties":{"task":{"minLength":1,"type":"string"}},"required":["task"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful response. The payload schema has not been reviewed yet."},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Answer a question with live web research","tags":["Olostep"],"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":"olostep","x-aisa-category":"search","x-aisa-docs-url":"https://aisa.one/docs/api-reference/olostep/olostep-web-answer","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_units","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.04,"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":"759125cce6a7"},"x-aisa-runtime-operation":{"method":"POST","operation_id":"olostep.web-answer","path":"/apis/v1/olostep/web-answer"},"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/olostep/web-answer \\\n  --header 'Authorization: Bearer <token>' \\\n  --header 'Content-Type: application/json' \\\n  --data '{\n  \"task\": \"example\"\n}'"}]}},"/apis/v1/olostep/web-map-search":{"post":{"description":"Olostep bills one credit for the first 1,000 returned URLs and another credit per additional 1,000. Requiring top_n <= 1,000 makes the platform hold exact. Unbounded mapping is available through a team's own raw Olostep tool.\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":"olostep.web-map-search","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"exclude_urls":{"items":{"type":"string"},"type":"array"},"include_subdomain":{"default":true,"type":"boolean"},"include_urls":{"items":{"type":"string"},"type":"array"},"search_query":{"examples":["billing and credit documentation"],"minLength":1,"type":"string"},"top_n":{"description":"The 1,000-URL cap keeps this request inside Olostep's first one-credit map band.","examples":[10],"maximum":1000,"minimum":1,"type":"integer"},"url":{"minLength":1,"type":"string"}},"required":["search_query","top_n","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":"Find relevant URLs on a website","tags":["Olostep"],"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":"olostep","x-aisa-category":"search","x-aisa-docs-url":"https://aisa.one/docs/api-reference/olostep/olostep-web-map-search","x-aisa-passthrough":true,"x-aisa-pricing":{"cost_contract":"response_units","customer_multiplier":1.0,"customer_pricing":"provider_cost_multiplier","default_request_estimate_usd":0.002,"estimate_source":"profile_seed","evidence_source":"response_header","unit":"provider_credit","unit_rate_usd":1e-06},"x-aisa-query-policy":{"ignore_undeclared":false,"open_query":true,"request_wins":false},"x-aisa-review":{"request":"reviewed_source","response":"generic","status":"unreviewed"},"x-aisa-revision":{"customer_pricing_ref":"fda7874df42d","plan_policy_version":"e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb","profile_ref":"6e42c885a92c"},"x-aisa-runtime-operation":{"method":"POST","operation_id":"olostep.web-map-search","path":"/apis/v1/olostep/web-map-search"},"x-aisa-source":{"content_hash":"sha256:3ba9b222c7b0d3b69c4895ec21da5d6e6d8a55ffb2152b5d5c1a65bcc2973566","converter":"scripts/prepare_treg_public_reference.py@1","fetched_at":"2026-11-07T11:52:30.302332+00:00","kind":"manual","owner":"AIsa-team/docs","path_space":"public","policy_revision":"sha256:5284e1076511154e5bd27c88cf8f1f29cf6ca5b51a779bd931e39faa66f99978","qualification":"Request-only source review candidate. Exact declarations retained; unsupported shapes remain pending. No formal approval or response schema asserted.","raw_content_hash":"sha256:0804b46b6fb80c59d215e1ed43032d11e13328e2c2ade48d85c75ae00fd9cb68","refresh_policy":"pinned","refresh_reason":"Review immutable provider declarations and both gateway HTTP boundaries together.","review_period_days":30,"source_git_revision":"95670bbae5561fce0ea55c1e0ee4216eb34cbf18","source_pages":[{"scope":"pathParams arrive as query; array enum and numeric bounds semantics","url":"https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/application/call/resolve.py"},{"scope":"Parameter declaration vocabulary and optional required flag","url":"https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/domain/catalog/schema/common.py"}],"url":"https://raw.githubusercontent.com/superdesigndev/treg/95670bbae5561fce0ea55c1e0ee4216eb34cbf18/src/treg/catalog/"},"x-aisa-status":"enabled","x-aisa-validation":"mixed"}},"/apis/v1/olostep/web-scrape":{"post":{"description":"This is the fixed one-credit surface. Olostep parsers and LLM extraction are not accepted by this catalog tool; a team can call them directly through its own raw Olostep tool.\n\n<!-- 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":"olostep.web-scrape","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"formats":{"description":"Structured parsers, JSON extraction and llm_extract are deliberately excluded because they have separate variable credit prices.","items":{"enum":["markdown"],"type":"string"},"maxItems":1,"minItems":1,"type":"array"},"links_on_page":{"properties":{"exclude_links":{"items":{"type":"string"},"type":"array"},"include_links":{"items":{"type":"string"},"type":"array"},"query_to_order_links_by":{"type":"string"}},"type":"object"},"max_age":{"default":0,"description":"Reuse an Olostep scrape no older than this many seconds; 0 requests a fresh scrape.","maximum":604800,"minimum":0,"type":"integer"},"remove_images":{"default":false,"type":"boolean"},"transformer":{"enum":["postlight","none"],"type":"string"},"url_to_scrape":{"minLength":1,"type":"string"}},"required":["formats","url_to_scrape"],"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":"Scrape a web page","tags":["Olostep"],"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":"olostep","x-aisa-category":"search","x-aisa-docs-url":"https://aisa.one/docs/api-reference/olostep/olostep-web-scrape","x-aisa-passthrough":true,"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,"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":"65d11b616481"},"x-aisa-runtime-operation":{"method":"POST","operation_id":"olostep.web-scrape","path":"/apis/v1/olostep/web-scrape"},"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/olostep/web-search":{"post":{"description":"The five-credit base search is exposed. scrape_options is deliberately excluded because it adds one or more scrape credits for every returned page.\n\n<!-- aisa-pricing:start -->\nUsage-based billing; Default request estimate: $0.01 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":"olostep.web-search","requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"exclude_domains":{"items":{"type":"string"},"maxItems":20,"type":"array"},"fast_mode":{"enum":[false],"type":"boolean"},"include_domains":{"items":{"type":"string"},"maxItems":20,"type":"array"},"limit":{"examples":[5],"maximum":25,"minimum":1,"type":"integer"},"query":{"examples":["Olostep API documentation"],"minLength":1,"type":"string"}},"required":["fast_mode","limit","query"],"type":"object"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{}}},"description":"Successful response. The payload schema has not been reviewed yet."},"default":{"content":{"application/json":{"schema":{}}},"description":"Error response; upstream passthrough responses may use provider formats"}},"summary":"Search the open web","tags":["Olostep"],"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":"olostep","x-aisa-category":"search","x-aisa-docs-url":"https://aisa.one/docs/api-reference/olostep/olostep-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.01,"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":"5a2f6547ee30"},"x-aisa-runtime-operation":{"method":"POST","operation_id":"olostep.web-search","path":"/apis/v1/olostep/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"}]}