> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-noaa-mar-900-create-self-partnership-provisioning.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Procesar

Sube un documento local o privado y conviértelo en datos limpios, listos para LLM. `/parse` acepta los bytes del archivo mediante `multipart/form-data` y devuelve Markdown, JSON, HTML, enlaces, imágenes o un resumen, conservando el orden de lectura y las tablas.

* Convierte PDF, DOCX, XLSX, HTML y más en Markdown o JSON estructurado
* Procesamiento hasta **5x más rápido** con un motor basado en Rust
* Archivos de hasta **50 MB** por solicitud
* Compatibilidad con retención de datos cero

<div id="when-to-use-parse">
  ## Cuándo usar `/parse`
</div>

Usa `/parse` cuando el documento de origen sea **un archivo local** o **no sea accesible públicamente mediante una URL**. Si tienes una URL pública que apunta a un documento, es preferible usar [`/scrape`](/es/api-reference/endpoint/scrape): detecta automáticamente el tipo de archivo a partir de la extensión o del tipo de contenido y lo procesa de la misma forma.

| Origen                                                                | Endpoint                                            |
| --------------------------------------------------------------------- | --------------------------------------------------- |
| URL pública de un documento (p. ej. `https://example.com/report.pdf`) | [`POST /scrape`](/es/api-reference/endpoint/scrape) |
| Archivo local o bytes no públicos (PDF, DOCX, XLSX, HTML, …)          | `POST /parse` (este endpoint)                       |


## OpenAPI

````yaml /es/api-reference/v2-openapi.json POST /parse
openapi: 3.0.0
info:
  title: Firecrawl API
  version: v2
  description: >-
    API para interactuar con los servicios de Firecrawl y realizar tareas de
    scraping y rastreo web.
  contact:
    name: Firecrawl Support
    url: https://firecrawl.dev/support
    email: support@firecrawl.dev
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /parse:
    post:
      tags:
        - Scraping
      summary: Sube y procesa un archivo
      operationId: parseFile
      requestBody:
        required: true
        content:
          multipart/form-data:
            schema:
              type: object
              properties:
                file:
                  type: string
                  format: binary
                  description: >-
                    Los bytes del archivo que se van a procesar. Extensiones
                    compatibles: .html, .htm, .pdf, .docx, .doc, .odt, .rtf,
                    .xlsx, .xls.
                options:
                  $ref: '#/components/schemas/ParseOptions'
              required:
                - file
            encoding:
              options:
                contentType: application/json
      responses:
        '200':
          description: Respuesta correcta
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ScrapeResponse'
        '400':
          description: Solicitud incorrecta
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  code:
                    type: string
                    example: BAD_REQUEST
                  error:
                    type: string
                    example: Invalid multipart form-data request.
        '402':
          description: Pago requerido
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: Payment required to access this resource.
        '429':
          description: Demasiadas solicitudes
          content:
            application/json:
              schema:
                type: object
                properties:
                  error:
                    type: string
                    example: >-
                      Request rate limit exceeded. Please wait and try again
                      later.
        '500':
          description: Error del servidor
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: false
                  code:
                    type: string
                    example: UNKNOWN_ERROR
                  error:
                    type: string
                    example: An unexpected error occurred on the server.
      security:
        - bearerAuth: []
components:
  schemas:
    ParseOptions:
      type: object
      description: >-
        Opciones opcionales para procesar enviadas como JSON en el campo
        multipart `options`.
      properties:
        formats:
          $ref: '#/components/schemas/ParseFormats'
        onlyMainContent:
          type: boolean
          description: >-
            Devuelve solo el contenido principal de la página, excluyendo
            encabezados, navegación, pies de página, etc.
          default: true
        includeTags:
          type: array
          items:
            type: string
          description: Etiquetas que se incluirán en la salida.
        excludeTags:
          type: array
          items:
            type: string
          description: Etiquetas que se excluirán de la salida.
        headers:
          type: object
          description: >-
            Encabezados que se enviarán cuando se requieran solicitudes de red
            adicionales.
        timeout:
          type: integer
          description: >-
            Timeout en milisegundos para la solicitud. El valor predeterminado
            es 30000 (30 segundos). El máximo es 300000 (300 segundos).
          default: 30000
          maximum: 300000
        parsers:
          type: array
          description: >-
            Controla el comportamiento del procesador de archivos cuando
            corresponda (por ejemplo, el modo del procesador de PDF).
          items:
            oneOf:
              - type: object
                properties:
                  type:
                    type: string
                    enum:
                      - pdf
                  mode:
                    type: string
                    enum:
                      - fast
                      - auto
                      - ocr
                    default: auto
                    description: >-
                      Modo de procesamiento de PDF. "fast": extracción solo de
                      texto. "auto": primero texto, con OCR como alternativa.
                      "ocr": OCR en todas las páginas.
                  maxPages:
                    type: integer
                    minimum: 1
                    maximum: 10000
                    description: Número máximo de páginas que se procesarán del PDF.
                required:
                  - type
                additionalProperties: false
          default:
            - pdf
        skipTlsVerification:
          type: boolean
          description: Omite la verificación del certificado TLS al realizar solicitudes.
          default: true
        removeBase64Images:
          type: boolean
          description: >-
            Elimina de la salida las imágenes codificadas en base64 y conserva
            los marcadores de posición del texto alternativo.
          default: true
        blockAds:
          type: boolean
          description: Activa el bloqueo de anuncios y ventanas emergentes de cookies.
          default: true
        proxy:
          type: string
          enum:
            - basic
            - auto
          description: >-
            Modo proxy para cargas en `/parse`. `/parse` solo admite `basic` y
            `auto`.
        origin:
          type: string
          description: Identificador de origen para analítica y registros.
          default: api
        integration:
          type: string
          nullable: true
          description: Identificador de integración opcional.
        zeroDataRetention:
          type: boolean
          default: false
          description: >-
            Si es `true`, esto activará la retención cero de datos para este
            procesamiento. Para habilitar esta función, ponte en contacto con
            help@firecrawl.dev
    ScrapeResponse:
      type: object
      properties:
        success:
          type: boolean
        data:
          type: object
          properties:
            markdown:
              type: string
            summary:
              type: string
              nullable: true
              description: Resumen de la página si `summary` se incluye en `formats`
            html:
              type: string
              nullable: true
              description: >-
                HTML limpio de la página si `html` está incluido en `formatos`.
                Elimina las etiquetas `<script>`, `<style>`, `<noscript>`,
                `<meta>` y `<head>`; convierte las URL relativas en absolutas;
                resuelve el `srcset` de imágenes responsive a la variante de
                mayor tamaño. Respeta los filtros `onlyMainContent`,
                `includeTags` y `excludeTags`.
            rawHtml:
              type: string
              nullable: true
              description: >-
                El HTML exacto, sin modificar, tal como se recibe de la página
                si `rawHtml` está incluido en `formatos`. No se aplica ningún
                tipo de limpieza ni filtrado.
            screenshot:
              type: string
              nullable: true
              description: >-
                Captura de pantalla de la página si `screenshot` está incluido
                en `formats`. Las capturas de pantalla caducan después de 24
                horas y ya no podrán descargarse.
            audio:
              type: string
              nullable: true
              description: >-
                URL firmada del archivo de audio MP3 extraído si `audio` está en
                `formatos`. La URL firmada caduca al cabo de 1 hora.
            video:
              type: string
              nullable: true
              description: >-
                URL firmada del archivo de vídeo extraído si `video` está en
                `formats`. La URL firmada caduca al cabo de 1 hora.
            answer:
              type: string
              nullable: true
              description: >-
                Respuesta en lenguaje natural a la pregunta proporcionada
                mediante el formato `question`. Solo aparece si se incluyó un
                objeto de formato `question` en `formats`.
            highlights:
              type: string
              nullable: true
              description: >-
                Texto fuente relevante seleccionado por el formato `highlights`.
                Solo aparece si se incluyó un objeto de formato `highlights` en
                `formats`.
            links:
              type: array
              items:
                type: string
              description: >-
                Lista de enlaces de la página si `links` está incluido en
                `formats`
            actions:
              type: object
              nullable: true
              description: >-
                Resultados de las acciones especificadas en el parámetro
                `actions`. Solo aparece si se proporcionó el parámetro `actions`
                en la solicitud
              properties:
                screenshots:
                  type: array
                  description: >-
                    URLs de las capturas de pantalla, en el mismo orden que las
                    acciones de captura de pantalla indicadas.
                  items:
                    type: string
                    format: url
                scrapes:
                  type: array
                  description: >-
                    Extrae el contenido en el mismo orden que las acciones de
                    scraping proporcionadas.
                  items:
                    type: object
                    properties:
                      url:
                        type: string
                      html:
                        type: string
                javascriptReturns:
                  type: array
                  description: >-
                    Valores de retorno de JavaScript, en el mismo orden que las
                    acciones de executeJavascript proporcionadas.
                  items:
                    type: object
                    properties:
                      type:
                        type: string
                      value: {}
                pdfs:
                  type: array
                  description: >-
                    Archivos PDF generados en el mismo orden que las acciones de
                    PDF proporcionadas.
                  items:
                    type: string
            metadata:
              type: object
              properties:
                title:
                  oneOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                  description: >-
                    Título extraído de la página, puede ser una cadena de texto
                    o un array de cadenas de texto
                description:
                  oneOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                  description: >-
                    Descripción extraída de la página, puede ser una cadena de
                    texto o un array de cadenas
                language:
                  oneOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                  nullable: true
                  description: >-
                    Idioma extraído de la página; puede ser una cadena de texto
                    o un array de cadenas de texto
                sourceURL:
                  type: string
                  format: uri
                  description: >-
                    La URL original solicitada. Puede diferir de la URL final de
                    la página si hubo redirecciones.
                url:
                  type: string
                  format: uri
                  description: >-
                    La URL final de la página después de seguir todas las
                    redirecciones.
                keywords:
                  oneOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                  description: >-
                    Palabras clave extraídas de la página; puede ser una cadena
                    o un array de cadenas
                ogLocaleAlternate:
                  type: array
                  items:
                    type: string
                  description: Locales alternativos de la página
                '<any other metadata> ':
                  oneOf:
                    - type: string
                    - type: array
                      items:
                        type: string
                  description: >-
                    Otros metadatos extraídos del HTML, pueden ser una cadena o
                    un array de cadenas
                statusCode:
                  type: integer
                  description: El código de estado de la página
                contentType:
                  type: string
                  description: >-
                    El tipo de contenido (tipo MIME) de la página, por ejemplo,
                    text/html, application/pdf
                error:
                  type: string
                  nullable: true
                  description: El mensaje de error de la página
                concurrencyLimited:
                  type: boolean
                  description: >-
                    Si este scraping se limitó debido a los límites de
                    concurrencia del equipo
                concurrencyQueueDurationMs:
                  type: number
                  description: >-
                    Tiempo, en milisegundos, que la solicitud permaneció en la
                    cola de concurrencia. Solo se incluye cuando
                    concurrencyLimited es true.
            warning:
              type: string
              nullable: true
              description: >-
                Puede mostrarse al usar LLM Extraction. El mensaje de
                advertencia te informará de cualquier problema con la
                extracción.
            changeTracking:
              type: object
              nullable: true
              description: >-
                Información de seguimiento de cambios cuando `changeTracking`
                está en `formats`. Solo está presente cuando se solicita el
                formato `changeTracking`.
              properties:
                previousScrapeAt:
                  type: string
                  format: date-time
                  nullable: true
                  description: >-
                    La marca de tiempo del rastreo anterior con la que se
                    compara la página actual. Es null si no existe un rastreo
                    anterior.
                changeStatus:
                  type: string
                  enum:
                    - new
                    - same
                    - changed
                    - removed
                  description: >-
                    El resultado de la comparación entre las dos versiones de la
                    página. "new" indica que esta página no existía antes,
                    "same" indica que el contenido no ha cambiado, "changed"
                    indica que el contenido ha cambiado y "removed" indica que
                    la página fue eliminada.
                visibility:
                  type: string
                  enum:
                    - visible
                    - hidden
                  description: >-
                    La visibilidad de la página o URL actual. "visible"
                    significa que la URL se descubrió por una ruta orgánica
                    (enlaces o sitemap), y "hidden" significa que la URL se
                    descubrió a partir de la memoria de rastreos anteriores.
                diff:
                  type: string
                  nullable: true
                  description: >-
                    Diff de los cambios al estilo Git cuando se usa el modo
                    `git-diff`. Solo está presente cuando el modo está
                    configurado en `git-diff`.
                json:
                  type: object
                  nullable: true
                  description: >-
                    Resultados de comparación en JSON cuando se usa el modo
                    `json`. Solo aparece cuando el modo está configurado en
                    `json`. Genera una lista de todas las claves y sus valores
                    de los scrapes `previous` y `current`, según el tipo
                    definido en el `schema`. Ejemplo
                    [aquí](/features/change-tracking)
            branding:
              type: object
              nullable: true
              description: >-
                Información de marca extraída de la página si `branding` está
                incluido en `formatos`. Incluye colores, fuentes, tipografía,
                espaciado, componentes y más.
              properties:
                colorScheme:
                  type: string
                  enum:
                    - light
                    - dark
                  description: Paleta de colores detectada de la página.
                logo:
                  type: string
                  nullable: true
                  description: URL del logotipo principal.
                colors:
                  type: object
                  nullable: true
                  description: Colores de la marca extraídos de la página.
                  properties:
                    primary:
                      type: string
                      description: Color principal de la marca (hex).
                    secondary:
                      type: string
                      description: Color secundario de la marca (hex).
                    accent:
                      type: string
                      description: Color de acento (hex).
                    background:
                      type: string
                      description: Color de fondo (hex).
                    textPrimary:
                      type: string
                      description: Color principal del texto (hex).
                    textSecondary:
                      type: string
                      description: Color secundario del texto (hex).
                    link:
                      type: string
                      description: Color de los enlaces (hex).
                    success:
                      type: string
                      description: Color de éxito/positivo (hexadecimal).
                    warning:
                      type: string
                      description: Color de advertencia (hexadecimal).
                    error:
                      type: string
                      description: Color de error/peligro (hexadecimal).
                fonts:
                  type: array
                  nullable: true
                  description: Lista de familias tipográficas usadas en la página.
                  items:
                    type: object
                    properties:
                      family:
                        type: string
                        description: Nombre de la familia tipográfica.
                typography:
                  type: object
                  nullable: true
                  description: Información detallada sobre tipografía.
                  properties:
                    fontFamilies:
                      type: object
                      description: Familias tipográficas según su función.
                      properties:
                        primary:
                          type: string
                          description: Familia tipográfica principal.
                        heading:
                          type: string
                          description: Familia tipográfica para encabezados.
                        code:
                          type: string
                          description: Familia tipográfica para código (monoespaciada).
                    fontSizes:
                      type: object
                      description: Tamaños de fuente para diferentes jerarquías de texto.
                      properties:
                        h1:
                          type: string
                        h2:
                          type: string
                        h3:
                          type: string
                        body:
                          type: string
                    fontWeights:
                      type: object
                      description: Definiciones de pesos de fuente.
                      properties:
                        light:
                          type: integer
                        regular:
                          type: integer
                        medium:
                          type: integer
                        bold:
                          type: integer
                    lineHeights:
                      type: object
                      description: >-
                        Valores de altura de línea para diferentes tipos de
                        texto.
                      properties:
                        heading:
                          type: string
                        body:
                          type: string
                spacing:
                  type: object
                  nullable: true
                  description: Información de espaciado y maquetación.
                  properties:
                    baseUnit:
                      type: integer
                      description: Unidad base de espaciado en píxeles.
                    borderRadius:
                      type: string
                      description: Radio de borde por defecto.
                    padding:
                      type: object
                      description: Valores de espaciado interno (padding).
                    margins:
                      type: object
                      description: Valores de margen.
                components:
                  type: object
                  nullable: true
                  description: Estilos de componentes de la interfaz de usuario.
                  properties:
                    buttonPrimary:
                      type: object
                      description: Estilos del botón principal.
                      properties:
                        background:
                          type: string
                        textColor:
                          type: string
                        borderRadius:
                          type: string
                    buttonSecondary:
                      type: object
                      description: Estilos de botones secundarios.
                      properties:
                        background:
                          type: string
                        textColor:
                          type: string
                        borderColor:
                          type: string
                        borderRadius:
                          type: string
                    input:
                      type: object
                      description: Estilos de campos de entrada.
                icons:
                  type: object
                  nullable: true
                  description: Estilos de íconos.
                images:
                  type: object
                  nullable: true
                  description: Imágenes de la marca.
                  properties:
                    logo:
                      type: string
                      description: URL de la imagen del logotipo.
                    favicon:
                      type: string
                      description: URL del favicon.
                    ogImage:
                      type: string
                      description: URL de la imagen de Open Graph.
                animations:
                  type: object
                  nullable: true
                  description: Configuración de animaciones y transiciones.
                layout:
                  type: object
                  nullable: true
                  description: >-
                    Configuración de diseño de la página (rejilla, alturas de
                    encabezado y pie de página).
                personality:
                  type: object
                  nullable: true
                  description: >-
                    Atributos de personalidad de la marca (tono, energía,
                    público objetivo).
    ParseFormats:
      type: array
      items:
        oneOf:
          - type: object
            title: Markdown
            properties:
              type:
                type: string
                enum:
                  - markdown
            required:
              - type
          - type: object
            title: Summary
            properties:
              type:
                type: string
                enum:
                  - summary
            required:
              - type
          - type: object
            title: HTML
            properties:
              type:
                type: string
                enum:
                  - html
            required:
              - type
          - type: object
            title: Raw HTML
            properties:
              type:
                type: string
                enum:
                  - rawHtml
            required:
              - type
          - type: object
            title: Links
            properties:
              type:
                type: string
                enum:
                  - links
            required:
              - type
          - type: object
            title: Images
            properties:
              type:
                type: string
                enum:
                  - images
            required:
              - type
          - type: object
            title: JSON
            properties:
              type:
                type: string
                enum:
                  - json
              schema:
                type: object
                description: >-
                  El esquema que se usará para la salida JSON. Debe ajustarse a
                  [JSON Schema](https://json-schema.org/).
              prompt:
                type: string
                description: El prompt que se usará para la salida JSON
            required:
              - type
      description: >-
        Formatos de salida compatibles para cargas en `/parse`. Los formatos con
        renderizado en navegador y el seguimiento de cambios no son compatibles.
      default:
        - markdown
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer

````