> ## Documentation Index
> Fetch the complete documentation index at: https://firecrawl-claude-eager-dijkstra-fcql78.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Obtener el estado de la captura por lotes

> ¿Eres un agente de IA que necesita una API key de Firecrawl? Consulta [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) para ver las instrucciones de incorporación automatizada.


## OpenAPI

````yaml es/api-reference/v2-openapi.json GET /batch/scrape/{id}
openapi: 3.0.0
info:
  contact:
    email: support@firecrawl.dev
    name: Firecrawl Support
    url: https://firecrawl.dev/support
  description: >-
    API para interactuar con los servicios de Firecrawl y realizar tareas de
    scraping y rastreo web.
  title: Firecrawl API
  version: v2
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /batch/scrape/{id}:
    parameters:
      - description: El identificador del trabajo de scraping por lotes
        in: path
        name: id
        required: true
        schema:
          format: uuid
          type: string
    get:
      tags:
        - Scraping
      summary: Obtener el estado de un trabajo de scraping por lotes
      operationId: getBatchScrapeStatus
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchScrapeStatusResponseObj'
          description: Respuesta satisfactoria
        '402':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Payment required to access this resource.
                    type: string
                type: object
          description: Se requiere pago
        '429':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: >-
                      Request rate limit exceeded. Please wait and try again
                      later.
                    type: string
                type: object
          description: Demasiadas solicitudes
        '500':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: An unexpected error occurred on the server.
                    type: string
                type: object
          description: Error del servidor
      security:
        - bearerAuth: []
components:
  schemas:
    BatchScrapeStatusResponseObj:
      properties:
        completed:
          description: El número de páginas que se han raspado correctamente.
          type: integer
        completedAt:
          description: >-
            La fecha y hora en que finalizó la extracción por lotes. Solo está
            presente cuando la extracción por lotes se encuentra en un estado
            terminal (`completed`, `failed` o `cancelled`).
          format: date-time
          type: string
        createdAt:
          description: La fecha y hora en que se inició la extracción por lotes.
          format: date-time
          type: string
        creditsUsed:
          description: Número de créditos utilizados para el scraping por lotes.
          type: integer
        data:
          description: Los datos de la extracción por lotes.
          items:
            properties:
              blocks:
                description: >-
                  Bloques de maquetación tipados por página para PDF. Solo se
                  incluyen cuando la solicitud establece la opción `blocks` del
                  procesador de PDF.
                items:
                  properties:
                    height:
                      description: >-
                        Alto de renderizado de la página en px. Null para
                        páginas que nunca se renderizaron.
                      nullable: true
                      type: number
                    items:
                      items:
                        properties:
                          bbox:
                            description: >-
                              [x0, y0, x1, y1] normalizadas entre 0 y 1 respecto
                              al ancho y alto de la página. Multiplique por el
                              ancho y alto de la página para obtener las
                              coordenadas en píxeles. Null si la página no tiene
                              dimensiones conocidas.
                            items:
                              type: number
                            maxItems: 4
                            minItems: 4
                            nullable: true
                            type: array
                          confidence:
                            properties:
                              layout:
                                description: >-
                                  Puntuación de detección del modelo de
                                  maquetación (0-1). Null si la página omitió el
                                  análisis de maquetación.
                                nullable: true
                                type: number
                              ocr:
                                description: >-
                                  Confianza del texto cuando la ruta de origen
                                  proporciona una; null en caso contrario.
                                nullable: true
                                type: number
                            type: object
                          content:
                            description: >-
                              Fragmento de markdown que este bloque aportó al
                              markdown del documento.
                            type: string
                          id:
                            description: >-
                              Estable dentro de una misma respuesta:
                              p<page>.b<index in reading order>.
                            type: string
                          label:
                            description: >-
                              Etiqueta sin procesar del modelo de maquetación,
                              transmitida sin modificaciones para garantizar la
                              compatibilidad futura.
                            nullable: true
                            type: string
                          markdownSpan:
                            description: >-
                              Desplazamientos de caracteres [start, end) en el
                              markdown del documento que abarcan el fragmento de
                              este bloque. Null si una transformación de
                              posprocesamiento reescribió el fragmento.
                            items:
                              type: integer
                            maxItems: 2
                            minItems: 2
                            nullable: true
                            type: array
                          readingOrder:
                            type: integer
                          source:
                            description: >-
                              Ruta del pipeline que generó el bloque (por
                              ejemplo, native_text, layout_ocr, tsr,
                              formula_model, full_page).
                            nullable: true
                            type: string
                          type:
                            description: >-
                              Tipo de bloque: title, section_header, text,
                              table, formula, figure, caption, page_number,
                              page_header, page_footer. Pueden aparecer nuevos
                              tipos con el tiempo.
                            type: string
                        type: object
                      type: array
                    pageNumber:
                      description: Número de página física del PDF con índice inicial 1.
                      type: integer
                    status:
                      description: 'Estado consolidado de la página: ok | partial | failed.'
                      type: string
                    width:
                      description: >-
                        Ancho de renderizado de la página en px; sirve de
                        referencia para desnormalizar las coordenadas bbox. Null
                        para páginas que nunca se renderizaron.
                      nullable: true
                      type: number
                  type: object
                nullable: true
                type: array
              html:
                description: >-
                  Versión HTML del contenido de la página si `includeHtml` es
                  true
                nullable: true
                type: string
              links:
                description: Lista de enlaces en la página si `includeLinks` es verdadero
                items:
                  type: string
                type: array
              markdown:
                type: string
              metadata:
                properties:
                  '<any other metadata> ':
                    type: string
                  concurrencyLimited:
                    description: >-
                      Si este scraping se limitó debido a los límites de
                      concurrencia del equipo
                    type: boolean
                  concurrencyQueueDurationMs:
                    description: >-
                      Tiempo, en milisegundos, que la solicitud permaneció en la
                      cola de concurrencia. Solo se incluye cuando
                      concurrencyLimited es true.
                    type: number
                  description:
                    description: >-
                      Descripción extraída de la página; puede ser una cadena o
                      un array de cadenas
                    oneOf:
                      - type: string
                      - items:
                          type: string
                        type: array
                  error:
                    description: El mensaje de error de la página
                    nullable: true
                    type: string
                  keywords:
                    description: >-
                      Palabras clave extraídas de la página; pueden ser una
                      cadena de texto o un array de cadenas de texto
                    oneOf:
                      - type: string
                      - items:
                          type: string
                        type: array
                  language:
                    description: >-
                      Idioma extraído de la página, puede ser una cadena de
                      texto o un array de cadenas
                    nullable: true
                    oneOf:
                      - type: string
                      - items:
                          type: string
                        type: array
                  numPages:
                    description: >-
                      Para entradas PDF, el número de páginas procesadas
                      (limitado por la opción maxPages de los analizadores).
                    type: integer
                  ogLocaleAlternate:
                    description: Configuraciones regionales alternativas para la página
                    items:
                      type: string
                    type: array
                  sourceURL:
                    description: >-
                      La URL original solicitada. Puede diferir de la URL final
                      de la página si hubo redirecciones.
                    format: uri
                    type: string
                  statusCode:
                    description: El código de estado de la página
                    type: integer
                  title:
                    description: >-
                      Título extraído de la página; puede ser una cadena o un
                      array de cadenas
                    oneOf:
                      - type: string
                      - items:
                          type: string
                        type: array
                  totalPages:
                    description: >-
                      Para entradas PDF, el número real de páginas del documento
                      antes de que se aplique cualquier límite de maxPages. Se
                      omite cuando no puede determinarse; un totalPages mayor
                      que numPages indica que el resultado se truncó.
                    type: integer
                  url:
                    description: >-
                      La URL final de la página después de seguir todas las
                      redirecciones.
                    format: uri
                    type: string
                type: object
              pages:
                description: >-
                  Markdown físico por página para PDF. Solo se incluye cuando la
                  solicitud establece la opción `pages` del procesador de PDF.
                items:
                  properties:
                    markdown:
                      type: string
                    pageNumber:
                      description: Número de página física del PDF con índice inicial 1.
                      type: integer
                  type: object
                nullable: true
                type: array
              rawHtml:
                description: Contenido HTML bruto de la página si `includeRawHtml` es true
                nullable: true
                type: string
              screenshot:
                description: >-
                  Captura de pantalla de la página si `includeScreenshot` es
                  verdadero
                nullable: true
                type: string
            type: object
          type: array
        duration:
          description: >-
            Duración de la extracción por lotes en segundos. En las extracciones
            por lotes terminales, es el tiempo transcurrido desde `createdAt`
            hasta `completedAt`. En las extracciones por lotes en curso, es el
            tiempo transcurrido desde `createdAt` hasta el momento actual.
          type: number
        expiresAt:
          description: La fecha y hora en que expirará el proceso de scraping por lotes.
          format: date-time
          type: string
        next:
          description: >-
            La URL para obtener los siguientes 10 MB de datos. Se devuelve si la
            extracción por lotes no ha finalizado o si la respuesta es mayor de
            10 MB.
          nullable: true
          type: string
        status:
          description: >-
            El estado actual del proceso de scraping por lotes. Puede ser
            `scraping`, `completed` o `failed`.
          type: string
        total:
          description: El número total de páginas de las que se intentó hacer scraping.
          type: integer
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````