{ "components": { "callbacks": {}, "examples": {}, "headers": {}, "links": {}, "parameters": {}, "pathItems": {}, "requestBodies": {}, "responses": {}, "schemas": {}, "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } }, "info": { "description": "", "title": "Exa", "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": { "exa": { "description": "", "title": "Exa", "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": "d10529a4463a002dd39ad505e0bc30212230a00b2034082221e854d90728a9b8", "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/exa/agent/runs", "/apis/v1/exa/answer", "/apis/v1/exa/contents", "/apis/v1/exa/search" ], "x-aisa-document": { "composer_version": "26", "document_hash": "sha256:b754d7b5830189bd06c818d98a4f87ea56022fe7fc8d8330b7ab4f41f422031f", "facts_hash": "d10529a4463a002dd39ad505e0bc30212230a00b2034082221e854d90728a9b8", "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": "exa" }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "paths": { "/apis/v1/exa/agent/runs": { "get": { "description": "Owner-scoped local asynchronous job lifecycle. Disabling new admission does not disable existing job reads or cancellation. Runtime availability and access policy also apply.\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_exa_apis_v1_exa_agent_runs", "parameters": [ { "in": "query", "name": "limit", "schema": { "default": 50, "maximum": 100, "minimum": 1, "type": "integer" } }, { "in": "query", "name": "status", "schema": { "enum": [ "", "queued", "running", "completed", "failed", "cancelled" ], "type": "string" } }, { "description": "Opaque nextCursor from a previous response.", "in": "query", "name": "cursor", "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "data": { "items": { "properties": { "completedAt": { "format": "date-time", "type": [ "string", "null" ] }, "createdAt": { "format": "date-time", "type": [ "string", "null" ] }, "endpoint": { "type": [ "string", "null" ] }, "error": { "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": [ "string", "null" ] } }, "type": [ "object", "null" ] }, "id": { "type": [ "string", "null" ] }, "object": { "const": "integration_async_job", "type": "string" }, "output": {}, "outputExpired": { "type": [ "boolean", "null" ] }, "pricing": { "properties": { "authorizedMicrosUSD": { "type": [ "integer", "null" ] }, "billingMode": { "type": [ "string", "null" ] }, "currency": { "type": [ "string", "null" ] }, "finalMicrosUSD": { "type": [ "integer", "null" ] } }, "type": [ "object", "null" ] }, "status": { "enum": [ "queued", "running", "completed", "failed", "cancelled" ], "type": "string" } }, "required": [ "completedAt", "createdAt", "endpoint", "error", "id", "object", "output", "pricing", "status" ], "type": "object" }, "type": "array" }, "nextCursor": { "type": [ "string", "null" ] }, "object": { "const": "list", "type": "string" } }, "required": [ "object", "data", "nextCursor" ], "type": "object" } } }, "description": "Success" } }, "summary": "Exa Agent Runs list", "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "quote": { "reason": "cost_quote_unsupported", "supported": false }, "x402": false }, "x-aisa-catalog-id": "exa", "x-aisa-contract-source": "handler", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/exa/get_exa_apis_v1_exa_agent_runs", "x-aisa-identity-source": "derived", "x-aisa-lifecycle": { "action": "list", "kind": "asynchronous" }, "x-aisa-pricing": { "description": "No new customer charge is authorized by this lifecycle operation; cancellation may complete an existing job's settlement.", "kind": "no_customer_charge" }, "x-aisa-revision": { "handler_contract_hash": "4b0b3112abe7fa3cce29f83d9d9fbd8e5acbe531bef062044229181cc8debaa6" }, "x-aisa-runtime-operation": { "method": "GET", "operation_id": "get_exa_apis_v1_exa_agent_runs", "path": "/apis/v1/exa/agent/runs" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime" }, "post": { "description": "Owner-scoped local asynchronous job lifecycle. Disabling new admission does not disable existing job reads or cancellation. Runtime availability and access policy also apply.\n\n\n默认请求预估费用：$0.1 USD（不是固定价格）。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_exa_agent_runs", "parameters": [ { "description": "Trimmed UTF-8 length must be 1 through 191 bytes.", "in": "header", "name": "Idempotency-Key", "required": true, "schema": { "pattern": "\\S", "type": "string" } }, { "description": "Optional maximum customer authorization in USD, validated by the runtime price parser.", "in": "header", "name": "X-AISA-Max-Price-USD", "schema": { "type": "string" } }, { "description": "Return a read-only cost quote instead of submitting a job.", "in": "header", "name": "X-AISA-Cost-Mode", "schema": { "enum": [ "quote" ], "type": "string" } } ], "requestBody": { "content": { "application/json": { "example": { "query": "Find the official documentation for Go" }, "schema": { "additionalProperties": false, "properties": { "effort": { "default": "minimal", "description": "Only minimal effort is supported; omitted, empty and null values normalize to minimal.", "enum": [ null, "", "minimal" ], "type": [ "string", "null" ] }, "query": { "description": "Non-empty query after trimming whitespace.", "pattern": "\\S", "type": "string" }, "systemPrompt": { "type": [ "string", "null" ] } }, "required": [ "query" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "currency": { "type": [ "string", "null" ] }, "estimate_kind": { "type": [ "string", "null" ] }, "estimated_at": { "format": "date-time", "type": [ "string", "null" ] }, "estimated_cost_micros_usd": { "type": [ "integer", "null" ] }, "max_cost_micros_usd": { "type": [ "integer", "null" ] }, "may_exceed_estimate": { "type": [ "boolean", "null" ] }, "metadata": { "additionalProperties": {}, "type": [ "object", "null" ] }, "object": { "type": [ "string", "null" ] }, "pricing_version": { "type": [ "string", "null" ] } }, "required": [ "currency", "estimate_kind", "estimated_at", "estimated_cost_micros_usd", "may_exceed_estimate", "object" ], "type": "object" } } }, "description": "Read-only cost quote when X-AISA-Cost-Mode is quote; no job is created." }, "202": { "content": { "application/json": { "schema": { "properties": { "completedAt": { "format": "date-time", "type": [ "string", "null" ] }, "createdAt": { "format": "date-time", "type": [ "string", "null" ] }, "endpoint": { "type": [ "string", "null" ] }, "error": { "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": [ "string", "null" ] } }, "type": [ "object", "null" ] }, "id": { "type": [ "string", "null" ] }, "object": { "const": "integration_async_job", "type": "string" }, "output": {}, "outputExpired": { "type": [ "boolean", "null" ] }, "pricing": { "properties": { "authorizedMicrosUSD": { "type": [ "integer", "null" ] }, "billingMode": { "type": [ "string", "null" ] }, "currency": { "type": [ "string", "null" ] }, "finalMicrosUSD": { "type": [ "integer", "null" ] } }, "type": [ "object", "null" ] }, "status": { "enum": [ "queued", "running", "completed", "failed", "cancelled" ], "type": "string" } }, "required": [ "completedAt", "createdAt", "endpoint", "error", "id", "object", "output", "pricing", "status" ], "type": "object" } } }, "description": "Success" } }, "summary": "Exa Agent Runs submit", "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "quote": { "header": "X-AISA-Cost-Mode", "supported": true, "value": "quote" }, "x402": false }, "x-aisa-catalog-id": "exa", "x-aisa-contract-source": "handler", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search/post_exa-agent-runs", "x-aisa-lifecycle": { "action": "submit", "kind": "asynchronous" }, "x-aisa-pricing": { "default_request_estimate_usd": 0.1, "description": "Customer normal-tier reference, with the public PAYG multiplier. Authenticated plan and user tier may differ; a quote uses the actual caller and payload.", "estimate_source": "configured_fixed_price", "kind": "fixed_request" }, "x-aisa-revision": { "handler_contract_hash": "54fd30cc486e96cd0884618240a615e71262fa21392d530ecf404893d86be7ee" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "post_exa_agent_runs", "path": "/apis/v1/exa/agent/runs" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime" } }, "/apis/v1/exa/agent/runs/{jobId}": { "get": { "description": "Owner-scoped local asynchronous job lifecycle. Disabling new admission does not disable existing job reads or cancellation. Runtime availability and access policy also apply.\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "get_exa_agent_run", "parameters": [ { "in": "path", "name": "jobId", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "completedAt": { "format": "date-time", "type": [ "string", "null" ] }, "createdAt": { "format": "date-time", "type": [ "string", "null" ] }, "endpoint": { "type": [ "string", "null" ] }, "error": { "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": [ "string", "null" ] } }, "type": [ "object", "null" ] }, "id": { "type": [ "string", "null" ] }, "object": { "const": "integration_async_job", "type": "string" }, "output": {}, "outputExpired": { "type": [ "boolean", "null" ] }, "pricing": { "properties": { "authorizedMicrosUSD": { "type": [ "integer", "null" ] }, "billingMode": { "type": [ "string", "null" ] }, "currency": { "type": [ "string", "null" ] }, "finalMicrosUSD": { "type": [ "integer", "null" ] } }, "type": [ "object", "null" ] }, "status": { "enum": [ "queued", "running", "completed", "failed", "cancelled" ], "type": "string" } }, "required": [ "completedAt", "createdAt", "endpoint", "error", "id", "object", "output", "pricing", "status" ], "type": "object" } } }, "description": "Success" } }, "summary": "Exa Agent Runs detail", "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "quote": { "reason": "cost_quote_unsupported", "supported": false }, "x402": false }, "x-aisa-catalog-id": "exa", "x-aisa-contract-source": "handler", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search/get_exa-agent-run", "x-aisa-identity-source": "derived", "x-aisa-lifecycle": { "action": "detail", "kind": "asynchronous" }, "x-aisa-pricing": { "description": "No new customer charge is authorized by this lifecycle operation; cancellation may complete an existing job's settlement.", "kind": "no_customer_charge" }, "x-aisa-revision": { "handler_contract_hash": "18574e69fbc194c06bd2b727371c8820df337b4cc49f89498c797d0260bf8849" }, "x-aisa-runtime-operation": { "method": "GET", "operation_id": "get_exa_apis_v1_exa_agent_runs_jobid", "path": "/apis/v1/exa/agent/runs/{jobId}" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime" } }, "/apis/v1/exa/agent/runs/{jobId}/cancel": { "post": { "description": "Owner-scoped local asynchronous job lifecycle. Disabling new admission does not disable existing job reads or cancellation. Runtime availability and access policy also apply.\n\n\n当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_exa_apis_v1_exa_agent_runs_jobid_cancel", "parameters": [ { "in": "path", "name": "jobId", "required": true, "schema": { "type": "string" } } ], "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "completedAt": { "format": "date-time", "type": [ "string", "null" ] }, "createdAt": { "format": "date-time", "type": [ "string", "null" ] }, "endpoint": { "type": [ "string", "null" ] }, "error": { "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": [ "string", "null" ] } }, "type": [ "object", "null" ] }, "id": { "type": [ "string", "null" ] }, "object": { "const": "integration_async_job", "type": "string" }, "output": {}, "outputExpired": { "type": [ "boolean", "null" ] }, "pricing": { "properties": { "authorizedMicrosUSD": { "type": [ "integer", "null" ] }, "billingMode": { "type": [ "string", "null" ] }, "currency": { "type": [ "string", "null" ] }, "finalMicrosUSD": { "type": [ "integer", "null" ] } }, "type": [ "object", "null" ] }, "status": { "enum": [ "queued", "running", "completed", "failed", "cancelled" ], "type": "string" } }, "required": [ "completedAt", "createdAt", "endpoint", "error", "id", "object", "output", "pricing", "status" ], "type": "object" } } }, "description": "Success" }, "202": { "content": { "application/json": { "schema": { "properties": { "completedAt": { "format": "date-time", "type": [ "string", "null" ] }, "createdAt": { "format": "date-time", "type": [ "string", "null" ] }, "endpoint": { "type": [ "string", "null" ] }, "error": { "properties": { "code": { "type": [ "string", "null" ] }, "message": { "type": [ "string", "null" ] } }, "type": [ "object", "null" ] }, "id": { "type": [ "string", "null" ] }, "object": { "const": "integration_async_job", "type": "string" }, "output": {}, "outputExpired": { "type": [ "boolean", "null" ] }, "pricing": { "properties": { "authorizedMicrosUSD": { "type": [ "integer", "null" ] }, "billingMode": { "type": [ "string", "null" ] }, "currency": { "type": [ "string", "null" ] }, "finalMicrosUSD": { "type": [ "integer", "null" ] } }, "type": [ "object", "null" ] }, "status": { "enum": [ "queued", "running", "completed", "failed", "cancelled" ], "type": "string" } }, "required": [ "completedAt", "createdAt", "endpoint", "error", "id", "object", "output", "pricing", "status" ], "type": "object" } } }, "description": "Success" } }, "summary": "Exa Agent Runs cancel", "x-aisa-capabilities": { "idempotency": "Idempotency-Key", "max_price": "X-AISA-Max-Price-USD", "mpp": false, "quote": { "reason": "cost_quote_unsupported", "supported": false }, "x402": false }, "x-aisa-catalog-id": "exa", "x-aisa-contract-source": "handler", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/exa/post_exa_apis_v1_exa_agent_runs_jobid_cancel", "x-aisa-identity-source": "derived", "x-aisa-lifecycle": { "action": "cancel", "kind": "asynchronous" }, "x-aisa-pricing": { "description": "No new customer charge is authorized by this lifecycle operation; cancellation may complete an existing job's settlement.", "kind": "no_customer_charge" }, "x-aisa-revision": { "handler_contract_hash": "54f24f8f1e40fab51a88fb159b6123eb9e70085f3f57fa5187f8c428e23aff7a" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "post_exa_apis_v1_exa_agent_runs_jobid_cancel", "path": "/apis/v1/exa/agent/runs/{jobId}/cancel" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime" } }, "/apis/v1/exa/answer": { "post": { "description": "Ask a question and get a written answer with citations. `query` is required; `text` includes the source text and `outputSchema` shapes a structured reply. Returns `requestId`, `answer` as prose, `citations[]` with `id`, `title` and `url`, and `costDollars`. Measured at 2.1 seconds with 8 citations. Use current endpoint pricing and a fresh quote for this request. It sits between a search and a research run: faster and cheaper than `post_exa_agent_runs`, and more direct than reading `post_exa_search` results yourself. Reach for Exa when the retrieval needs to be semantic; compare current quotes when choosing a provider.\n\n\n按用量计费；默认请求预估费用：$0.005 USD（不是固定价格）。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_exa_answer", "requestBody": { "content": { "application/json": { "schema": { "properties": { "outputSchema": { "description": "用于结构化答案输出的 JSON Schema。", "type": "object" }, "query": { "description": "要回答的问题。", "example": "Which manufacturers had the top three global EV sales in 2025?", "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" }, "text": { "description": "包含每条引用的完整页面文本。", "type": "boolean" }, "type": { "description": "作答前用于收集来源的检索模式。", "enum": [ "auto", "fast", "instant", "deep-lite", "deep", "deep-reasoning" ], "type": "string" } }, "required": [ "query" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "answer": { "description": "生成的答案。为字符串；当提供了 outputSchema 时为结构化对象。" }, "citations": { "description": "支撑该答案的来源。", "items": { "properties": { "author": { "type": "string" }, "id": { "type": "string" }, "publishedDate": { "type": "string" }, "text": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "type": "array" }, "costDollars": { "description": "Upstream Exa cost breakdown. Informational only; it is not the AIsa customer charge. Use a fresh quote for the actual request." }, "requestId": { "type": "string" } }, "type": "object" } } }, "description": "答案生成成功。" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Answer", "tags": [ "default" ], "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": "exa", "x-aisa-category": "general", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search/post_exa-answer", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_usd", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.005, "estimate_source": "profile_seed", "evidence_source": "response_body" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-source": { "content_hash": "sha256:fd8abc4a825d459f7332107f0616f5e657a846c3b05e5d19a6bd85779f59637a", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:993b2b5db5bdf685523d6b1774e68ff776cd11f38238067c69ab426379a83528", "converter": "reviewed-public-description-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4940b8b8ea7fdb42f87b2e6cc8e7586e3f1477d99d60c8a06ee4a6dd70fccd43", "prior_source": { "content_hash": "sha256:2fdc7f5386758781ea4d3f29516656726bd1bec9410146f473d3a55764ebb1e8", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4940b8b8ea7fdb42f87b2e6cc8e7586e3f1477d99d60c8a06ee4a6dd70fccd43", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/exa.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Remove obsolete AIsa fixed-price claims only; request and response validation schemas unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/exa.json" } }, "x-aisa-revision": { "customer_pricing_ref": "8bfa29a2578c", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7a3a4ba0b5c7" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_exa_answer", "path": "/apis/v1/exa/answer" }, "x-aisa-source": { "content_hash": "sha256:993b2b5db5bdf685523d6b1774e68ff776cd11f38238067c69ab426379a83528", "converter": "reviewed-public-description-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4940b8b8ea7fdb42f87b2e6cc8e7586e3f1477d99d60c8a06ee4a6dd70fccd43", "prior_source": { "content_hash": "sha256:2fdc7f5386758781ea4d3f29516656726bd1bec9410146f473d3a55764ebb1e8", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4940b8b8ea7fdb42f87b2e6cc8e7586e3f1477d99d60c8a06ee4a6dd70fccd43", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/exa.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Remove obsolete AIsa fixed-price claims only; request and response validation schemas unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/exa.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/answer", "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/exa/answer \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"query\": \"Which manufacturers had the top three global EV sales in 2025?\"\n}'" } ] } }, "/apis/v1/exa/contents": { "post": { "description": "Fetch page text and metadata for URLs you already have. `ids` is required and takes the `id` values from `post_exa_search` — which are plain URLs, so any URL works. Toggle `text`, `highlights`, `summary`, `subpages` and `livecrawl`. Returns `results[]` with `id`, `title`, `url`, `author` and `text`, plus a **`statuses[]` array giving per-URL `status` and `source`** — read it, because a URL that could not be fetched is reported there rather than raising. Cached results are served instantly; a miss falls back to a live crawl. Measured at 1.2 seconds. Use current endpoint pricing and a fresh quote for this request. For a whole site rather than a URL list, `post_firecrawl_crawl`.\n\n\n按用量计费；默认请求预估费用：$0.002 USD（不是固定价格）。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_exa_contents", "requestBody": { "content": { "application/json": { "schema": { "properties": { "highlights": { "description": "返回高亮的相关片段。", "type": "boolean" }, "ids": { "description": "要获取内容的 URL（或 Exa 结果 id）。", "example": [ "https://example.com/article" ], "items": { "type": "string" }, "type": "array" }, "livecrawl": { "description": "新鲜度策略：始终实时抓取、缓存未命中时退回实时抓取，或从不实时抓取。", "enum": [ "always", "fallback", "never" ], "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" }, "subpages": { "description": "同时抓取的关联子页面数量。", "type": "integer" }, "summary": { "description": "返回该页面由 AI 生成的摘要。", "type": "boolean" }, "text": { "description": "返回完整的页面文本。", "type": "boolean" } }, "required": [ "ids" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "requestId": { "type": "string" }, "results": { "items": { "properties": { "author": { "type": "string" }, "highlights": { "items": { "type": "string" }, "type": "array" }, "id": { "type": "string" }, "publishedDate": { "type": "string" }, "summary": { "type": "string" }, "text": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" } } }, "description": "内容获取成功。" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Contents", "tags": [ "default" ], "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": "exa", "x-aisa-category": "general", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search/post_exa-contents", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_usd", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002, "estimate_source": "profile_seed", "evidence_source": "response_body" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-source": { "content_hash": "sha256:a59250b6c8ca0548c8c9a042ef0b8ef5ebec080e8571f553dc51389bb7e3f479", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:993b2b5db5bdf685523d6b1774e68ff776cd11f38238067c69ab426379a83528", "converter": "reviewed-public-description-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4940b8b8ea7fdb42f87b2e6cc8e7586e3f1477d99d60c8a06ee4a6dd70fccd43", "prior_source": { "content_hash": "sha256:2fdc7f5386758781ea4d3f29516656726bd1bec9410146f473d3a55764ebb1e8", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4940b8b8ea7fdb42f87b2e6cc8e7586e3f1477d99d60c8a06ee4a6dd70fccd43", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/exa.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Remove obsolete AIsa fixed-price claims only; request and response validation schemas unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/exa.json" } }, "x-aisa-revision": { "customer_pricing_ref": "8bfa29a2578c", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "66ba552a803a" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_exa_contents", "path": "/apis/v1/exa/contents" }, "x-aisa-source": { "content_hash": "sha256:993b2b5db5bdf685523d6b1774e68ff776cd11f38238067c69ab426379a83528", "converter": "reviewed-public-description-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4940b8b8ea7fdb42f87b2e6cc8e7586e3f1477d99d60c8a06ee4a6dd70fccd43", "prior_source": { "content_hash": "sha256:2fdc7f5386758781ea4d3f29516656726bd1bec9410146f473d3a55764ebb1e8", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4940b8b8ea7fdb42f87b2e6cc8e7586e3f1477d99d60c8a06ee4a6dd70fccd43", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/exa.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Remove obsolete AIsa fixed-price claims only; request and response validation schemas unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/exa.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/contents", "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/exa/contents \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"ids\": [\n \"https://example.com/article\"\n ]\n}'" } ] } }, "/apis/v1/exa/search": { "post": { "description": "Search the web by meaning rather than by keyword. `query` is required; narrow with `category`, `includeDomains`, `excludeDomains`, `startPublishedDate`, `endPublishedDate`, and set `numResults`. Returns `requestId`, `resolvedSearchType`, `searchTime`, `costDollars` and `results[]` with `id`, `title` and `url`. **`id` is the URL**, and it is what `post_exa_contents` takes. Measured at 1.4 seconds — the fastest search here. Use current endpoint pricing and a fresh quote for this request. ⚠️ Results carry **no page text** unless you ask: pass `contents`, or follow up with `post_exa_contents`. Choose it over `post_tavily_search` when the query is a description rather than keywords; choose Tavily when you want the text in the same call, and `post_exa_answer` when you want a written answer rather than a list.\n\n\n按用量计费；默认请求预估费用：$0.017 USD（不是固定价格）。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_exa_search", "requestBody": { "content": { "application/json": { "schema": { "properties": { "category": { "description": "关于优先抓取哪类页面的可选提示。", "enum": [ "company", "research paper", "news", "personal site", "financial report", "people" ], "type": "string" }, "contents": { "description": "随每条结果一并返回的内容选项。", "properties": { "highlights": { "description": "返回高亮的相关片段。", "type": "boolean" }, "summary": { "description": "返回该页面由 AI 生成的摘要。", "type": "boolean" }, "text": { "description": "返回完整的页面文本。", "type": "boolean" } }, "type": "object" }, "endPublishedDate": { "description": "仅返回在该 ISO 8601 日期当天或之前发布的结果。", "format": "date-time", "type": "string" }, "excludeDomains": { "description": "排除来自这些域名的结果。", "items": { "type": "string" }, "type": "array" }, "includeDomains": { "description": "只返回来自这些域名的结果。", "items": { "type": "string" }, "type": "array" }, "numResults": { "default": 10, "description": "返回的结果数量。", "maximum": 100, "minimum": 1, "type": "integer" }, "outputSchema": { "description": "用于从结果中合成结构化输出的 JSON Schema。", "type": "object" }, "query": { "description": "自然语言搜索查询。", "example": "latest evaluation frameworks for AI agents", "type": "string" }, "startPublishedDate": { "description": "仅返回在该 ISO 8601 日期当天或之后发布的结果。", "format": "date-time", "type": "string" }, "stream": { "default": false, "enum": [ false ], "type": "boolean" }, "systemPrompt": { "description": "用于引导结构化输出如何生成的指令。", "type": "string" }, "type": { "default": "auto", "description": "搜索模式。auto 让 Exa 自行选择；deep 模式以更高延迟换取更高质量的检索。", "enum": [ "auto", "fast", "instant", "deep-lite", "deep", "deep-reasoning" ], "type": "string" } }, "required": [ "query" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "costDollars": { "description": "Upstream Exa cost breakdown. Informational only; it is not the AIsa customer charge. Use a fresh quote for the actual request." }, "output": { "description": "结构化输出，仅在提供了 outputSchema 时出现。" }, "requestId": { "description": "Exa 请求标识符。", "type": "string" }, "results": { "description": "排序后的搜索结果。", "items": { "properties": { "author": { "type": "string" }, "id": { "type": "string" }, "publishedDate": { "type": "string" }, "title": { "type": "string" }, "url": { "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" } } }, "description": "搜索成功完成。" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "搜索", "tags": [ "default" ], "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": "exa", "x-aisa-category": "general", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search/post_exa-search", "x-aisa-passthrough": true, "x-aisa-pricing": { "cost_contract": "response_usd", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.017, "estimate_source": "profile_seed", "evidence_source": "response_body" }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-source": { "content_hash": "sha256:b878e34c1da3c72f576efb0583f608d80b05f2d36a8cc1014c5eda6cf71699fe", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:993b2b5db5bdf685523d6b1774e68ff776cd11f38238067c69ab426379a83528", "converter": "reviewed-public-description-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4940b8b8ea7fdb42f87b2e6cc8e7586e3f1477d99d60c8a06ee4a6dd70fccd43", "prior_source": { "content_hash": "sha256:2fdc7f5386758781ea4d3f29516656726bd1bec9410146f473d3a55764ebb1e8", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4940b8b8ea7fdb42f87b2e6cc8e7586e3f1477d99d60c8a06ee4a6dd70fccd43", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/exa.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Remove obsolete AIsa fixed-price claims only; request and response validation schemas unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/exa.json" } }, "x-aisa-revision": { "customer_pricing_ref": "8bfa29a2578c", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "a75bf5bd90ac" }, "x-aisa-runtime-operation": { "method": "ANY", "operation_id": "post_exa_search", "path": "/apis/v1/exa/search" }, "x-aisa-source": { "content_hash": "sha256:993b2b5db5bdf685523d6b1774e68ff776cd11f38238067c69ab426379a83528", "converter": "reviewed-public-description-amendment@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4940b8b8ea7fdb42f87b2e6cc8e7586e3f1477d99d60c8a06ee4a6dd70fccd43", "prior_source": { "content_hash": "sha256:2fdc7f5386758781ea4d3f29516656726bd1bec9410146f473d3a55764ebb1e8", "converter": "scripts/import_existing_contracts.py@1", "fetched_at": "2026-09-29T21:25:55+08:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4940b8b8ea7fdb42f87b2e6cc8e7586e3f1477d99d60c8a06ee4a6dd70fccd43", "refresh_policy": "manual", "review_period_days": 30, "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/exa.json" }, "refresh_policy": "manual", "review_period_days": 30, "scope": "Remove obsolete AIsa fixed-price claims only; request and response validation schemas unchanged.", "url": "https://github.com/AIsa-team/docs/blob/7783840e4710bb00886143feab84606f8aaea67c/openapi/exa.json" }, "x-aisa-status": "enabled", "x-aisa-upstream-path": "/search", "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/exa/search \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"query\": \"latest evaluation frameworks for AI agents\"\n}'" } ] } } }, "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://api.aisa.one" } ] }