Téléverser et analyser un fichier
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>",
"numPages": 123,
"ogLocaleAlternate": [
"<string>"
],
"sourceURL": "<string>",
"statusCode": 123,
"title": "<string>",
"totalPages": 123,
"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
}Points de terminaison d’analyse
Parse
POST
/
parse
Téléverser et analyser un fichier
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>",
"numPages": 123,
"ogLocaleAlternate": [
"<string>"
],
"sourceURL": "<string>",
"statusCode": 123,
"title": "<string>",
"totalPages": 123,
"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
}Téléversez un document local ou non public et convertissez-le en données propres, prêtes pour le LLM. Quand utiliser
Utilisez
/parse accepte le fichier via multipart/form-data et renvoie du Markdown, du JSON, du HTML, des liens, des images ou un résumé, tout en préservant l’ordre de lecture et les tableaux.
- Convertissez des PDF, DOCX, XLSX, HTML et bien plus en Markdown ou en JSON structuré
- Jusqu’à 5x plus rapide grâce à un moteur Rust
- Jusqu’à 50 MB par requête
- Prise en charge du Zero Data Retention
Quand utiliser /parse
/parse lorsque le document source est un fichier local ou n’est pas accessible publiquement via une URL. Si vous disposez d’une URL publique pointant vers un document, privilégiez /scrape — ce point de terminaison détecte automatiquement le type de fichier à partir de l’extension ou du type de contenu et l’analyse de la même façon.
| Source | Point de terminaison |
|---|---|
URL publique pointant vers un document (par ex. https://example.com/report.pdf) | POST /scrape |
| Fichier local ou données binaires non publiques (PDF, DOCX, XLSX, HTML, …) | POST /parse (ce point de terminaison) |
Vous utilisez Firecrawl via MCP ? Utilisez
firecrawl_parse pour les fichiers locaux. MCP local peut lire le fichier directement lorsqu’il est configuré avec FIRECRAWL_API_URL. Le MCP distant hébergé renvoie d’abord une commande d’upload temporaire, puis analyse l’uploadRef renvoyé. Les URL publiques de documents doivent toujours utiliser /scrape.Autorisations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Corps
multipart/form-data
⌘I

