> ## 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.

# Obter status do crawl

> Você é um agente de IA que precisa de uma chave de API do Firecrawl? Veja [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md) para instruções de onboarding automatizado.


## OpenAPI

````yaml pt-BR/api-reference/v2-openapi.json GET /crawl/{id}
openapi: 3.0.0
info:
  contact:
    email: support@firecrawl.dev
    name: Firecrawl Support
    url: https://firecrawl.dev/support
  description: >-
    API para interagir com os serviços do Firecrawl e executar tarefas de web
    scraping e crawling.
  title: Firecrawl API
  version: v2
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /crawl/{id}:
    parameters:
      - description: O ID da tarefa de rastreamento
        in: path
        name: id
        required: true
        schema:
          format: uuid
          type: string
    get:
      tags:
        - Crawling
      summary: Obter o status de uma tarefa de rastreamento
      operationId: getCrawlStatus
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CrawlStatusResponseObj'
          description: Resposta bem-sucedida
        '402':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Payment required to access this resource.
                    type: string
                type: object
          description: Pagamento necessário
        '429':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: >-
                      Request rate limit exceeded. Please wait and try again
                      later.
                    type: string
                type: object
          description: Muitas solicitações
        '500':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: An unexpected error occurred on the server.
                    type: string
                type: object
          description: Erro do servidor
      security:
        - bearerAuth: []
components:
  schemas:
    CrawlStatusResponseObj:
      properties:
        completed:
          description: O número de páginas que foram rastreadas com sucesso.
          type: integer
        completedAt:
          description: >-
            A data e a hora em que o rastreamento foi concluído. Presente apenas
            quando o rastreamento está em um estado final (`completed`, `failed`
            ou `cancelled`).
          format: date-time
          type: string
        createdAt:
          description: A data e a hora em que o rastreamento foi iniciado.
          format: date-time
          type: string
        creditsUsed:
          description: O número de créditos utilizados no rastreamento.
          type: integer
        data:
          description: Os dados do rastreamento.
          items:
            properties:
              blocks:
                description: >-
                  Bloqueios de layout tipados de cada página para PDFs.
                  Presentes somente quando a solicitação tiver definido a opção
                  `blocks` do parser de PDF.
                items:
                  properties:
                    height:
                      description: >-
                        Altura da renderização da página em px. Nulo para
                        páginas que nunca foram renderizadas.
                      nullable: true
                      type: number
                    items:
                      items:
                        properties:
                          bbox:
                            description: >-
                              [x0, y0, x1, y1] normalizado de 0 a 1 em relação à
                              largura/altura da página. Multiplique pela
                              largura/altura da página para obter coordenadas em
                              pixels. Nulo quando a página não tiver dimensões
                              conhecidas.
                            items:
                              type: number
                            maxItems: 4
                            minItems: 4
                            nullable: true
                            type: array
                          confidence:
                            properties:
                              layout:
                                description: >-
                                  Pontuação de detecção do modelo de layout
                                  (0-1). Nulo quando a página não passou pela
                                  análise de layout.
                                nullable: true
                                type: number
                              ocr:
                                description: >-
                                  Nível de confiança do texto quando o caminho
                                  de origem fornece um; nulo caso contrário.
                                nullable: true
                                type: number
                            type: object
                          content:
                            description: >-
                              Fragmento de Markdown com o qual este bloqueio
                              contribuiu para o Markdown do documento.
                            type: string
                          id:
                            description: >-
                              Estável em uma resposta: p<page>.b<index in
                              reading order>.
                            type: string
                          label:
                            description: >-
                              Rótulo bruto do modelo de layout, transmitido sem
                              alteração para compatibilidade futura.
                            nullable: true
                            type: string
                          markdownSpan:
                            description: >-
                              Offsets de caracteres [start, end) no markdown do
                              documento que abrangem o fragmento deste bloqueio.
                              Nulo quando uma transformação de pós-processamento
                              reescreveu o fragmento.
                            items:
                              type: integer
                            maxItems: 2
                            minItems: 2
                            nullable: true
                            type: array
                          readingOrder:
                            type: integer
                          source:
                            description: >-
                              Caminho do pipeline que produziu o bloqueio (por
                              exemplo, native_text, layout_ocr, tsr,
                              formula_model, full_page).
                            nullable: true
                            type: string
                          type:
                            description: >-
                              Tipo de bloqueio: title, section_header, text,
                              table, formula, figure, caption, page_number,
                              page_header, page_footer. Novos tipos podem surgir
                              com o tempo.
                            type: string
                        type: object
                      type: array
                    pageNumber:
                      description: Número físico da página do PDF, começando em 1.
                      type: integer
                    status:
                      description: 'Status consolidado da página: ok | partial | failed.'
                      type: string
                    width:
                      description: >-
                        Largura da renderização da página em px — referência
                        para desnormalizar as coordenadas de bbox. Nulo para
                        páginas que nunca foram renderizadas.
                      nullable: true
                      type: number
                  type: object
                nullable: true
                type: array
              html:
                description: >-
                  Versão em HTML do conteúdo da página, caso `includeHtml` seja
                  true
                nullable: true
                type: string
              links:
                description: Lista de links na página, se `includeLinks` for true
                items:
                  type: string
                type: array
              markdown:
                type: string
              metadata:
                properties:
                  '<any other metadata> ':
                    type: string
                  concurrencyLimited:
                    description: >-
                      Se este scraping foi limitado devido aos limites de
                      concorrência da equipe
                    type: boolean
                  concurrencyQueueDurationMs:
                    description: >-
                      Tempo, em milissegundos, que a solicitação aguardou na
                      fila de concorrência. Presente apenas quando
                      concurrencyLimited é true.
                    type: number
                  description:
                    description: >-
                      Descrição extraída da página; pode ser uma string ou um
                      array de strings
                    oneOf:
                      - type: string
                      - items:
                          type: string
                        type: array
                  error:
                    description: Mensagem de erro da página
                    nullable: true
                    type: string
                  keywords:
                    description: >-
                      Palavras-chave extraídas da página, podem ser uma string
                      ou um array de strings
                    oneOf:
                      - type: string
                      - items:
                          type: string
                        type: array
                  language:
                    description: >-
                      Idioma extraído da página, pode ser uma string ou um array
                      de strings
                    nullable: true
                    oneOf:
                      - type: string
                      - items:
                          type: string
                        type: array
                  numPages:
                    description: >-
                      Para entradas em PDF, o número de páginas processadas
                      (limitado pela opção maxPages do parser).
                    type: integer
                  ogLocaleAlternate:
                    description: Idiomas alternativos para a página
                    items:
                      type: string
                    type: array
                  sourceURL:
                    description: >-
                      A URL original solicitada. Pode ser diferente da URL final
                      da página se tiver ocorrido algum redirecionamento.
                    format: uri
                    type: string
                  statusCode:
                    description: O código de status da página
                    type: integer
                  title:
                    description: >-
                      Título extraído da página; pode ser uma string ou um array
                      de strings
                    oneOf:
                      - type: string
                      - items:
                          type: string
                        type: array
                  totalPages:
                    description: >-
                      Para entradas em PDF, o número real de páginas do
                      documento antes de qualquer limitação por maxPages.
                      Omitido quando não for possível determiná-lo; um
                      totalPages maior que numPages indica que o resultado foi
                      truncado.
                    type: integer
                  url:
                    description: >-
                      A URL final da página após o processamento de todos os
                      redirecionamentos.
                    format: uri
                    type: string
                type: object
              pages:
                description: >-
                  Markdown físico de cada página para PDFs. Presente somente
                  quando a solicitação tiver definido a opção `pages` do parser
                  de PDF.
                items:
                  properties:
                    markdown:
                      type: string
                    pageNumber:
                      description: Número físico da página do PDF, começando em 1.
                      type: integer
                  type: object
                nullable: true
                type: array
              rawHtml:
                description: Conteúdo HTML bruto da página, se `includeRawHtml` for true
                nullable: true
                type: string
              screenshot:
                description: >-
                  Captura de tela da página se `includeScreenshot` estiver
                  definido como true
                nullable: true
                type: string
            type: object
          type: array
        duration:
          description: >-
            Duração do rastreamento em segundos. Para rastreamentos em estado
            final, este é o tempo decorrido de `createdAt` até `completedAt`.
            Para rastreamentos em andamento, é o tempo decorrido de `createdAt`
            até o momento atual.
          type: number
        expiresAt:
          description: Data e hora em que o rastreamento expirará.
          format: date-time
          type: string
        next:
          description: >-
            A URL usada para recuperar os próximos 10 MB de dados. Retornada se
            o processo de crawl não estiver concluído ou se a resposta for maior
            que 10 MB.
          nullable: true
          type: string
        status:
          description: >-
            O status atual do rastreamento. Pode ser `scraping`, `completed` ou
            `failed`.
          type: string
        total:
          description: O número total de páginas cuja varredura foi tentada.
          type: integer
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````