MarkUDown
API de PDF a Markdown — documentación del conversor de PDF MarkUDown
POST
/api/pdf-to-markdownPDF a Markdown
Sube un PDF y recibe su texto en Markdown, con los títulos detectados por el tamaño de letra. La petición es síncrona: el Markdown llega en la misma respuesta.
| Parámetro | Tipo | Requerido | Por defecto | Descripción |
|---|---|---|---|---|
| file | file (multipart/form-data) | requerido | — | El archivo PDF, enviado como multipart/form-data. Hasta 200 MB. |
Solicitud
curl -X POST https://api.scrapetechnology.com/api/pdf-to-markdown \
-H "X-API-KEY: your-api-key" \
-F "file=@report.pdf"Respuesta
{
"filename": "report.pdf",
"title": "Annual Report",
"markdown": "# Annual Report\n\nFirst paragraph...",
"page_count": 12,
"pages_processed": 12,
"truncated": false
}El texto se lee de la capa de texto del PDF: los PDF escaneados (solo imagen) devuelven poco o ningún texto, y las tablas y columnas no se reconstruyen.
Se leen hasta 500 páginas por archivo; truncated es true cuando quedaron páginas sin leer o el texto se recortó. title es el título del propio PDF, o el nombre del archivo cuando no tiene uno.
Costo: 1 crédito por cada 10 páginas leídas (mínimo 1), cobrado después de la conversión.
Errores
| Estado | Significado |
|---|---|
| 400 | El archivo no es un PDF. |
| 413 | Archivo de más de 200 MB. |
| 422 | No se pudo leer el PDF (¿dañado o protegido con contraseña?). |
| 504 | La conversión superó el tiempo límite. |