{ "components": { "callbacks": {}, "examples": {}, "headers": {}, "links": {}, "parameters": {}, "pathItems": {}, "requestBodies": {}, "responses": {}, "schemas": {}, "securitySchemes": { "bearerAuth": { "scheme": "bearer", "type": "http" } } }, "info": { "description": "", "title": "Firecrawl", "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": { "firecrawl": { "description": "", "title": "Firecrawl", "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": "82ca6e32a3422a9fdc47fb987d84d177f6e0ef05d5eae36691e5f7b3911d092f", "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/firecrawl/batch-scrape", "/apis/v1/firecrawl/crawl", "/apis/v1/firecrawl/map", "/apis/v1/firecrawl/parse", "/apis/v1/firecrawl/scrape", "/apis/v1/firecrawl/search" ], "x-aisa-document": { "composer_version": "26", "document_hash": "sha256:1c1839572445517512d7fdd29b2cfa5d43284b0ed291e1ed620060c12372178a", "facts_hash": "82ca6e32a3422a9fdc47fb987d84d177f6e0ef05d5eae36691e5f7b3911d092f", "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": "firecrawl" }, "jsonSchemaDialect": "https://json-schema.org/draft/2020-12/schema", "openapi": "3.1.0", "paths": { "/apis/v1/firecrawl/batch-scrape": { "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_firecrawl_apis_v1_firecrawl_batch_scrape", "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": "Firecrawl Batch Scrape 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": "firecrawl", "x-aisa-contract-source": "handler", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/firecrawl/get_firecrawl_apis_v1_firecrawl_batch_scrape", "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": "db2c221f19547978d80aed98ec87e44c1d1909d2b46e2259610c9b8a953cc9ec" }, "x-aisa-runtime-operation": { "method": "GET", "operation_id": "get_firecrawl_apis_v1_firecrawl_batch_scrape", "path": "/apis/v1/firecrawl/batch-scrape" }, "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当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_firecrawl_batch_scrape", "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": { "urls": [ "https://example.com" ] }, "schema": { "additionalProperties": false, "properties": { "excludeTags": { "items": { "description": "Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded.", "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])", "type": "string", "x-aisa-max-utf8-bytes": 128 }, "maxItems": 50, "type": [ "array", "null" ] }, "includeTags": { "items": { "description": "Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded.", "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])", "type": "string", "x-aisa-max-utf8-bytes": 128 }, "maxItems": 50, "type": [ "array", "null" ] }, "maxAge": { "maximum": 31536000000, "minimum": 0, "type": [ "integer", "null" ] }, "maxConcurrency": { "maximum": 20, "minimum": 1, "type": [ "integer", "null" ] }, "minAge": { "maximum": 31536000000, "minimum": 0, "type": [ "integer", "null" ] }, "onlyMainContent": { "type": [ "boolean", "null" ] }, "timeout": { "maximum": 300000, "minimum": 1000, "type": [ "integer", "null" ] }, "urls": { "description": "URLs must also be unique after trimming whitespace and trailing slashes.", "items": { "description": "HTTPS URL with a hostname, without credentials or fragment. Trimmed input ending in .pdf (case insensitive) is not supported.", "pattern": "^\\s*[hH][tT][tT][pP][sS]://", "type": "string" }, "maxItems": 1000, "minItems": 1, "type": "array", "uniqueItems": true } }, "required": [ "urls" ], "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": "Firecrawl Batch Scrape 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": "firecrawl", "x-aisa-contract-source": "handler", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search/post_firecrawl-batch-scrape", "x-aisa-lifecycle": { "action": "submit", "kind": "asynchronous" }, "x-aisa-pricing": { "customer_unit_price_usd": 0.005, "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": "unavailable", "estimate_unavailable_reason": "request_dependent_units", "kind": "metered_result" }, "x-aisa-revision": { "handler_contract_hash": "66757fcd5e0ad77b75a7eb5736778fe26b5e7ac149fab26d5a7026a4ab5a9651" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "post_firecrawl_batch_scrape", "path": "/apis/v1/firecrawl/batch-scrape" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime" } }, "/apis/v1/firecrawl/batch-scrape/{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_firecrawl_batch_scrape_job", "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": "Firecrawl Batch Scrape 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": "firecrawl", "x-aisa-contract-source": "handler", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search/get_firecrawl-batch-scrape-job", "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": "06b8b0c660ad80770c2e28674629f91d5b8095fe1bdd5cbb7d633a9fae7134ba" }, "x-aisa-runtime-operation": { "method": "GET", "operation_id": "get_firecrawl_apis_v1_firecrawl_batch_scrape_jobid", "path": "/apis/v1/firecrawl/batch-scrape/{jobId}" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime" } }, "/apis/v1/firecrawl/batch-scrape/{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_firecrawl_apis_v1_firecrawl_batch_scrape_job_ffa8bc", "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": "Firecrawl Batch Scrape 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": "firecrawl", "x-aisa-contract-source": "handler", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/firecrawl/post_firecrawl_apis_v1_firecrawl_batch_scrape_job_ffa8bc", "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": "adc1f6d5a0842a49bb098ba7fbe13d2fb0c993c5c3e89339d6bcc0223575984d" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "post_firecrawl_apis_v1_firecrawl_batch_scrape_job_ffa8bc", "path": "/apis/v1/firecrawl/batch-scrape/{jobId}/cancel" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime" } }, "/apis/v1/firecrawl/crawl": { "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_firecrawl_apis_v1_firecrawl_crawl", "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": "Firecrawl Crawl 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": "firecrawl", "x-aisa-contract-source": "handler", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/firecrawl/get_firecrawl_apis_v1_firecrawl_crawl", "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": "e404a56833cc53d6aad93dbef6a2acd47b977311e4c8447ef429e7b4c0543ace" }, "x-aisa-runtime-operation": { "method": "GET", "operation_id": "get_firecrawl_apis_v1_firecrawl_crawl", "path": "/apis/v1/firecrawl/crawl" }, "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当前未提供请求参考价格；请使用接口支持的报价功能确认费用。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_firecrawl_crawl", "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": { "limit": 1, "url": "https://example.com" }, "schema": { "additionalProperties": false, "properties": { "allowExternalLinks": { "type": [ "boolean", "null" ] }, "allowSubdomains": { "type": [ "boolean", "null" ] }, "crawlEntireDomain": { "type": [ "boolean", "null" ] }, "delay": { "maximum": 30, "minimum": 0, "type": [ "number", "null" ] }, "excludePaths": { "items": { "description": "Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded.", "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])", "type": "string", "x-aisa-max-utf8-bytes": 256 }, "maxItems": 20, "type": [ "array", "null" ] }, "ignoreQueryParameters": { "type": [ "boolean", "null" ] }, "includePaths": { "items": { "description": "Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded.", "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])", "type": "string", "x-aisa-max-utf8-bytes": 256 }, "maxItems": 20, "type": [ "array", "null" ] }, "limit": { "maximum": 1000, "minimum": 1, "type": "integer" }, "maxConcurrency": { "maximum": 20, "minimum": 1, "type": [ "integer", "null" ] }, "maxDiscoveryDepth": { "maximum": 10, "minimum": 0, "type": [ "integer", "null" ] }, "scrapeOptions": { "additionalProperties": false, "properties": { "excludeTags": { "items": { "description": "Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded.", "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])", "type": "string", "x-aisa-max-utf8-bytes": 128 }, "maxItems": 50, "type": [ "array", "null" ] }, "includeTags": { "items": { "description": "Non-empty after trimming; no CR/LF; UTF-8 byte length is bounded.", "pattern": "^[^\\r\\n]*\\S[^\\r\\n]*$(?![\\s\\S])", "type": "string", "x-aisa-max-utf8-bytes": 128 }, "maxItems": 50, "type": [ "array", "null" ] }, "maxAge": { "maximum": 31536000000, "minimum": 0, "type": [ "integer", "null" ] }, "minAge": { "maximum": 31536000000, "minimum": 0, "type": [ "integer", "null" ] }, "onlyMainContent": { "type": [ "boolean", "null" ] }, "timeout": { "maximum": 300000, "minimum": 1000, "type": [ "integer", "null" ] } }, "type": [ "object", "null" ] }, "sitemap": { "enum": [ null, "skip", "include", "only" ], "type": [ "string", "null" ] }, "url": { "description": "HTTPS URL with a hostname, without credentials or fragment. Trimmed input ending in .pdf (case insensitive) is not supported.", "pattern": "^\\s*[hH][tT][tT][pP][sS]://", "type": "string" } }, "required": [ "url", "limit" ], "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": "Firecrawl Crawl 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": "firecrawl", "x-aisa-contract-source": "handler", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search/post_firecrawl-crawl", "x-aisa-lifecycle": { "action": "submit", "kind": "asynchronous" }, "x-aisa-pricing": { "customer_unit_price_usd": 0.005, "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": "unavailable", "estimate_unavailable_reason": "request_dependent_units", "kind": "metered_result" }, "x-aisa-revision": { "handler_contract_hash": "e75fd62cbc55d7c4d7bef5cb153b0108a576b65010ec344e3d90a5d64cc2a8df" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "post_firecrawl_crawl", "path": "/apis/v1/firecrawl/crawl" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime" } }, "/apis/v1/firecrawl/crawl/{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_firecrawl_crawl_job", "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": "Firecrawl Crawl 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": "firecrawl", "x-aisa-contract-source": "handler", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search/get_firecrawl-crawl-job", "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": "a2665e8dc45f0cebb849b77c479299cd53c39f2fd6bf6766bb9dd3644eadc005" }, "x-aisa-runtime-operation": { "method": "GET", "operation_id": "get_firecrawl_apis_v1_firecrawl_crawl_jobid", "path": "/apis/v1/firecrawl/crawl/{jobId}" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime" } }, "/apis/v1/firecrawl/crawl/{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_firecrawl_apis_v1_firecrawl_crawl_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": "Firecrawl Crawl 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": "firecrawl", "x-aisa-contract-source": "handler", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/firecrawl/post_firecrawl_apis_v1_firecrawl_crawl_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": "2635b6bebd027291c47781094a9189e5b033d4d409a713c041b6d50600b79d0c" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "post_firecrawl_apis_v1_firecrawl_crawl_jobid_cancel", "path": "/apis/v1/firecrawl/crawl/{jobId}/cancel" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime" } }, "/apis/v1/firecrawl/map": { "post": { "description": "\n按用量计费；默认请求预估费用：$0.001071 USD（不是固定价格）。 声明的单位费率：每 firecrawl_credit $0.001071 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_firecrawl_map", "requestBody": { "content": { "application/json": { "examples": { "default": { "value": { "limit": 1, "url": "https://example.com" } }, "minimal": { "value": { "limit": 1, "url": "https://example.com" } } }, "schema": { "additionalProperties": false, "properties": { "limit": { "maximum": 100000, "minimum": 1, "type": "integer" }, "url": { "format": "https_url", "type": "string" } }, "required": [ "limit", "url" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "creditsUsed": { "description": "消耗的 Firecrawl credits（每发现一个链接 1 个）。", "type": "integer" }, "links": { "description": "发现的链接。", "items": { "properties": { "title": { "description": "所发现页面的标题（如果有）。", "type": "string" }, "url": { "description": "一个已发现的 URL。", "type": "string" } }, "type": "object" }, "type": "array" }, "success": { "description": "map 成功时为 true。", "type": "boolean" } }, "type": "object" } } }, "description": "map 成功完成。" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Firecrawl Map", "tags": [ "firecrawl" ], "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": "firecrawl", "x-aisa-category": "web research", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search/post_firecrawl-map", "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.001071, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 100000, "reserve_plan_units": { "input": "limit", "input_multiplier": 1 }, "unit": "firecrawl_credit", "unit_rate_usd": 0.001071 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-source": { "content_hash": "sha256:c4bcfe954b85ba0de7b33eba2d98a383533b7cd68cb6efc3c7a7e1a70defd115", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:84d19152ea50a835f85c707843789ad8827c2ba620da86c4e6825eb92fad81f2", "converter": "scripts/prepare_response_source_migration.py@1", "fetched_at": "2026-10-08T16:19:47.155165+00:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4ebe61b15b6f069166c1e92ba1829f7ba4a9e5bd8d87f5fa7a700190a44e45a5", "refresh_policy": "pinned", "refresh_reason": "Public response migration requires per-route binding and semantic review.", "response_only": true, "review_evidence": "Retain the exact existing typed public response from pinned AIsa Docs 3a00a91fb8db83d033b3008209c0d598d3866c54; operation ID and public route match. The current SELECT-only metadata proves the same Profile reference as frozen W0, verified target ownership, no query/encoding/managed transform, and the expected official provider origin. No response fields, requiredness, examples, or status were inferred or widened. Actual complete current Runtime projection and release approval remain required.", "review_period_days": 30, "source_document_sha256": "7c2fe218576e96d9be5d49f29603b770417622c524f759ea5617c827e197af59", "source_revision": "3a00a91fb8db83d033b3008209c0d598d3866c54", "upstream_origin_sha256": "501ba605eb40ddea56b66725ba29303a39abf4bc5da716121834ea138b558314", "upstream_path_sha256": "2f5dd4a81235c60425e866ee9f422b7fef02a5394037bd573d2ad5812f9c1ef6", "url": "https://github.com/AIsa-team/docs/blob/3a00a91fb8db83d033b3008209c0d598d3866c54/openapi/firecrawl.json" } }, "x-aisa-response-upstream-origin-sha256": "501ba605eb40ddea56b66725ba29303a39abf4bc5da716121834ea138b558314", "x-aisa-response-upstream-path-sha256": "2f5dd4a81235c60425e866ee9f422b7fef02a5394037bd573d2ad5812f9c1ef6", "x-aisa-revision": { "customer_pricing_ref": "d3a91f5aa1c1", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "bfef30019768" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "post_firecrawl_map", "path": "/apis/v1/firecrawl/map" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "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/firecrawl/map \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"limit\": 1,\n \"url\": \"https://example.com\"\n}'" } ] } }, "/apis/v1/firecrawl/parse": { "post": { "description": "\n按用量计费；默认请求预估费用：$0.001071 USD（不是固定价格）。 声明的单位费率：每 firecrawl_credit $0.001071 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_firecrawl_parse", "requestBody": { "content": { "application/json": { "examples": { "default": { "value": { "file": "example.htm", "options": "{\"formats\":[\"markdown\"],\"proxy\":\"basic\"}" } }, "minimal": { "value": { "file": "example.htm", "options": "{\"formats\":[\"markdown\"],\"proxy\":\"basic\"}" } } }, "schema": { "additionalProperties": false, "properties": { "file": { "type": "string", "x-aisa-allowed-suffixes": [ ".htm", ".html" ] }, "options": { "enum": [ "{\"formats\":[\"markdown\"],\"proxy\":\"basic\"}" ], "type": "string" } }, "required": [ "file", "options" ], "type": "object" } }, "application/x-www-form-urlencoded": { "schema": { "additionalProperties": false, "properties": { "file": { "type": "string", "x-aisa-allowed-suffixes": [ ".htm", ".html" ] }, "options": { "enum": [ "{\"formats\":[\"markdown\"],\"proxy\":\"basic\"}" ], "type": "string" } }, "required": [ "file", "options" ], "type": "object" } }, "multipart/form-data": { "encoding": { "file": { "contentType": "text/plain" }, "options": { "contentType": "text/plain" } }, "schema": { "additionalProperties": false, "description": "Each field is a single text/plain part; repeated fields and JSON object/array parts are not supported.", "properties": { "file": { "type": "string", "x-aisa-allowed-suffixes": [ ".htm", ".html" ] }, "options": { "enum": [ "{\"formats\":[\"markdown\"],\"proxy\":\"basic\"}" ], "type": "string" } }, "required": [ "file", "options" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "creditsUsed": { "description": "消耗的 Firecrawl credits（1 个）。", "type": "integer" }, "data": { "properties": { "markdown": { "description": "以 markdown 表示的解析内容。", "type": "string" } }, "type": "object" }, "success": { "description": "解析成功时为 true。", "type": "boolean" } }, "type": "object" } } }, "description": "解析成功完成。" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Firecrawl 解析", "tags": [ "firecrawl" ], "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": "firecrawl", "x-aisa-category": "web research", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search/post_firecrawl-parse", "x-aisa-pricing": { "cost_contract": "plan_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.001071, "estimate_source": "profile_seed", "evidence_source": "request_snapshot", "request_cost_drivers": { "formula": { "fixed_units": 1 }, "inputs": [], "kind": "plan_units" }, "unit": "firecrawl_credit", "unit_rate_usd": 0.001071 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-source": { "content_hash": "sha256:917bcf0c0841f762dca0d4066b976d962bc954a663b0e249260f935f8ef9ae53", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:7d7e2b02aca4d2e630f6f472ab6f946261f5178570c2dd79cecf4212f27eb36a", "converter": "scripts/prepare_response_source_migration.py@1", "fetched_at": "2026-10-08T16:19:47.155165+00:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4ebe61b15b6f069166c1e92ba1829f7ba4a9e5bd8d87f5fa7a700190a44e45a5", "refresh_policy": "pinned", "refresh_reason": "Public response migration requires per-route binding and semantic review.", "response_only": true, "review_evidence": "Retain the exact existing typed public response from pinned AIsa Docs 3a00a91fb8db83d033b3008209c0d598d3866c54; operation ID and public route match. The current SELECT-only metadata proves the same Profile reference as frozen W0, verified target ownership, no query/encoding/managed transform, and the expected official provider origin. No response fields, requiredness, examples, or status were inferred or widened. Actual complete current Runtime projection and release approval remain required.", "review_period_days": 30, "source_document_sha256": "7c2fe218576e96d9be5d49f29603b770417622c524f759ea5617c827e197af59", "source_revision": "3a00a91fb8db83d033b3008209c0d598d3866c54", "upstream_origin_sha256": "501ba605eb40ddea56b66725ba29303a39abf4bc5da716121834ea138b558314", "upstream_path_sha256": "bda00351641c8786c62095c7692c19ad45b2931fc882bc4d5bdb4b202ef4d646", "url": "https://github.com/AIsa-team/docs/blob/3a00a91fb8db83d033b3008209c0d598d3866c54/openapi/firecrawl.json" } }, "x-aisa-response-upstream-origin-sha256": "501ba605eb40ddea56b66725ba29303a39abf4bc5da716121834ea138b558314", "x-aisa-response-upstream-path-sha256": "bda00351641c8786c62095c7692c19ad45b2931fc882bc4d5bdb4b202ef4d646", "x-aisa-revision": { "customer_pricing_ref": "d3a91f5aa1c1", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "e1175a3f98ad" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "post_firecrawl_parse", "path": "/apis/v1/firecrawl/parse" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime" } }, "/apis/v1/firecrawl/scrape": { "post": { "description": "\n按用量计费；默认请求预估费用：$0.001071 USD（不是固定价格）。 声明的单位费率：每 firecrawl_credit $0.001071 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_firecrawl_scrape", "requestBody": { "content": { "application/json": { "examples": { "default": { "value": { "proxy": "basic", "url": "https://example.com" } }, "minimal": { "value": { "proxy": "basic", "url": "https://example.com" } } }, "schema": { "additionalProperties": false, "properties": { "formats": { "enum": [ [ "markdown" ] ], "items": { "type": "string" }, "maxItems": 1, "minItems": 1, "type": "array" }, "onlyCleanContent": { "enum": [ false ], "type": "boolean" }, "proxy": { "enum": [ "basic" ], "type": "string" }, "url": { "format": "https_url", "type": "string", "x-aisa-forbidden-suffixes": [ ".pdf" ] } }, "required": [ "proxy", "url" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "creditsUsed": { "description": "该请求消耗的 Firecrawl credits（每页 1 个）。", "type": "integer" }, "data": { "properties": { "markdown": { "description": "以 markdown 表示的抓取页面内容。", "type": "string" }, "metadata": { "description": "页面元数据，例如标题、描述、来源 URL 和 HTTP 状态。", "properties": { "description": { "type": "string" }, "sourceURL": { "type": "string" }, "statusCode": { "type": "integer" }, "title": { "type": "string" } }, "type": "object" } }, "type": "object" }, "success": { "description": "抓取成功时为 true。", "type": "boolean" } }, "type": "object" } } }, "description": "抓取成功完成。" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Firecrawl 抓取", "tags": [ "firecrawl" ], "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": "firecrawl", "x-aisa-category": "web research", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search/post_firecrawl-scrape", "x-aisa-pricing": { "cost_contract": "plan_units", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.001071, "estimate_source": "profile_seed", "evidence_source": "request_snapshot", "request_cost_drivers": { "formula": { "fixed_units": 1 }, "inputs": [], "kind": "plan_units" }, "unit": "firecrawl_credit", "unit_rate_usd": 0.001071 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-source": { "content_hash": "sha256:32e1db4796ead98786c19b19ec1c61e0b985cb1da568a85dc646d9c1b5cc2fa6", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:34666cc2a538956a35db88c0e2f53dc6d278d77f546295330dbfb87df8167dd4", "converter": "scripts/prepare_response_source_migration.py@1", "fetched_at": "2026-10-08T16:19:47.155165+00:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4ebe61b15b6f069166c1e92ba1829f7ba4a9e5bd8d87f5fa7a700190a44e45a5", "refresh_policy": "pinned", "refresh_reason": "Public response migration requires per-route binding and semantic review.", "response_only": true, "review_evidence": "Retain the exact existing typed public response from pinned AIsa Docs 3a00a91fb8db83d033b3008209c0d598d3866c54; operation ID and public route match. The current SELECT-only metadata proves the same Profile reference as frozen W0, verified target ownership, no query/encoding/managed transform, and the expected official provider origin. No response fields, requiredness, examples, or status were inferred or widened. Actual complete current Runtime projection and release approval remain required.", "review_period_days": 30, "source_document_sha256": "7c2fe218576e96d9be5d49f29603b770417622c524f759ea5617c827e197af59", "source_revision": "3a00a91fb8db83d033b3008209c0d598d3866c54", "upstream_origin_sha256": "501ba605eb40ddea56b66725ba29303a39abf4bc5da716121834ea138b558314", "upstream_path_sha256": "095d454c644c65dead905b3cfbc5e675f0c169a097fcddd798b4d9f54dd73d6a", "url": "https://github.com/AIsa-team/docs/blob/3a00a91fb8db83d033b3008209c0d598d3866c54/openapi/firecrawl.json" } }, "x-aisa-response-upstream-origin-sha256": "501ba605eb40ddea56b66725ba29303a39abf4bc5da716121834ea138b558314", "x-aisa-response-upstream-path-sha256": "095d454c644c65dead905b3cfbc5e675f0c169a097fcddd798b4d9f54dd73d6a", "x-aisa-revision": { "customer_pricing_ref": "d3a91f5aa1c1", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "737398117e67" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "post_firecrawl_scrape", "path": "/apis/v1/firecrawl/scrape" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "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/firecrawl/scrape \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"proxy\": \"basic\",\n \"url\": \"https://example.com\"\n}'" } ] } }, "/apis/v1/firecrawl/search": { "post": { "description": "\n按用量计费；默认请求预估费用：$0.002142 USD（不是固定价格）。 声明的单位费率：每 firecrawl_credit $0.001071 USD。 最终费用以账户适用价格及实际结算为准。\n", "operationId": "post_firecrawl_search", "requestBody": { "content": { "application/json": { "examples": { "default": { "value": { "enterprise": false, "limit": 10, "query": "nike", "sources": [ "web" ] } }, "minimal": { "value": { "query": "nike" } } }, "schema": { "additionalProperties": false, "properties": { "enterprise": { "default": false, "enum": [ false ], "type": "boolean" }, "limit": { "default": 10, "maximum": 100, "minimum": 1, "type": "integer" }, "query": { "maxLength": 2000, "minLength": 1, "type": "string" }, "sources": { "default": [ "web" ], "enum": [ [ "web" ] ], "items": { "type": "string" }, "maxItems": 1, "minItems": 1, "type": "array" } }, "required": [ "query" ], "type": "object" } } }, "required": true }, "responses": { "200": { "content": { "application/json": { "schema": { "properties": { "creditsUsed": { "description": "消耗的 Firecrawl credits（约每 10 条结果 2 个）。", "type": "integer" }, "data": { "properties": { "web": { "description": "排序后的网页搜索结果。", "items": { "properties": { "description": { "description": "结果摘要片段。", "type": "string" }, "title": { "description": "结果标题。", "type": "string" }, "url": { "description": "结果 URL。", "type": "string" } }, "type": "object" }, "type": "array" } }, "type": "object" }, "success": { "description": "搜索成功时为 true。", "type": "boolean" } }, "type": "object" } } }, "description": "搜索成功完成。" }, "default": { "content": { "application/json": { "schema": {} } }, "description": "Error response; upstream passthrough responses may use provider formats" } }, "summary": "Firecrawl 搜索", "tags": [ "firecrawl" ], "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": "firecrawl", "x-aisa-category": "web research", "x-aisa-docs-url": "https://aisa.one/docs/api-reference/search/post_firecrawl-search", "x-aisa-pricing": { "cost_contract": "response_count", "customer_multiplier": 1.0, "customer_pricing": "provider_cost_multiplier", "default_request_estimate_usd": 0.002142, "estimate_source": "profile_seed", "evidence_source": "response_body", "maximum_units": 100, "reserve_plan_units": { "input": "limit", "input_multiplier": 2, "unit_rounding": "ceil", "unit_scale": 10 }, "unit": "firecrawl_credit", "unit_rate_usd": 0.001071 }, "x-aisa-query-policy": { "ignore_undeclared": false, "request_wins": false }, "x-aisa-response-passthrough": true, "x-aisa-response-source": { "content_hash": "sha256:bc3ed006cd7efd8bc73a614bd9319f54a3fedaa0306b3facf970ce3d3312655d", "kind": "upstream_success_contract", "source": { "content_hash": "sha256:e2dfcb61452f6e88a9d90137282eda2fa9dbac8ade15c157b633415813499f72", "converter": "scripts/prepare_response_source_migration.py@1", "fetched_at": "2026-10-08T16:19:47.155165+00:00", "kind": "manual", "owner": "AIsa-team/docs", "path_space": "public", "policy_revision": "sha256:4ebe61b15b6f069166c1e92ba1829f7ba4a9e5bd8d87f5fa7a700190a44e45a5", "refresh_policy": "pinned", "refresh_reason": "Public response migration requires per-route binding and semantic review.", "response_only": true, "review_evidence": "Retain the exact existing typed public response from pinned AIsa Docs 3a00a91fb8db83d033b3008209c0d598d3866c54; operation ID and public route match. The current SELECT-only metadata proves the same Profile reference as frozen W0, verified target ownership, no query/encoding/managed transform, and the expected official provider origin. No response fields, requiredness, examples, or status were inferred or widened. Actual complete current Runtime projection and release approval remain required.", "review_period_days": 30, "source_document_sha256": "7c2fe218576e96d9be5d49f29603b770417622c524f759ea5617c827e197af59", "source_revision": "3a00a91fb8db83d033b3008209c0d598d3866c54", "upstream_origin_sha256": "501ba605eb40ddea56b66725ba29303a39abf4bc5da716121834ea138b558314", "upstream_path_sha256": "6d059e0a1903089e31ec2d88dd29975e4e3c084871faf6902aeb5cb286b7ecf6", "url": "https://github.com/AIsa-team/docs/blob/3a00a91fb8db83d033b3008209c0d598d3866c54/openapi/firecrawl.json" } }, "x-aisa-response-upstream-origin-sha256": "501ba605eb40ddea56b66725ba29303a39abf4bc5da716121834ea138b558314", "x-aisa-response-upstream-path-sha256": "6d059e0a1903089e31ec2d88dd29975e4e3c084871faf6902aeb5cb286b7ecf6", "x-aisa-revision": { "customer_pricing_ref": "d3a91f5aa1c1", "plan_policy_version": "e70a0959cd1b93b84ae16dffd7a538273ddb9c1d46277b82823c37ff1b6bc0fb", "profile_ref": "7a49a2982dac" }, "x-aisa-runtime-operation": { "method": "POST", "operation_id": "post_firecrawl_search", "path": "/apis/v1/firecrawl/search" }, "x-aisa-status": "enabled", "x-aisa-validation": "runtime", "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/firecrawl/search \\\n --header 'Authorization: Bearer ' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"enterprise\": false,\n \"limit\": 10,\n \"query\": \"nike\",\n \"sources\": [\n \"web\"\n ]\n}'" } ] } } }, "security": [ { "bearerAuth": [] } ], "servers": [ { "url": "https://api.aisa.one" } ] }