curl --request POST \
--url https://api.aisa.one/apis/v1/firecrawl/parse \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"file": "example.htm",
"options": "{\"formats\":[\"markdown\"],\"proxy\":\"basic\"}"
}
'{
"creditsUsed": 123,
"data": {
"markdown": "<string>"
},
"success": true
}Firecrawl
Firecrawl Parse
Parse an HTML file you upload and get markdown back.
POST
https://api.aisa.one
/
apis
/
v1
/
firecrawl
/
parse
curl --request POST \
--url https://api.aisa.one/apis/v1/firecrawl/parse \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"file": "example.htm",
"options": "{\"formats\":[\"markdown\"],\"proxy\":\"basic\"}"
}
'{
"creditsUsed": 123,
"data": {
"markdown": "<string>"
},
"success": true
}Parse an HTML file you upload and get markdown back. This is
multipart/form-data with two fields: file (an HTML upload that must carry a text/html content type or an .html/.htm filename) and options (a JSON string that must set proxy to basic, may additionally set formats to ["markdown"], and is capped at 64 KB). Returns success and data.markdown with metadata. Billed 1 Firecrawl credit. ⚠️ Not available as an MCP tool. A tool call carries JSON, so the file arrives as a plain form field with no filename and upstream rejects it — verified. Over MCP use post_firecrawl_scrape with a URL instead. This endpoint is for HTTP clients that hold an actual file.
Request contract
- Method and path: POST /apis/v1/firecrawl/parse
- Availability: enabled
- Request URL template:
https://api.aisa.one/apis/v1/firecrawl/parse - Runtime facts: 82ca6e32a3422a9fdc47fb987d84d177f6e0ef05d5eae36691e5f7b3911d092f
{
"operationId": "post_firecrawl_parse",
"method": "POST",
"path": "/apis/v1/firecrawl/parse",
"servers": [
{
"url": "https://api.aisa.one"
}
],
"parameters": [],
"security": [
{
"bearerAuth": []
}
],
"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
},
"x-aisa-status": "enabled",
"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
},
"components": {
"securitySchemes": {
"bearerAuth": {
"scheme": "bearer",
"type": "http"
}
}
}
}
Cost and request rules
Usage-based billing; Default request estimate: $0.001071 USD (not a fixed price). Declared unit rate: $0.001071 USD per firecrawl_credit. Account-specific pricing and final settlement may differ. Published reference values are not an account-specific quote or a settled charge. For endpoints supporting X-AISA-Cost-Mode: quote, obtain a free quote for your exact request before execution; reconcile the settled cost with response metadata and Usage Logs. USD amounts use 1,000,000 integer micro-USD per dollar.- Default request reference estimate (USD): 0.001071
- Declared unit rate (USD): 0.001071
- Billing unit: firecrawl_credit
- Cost contract: plan_units
- Published reference multiplier: 1.0
- Settlement evidence source: request_snapshot
Declared request billing units
- Units: 1
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/jsonapplication/x-www-form-urlencodedmultipart/form-data