Envie e analise um arquivo
curl --request POST \
--url https://api.firecrawl.dev/v2/parse \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form file='@example-file' \
--form 'options={
"blockAds": true,
"excludeTags": [
"<string>"
],
"formats": [
"markdown"
],
"headers": {},
"includeTags": [
"<string>"
],
"integration": "<string>",
"onlyMainContent": true,
"origin": "api",
"parsers": [
"pdf"
],
"redactPII": false,
"removeBase64Images": true,
"skipTlsVerification": true,
"timeout": 30000,
"zeroDataRetention": false
}'{
"data": {
"actions": {
"javascriptReturns": [
{
"type": "<string>",
"value": "<unknown>"
}
],
"pdfs": [
"<string>"
],
"scrapes": [
{
"html": "<string>",
"url": "<string>"
}
],
"screenshots": [
"<string>"
]
},
"answer": "<string>",
"audio": "<string>",
"branding": {
"animations": {},
"colors": {
"accent": "<string>",
"background": "<string>",
"error": "<string>",
"link": "<string>",
"primary": "<string>",
"secondary": "<string>",
"success": "<string>",
"textPrimary": "<string>",
"textSecondary": "<string>",
"warning": "<string>"
},
"components": {
"buttonPrimary": {
"background": "<string>",
"borderRadius": "<string>",
"textColor": "<string>"
},
"buttonSecondary": {
"background": "<string>",
"borderColor": "<string>",
"borderRadius": "<string>",
"textColor": "<string>"
},
"input": {}
},
"fonts": [
{
"family": "<string>"
}
],
"icons": {},
"images": {
"favicon": "<string>",
"logo": "<string>",
"ogImage": "<string>"
},
"layout": {},
"logo": "<string>",
"personality": {},
"spacing": {
"baseUnit": 123,
"borderRadius": "<string>",
"margins": {},
"padding": {}
},
"typography": {
"fontFamilies": {
"code": "<string>",
"heading": "<string>",
"primary": "<string>"
},
"fontSizes": {
"body": "<string>",
"h1": "<string>",
"h2": "<string>",
"h3": "<string>"
},
"fontWeights": {
"bold": 123,
"light": 123,
"medium": 123,
"regular": 123
},
"lineHeights": {
"body": "<string>",
"heading": "<string>"
}
}
},
"changeTracking": {
"diff": "<string>",
"json": {},
"previousScrapeAt": "2023-11-07T05:31:56Z"
},
"highlights": "<string>",
"html": "<string>",
"links": [
"<string>"
],
"markdown": "<string>",
"menu": {
"isMenu": true,
"sections": [
{
"items": [
{
"name": "<string>",
"availability": {
"inStock": true,
"text": "<string>"
},
"calories": 123,
"description": "<string>",
"dietary": [
"<string>"
],
"id": "<string>",
"identifiers": {
"merchantItemId": "<string>"
},
"images": [
{
"url": "<string>",
"alt": "<string>"
}
],
"optionGroups": [
{}
],
"price": {
"amount": 123,
"currency": "<string>",
"formatted": "<string>"
},
"sourceUrl": "<string>",
"url": "<string>"
}
],
"name": "<string>",
"description": "<string>",
"id": "<string>"
}
],
"confidence": 123,
"currency": "<string>",
"merchant": {
"name": "<string>",
"type": "<string>"
},
"sourceUrl": "<string>"
},
"metadata": {
"<any other metadata> ": "<string>",
"concurrencyLimited": true,
"concurrencyQueueDurationMs": 123,
"contentType": "<string>",
"description": "<string>",
"error": "<string>",
"keywords": "<string>",
"language": "<string>",
"ogLocaleAlternate": [
"<string>"
],
"sourceURL": "<string>",
"statusCode": 123,
"title": "<string>",
"url": "<string>"
},
"product": {
"title": "<string>",
"url": "<string>",
"variants": [
{
"availability": {
"inStock": true,
"text": "<string>"
},
"id": "<string>",
"images": [
{
"url": "<string>",
"alt": "<string>"
}
],
"price": {
"amount": 123,
"currency": "<string>",
"formatted": "<string>"
},
"sale": {
"originalPrice": {
"amount": 123,
"currency": "<string>",
"formatted": "<string>"
}
},
"sku": "<string>",
"title": "<string>",
"values": {}
}
],
"brand": "<string>",
"category": "<string>",
"description": "<string>"
},
"rawHtml": "<string>",
"screenshot": "<string>",
"summary": "<string>",
"video": "<string>",
"warning": "<string>"
},
"success": true
}Endpoints de parse
Parse
POST
/
parse
Envie e analise um arquivo
curl --request POST \
--url https://api.firecrawl.dev/v2/parse \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: multipart/form-data' \
--form file='@example-file' \
--form 'options={
"blockAds": true,
"excludeTags": [
"<string>"
],
"formats": [
"markdown"
],
"headers": {},
"includeTags": [
"<string>"
],
"integration": "<string>",
"onlyMainContent": true,
"origin": "api",
"parsers": [
"pdf"
],
"redactPII": false,
"removeBase64Images": true,
"skipTlsVerification": true,
"timeout": 30000,
"zeroDataRetention": false
}'{
"data": {
"actions": {
"javascriptReturns": [
{
"type": "<string>",
"value": "<unknown>"
}
],
"pdfs": [
"<string>"
],
"scrapes": [
{
"html": "<string>",
"url": "<string>"
}
],
"screenshots": [
"<string>"
]
},
"answer": "<string>",
"audio": "<string>",
"branding": {
"animations": {},
"colors": {
"accent": "<string>",
"background": "<string>",
"error": "<string>",
"link": "<string>",
"primary": "<string>",
"secondary": "<string>",
"success": "<string>",
"textPrimary": "<string>",
"textSecondary": "<string>",
"warning": "<string>"
},
"components": {
"buttonPrimary": {
"background": "<string>",
"borderRadius": "<string>",
"textColor": "<string>"
},
"buttonSecondary": {
"background": "<string>",
"borderColor": "<string>",
"borderRadius": "<string>",
"textColor": "<string>"
},
"input": {}
},
"fonts": [
{
"family": "<string>"
}
],
"icons": {},
"images": {
"favicon": "<string>",
"logo": "<string>",
"ogImage": "<string>"
},
"layout": {},
"logo": "<string>",
"personality": {},
"spacing": {
"baseUnit": 123,
"borderRadius": "<string>",
"margins": {},
"padding": {}
},
"typography": {
"fontFamilies": {
"code": "<string>",
"heading": "<string>",
"primary": "<string>"
},
"fontSizes": {
"body": "<string>",
"h1": "<string>",
"h2": "<string>",
"h3": "<string>"
},
"fontWeights": {
"bold": 123,
"light": 123,
"medium": 123,
"regular": 123
},
"lineHeights": {
"body": "<string>",
"heading": "<string>"
}
}
},
"changeTracking": {
"diff": "<string>",
"json": {},
"previousScrapeAt": "2023-11-07T05:31:56Z"
},
"highlights": "<string>",
"html": "<string>",
"links": [
"<string>"
],
"markdown": "<string>",
"menu": {
"isMenu": true,
"sections": [
{
"items": [
{
"name": "<string>",
"availability": {
"inStock": true,
"text": "<string>"
},
"calories": 123,
"description": "<string>",
"dietary": [
"<string>"
],
"id": "<string>",
"identifiers": {
"merchantItemId": "<string>"
},
"images": [
{
"url": "<string>",
"alt": "<string>"
}
],
"optionGroups": [
{}
],
"price": {
"amount": 123,
"currency": "<string>",
"formatted": "<string>"
},
"sourceUrl": "<string>",
"url": "<string>"
}
],
"name": "<string>",
"description": "<string>",
"id": "<string>"
}
],
"confidence": 123,
"currency": "<string>",
"merchant": {
"name": "<string>",
"type": "<string>"
},
"sourceUrl": "<string>"
},
"metadata": {
"<any other metadata> ": "<string>",
"concurrencyLimited": true,
"concurrencyQueueDurationMs": 123,
"contentType": "<string>",
"description": "<string>",
"error": "<string>",
"keywords": "<string>",
"language": "<string>",
"ogLocaleAlternate": [
"<string>"
],
"sourceURL": "<string>",
"statusCode": 123,
"title": "<string>",
"url": "<string>"
},
"product": {
"title": "<string>",
"url": "<string>",
"variants": [
{
"availability": {
"inStock": true,
"text": "<string>"
},
"id": "<string>",
"images": [
{
"url": "<string>",
"alt": "<string>"
}
],
"price": {
"amount": 123,
"currency": "<string>",
"formatted": "<string>"
},
"sale": {
"originalPrice": {
"amount": 123,
"currency": "<string>",
"formatted": "<string>"
}
},
"sku": "<string>",
"title": "<string>",
"values": {}
}
],
"brand": "<string>",
"category": "<string>",
"description": "<string>"
},
"rawHtml": "<string>",
"screenshot": "<string>",
"summary": "<string>",
"video": "<string>",
"warning": "<string>"
},
"success": true
}Envie um documento local ou não público e converta-o em dados limpos, prontos para LLM. O Quando usar
Use
/parse aceita os bytes do arquivo via multipart/form-data e retorna Markdown, JSON, HTML, links, imagens ou um resumo — com a ordem de leitura e as tabelas preservadas.
- Converta PDF, DOCX, XLSX, HTML e outros formatos em Markdown ou JSON estruturado
- Análise até 5x mais rápida com um mecanismo baseado em Rust
- Arquivos de até 50 MB por solicitação
- Suporte a Zero Data Retention
Quando usar /parse
/parse quando o documento de origem for um arquivo local ou não estiver acessível publicamente por URL. Se você tiver uma URL pública que aponte para um documento, prefira /scrape — ele detecta automaticamente o tipo de arquivo pela extensão ou pelo tipo de conteúdo e faz o parsing da mesma forma.
| Origem | Endpoint |
|---|---|
URL pública para um documento (por exemplo, https://example.com/report.pdf) | POST /scrape |
| Arquivo local ou bytes não públicos (PDF, DOCX, XLSX, HTML, …) | POST /parse (este endpoint) |
Usando o Firecrawl via MCP? Use
firecrawl_parse para arquivos locais. O MCP local pode ler o arquivo diretamente quando configurado com FIRECRAWL_API_URL. O MCP remoto hospedado primeiro retorna um comando de upload temporário e, em seguida, faz o parsing do uploadRef retornado. URLs públicas de documentos ainda devem usar /scrape.Autorizações
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Corpo
multipart/form-data
⌘I

