# Obter status do scrape em lote (/pt-BR/api-reference/endpoint/batch-scrape-get)

<!-- agent-signals: reading_time_min: 4 · est_tokens: 2647 · updated: 2026-07-30 -->
Related: [Pesquisa](/pt-BR/api-reference/endpoint/search.md), [Feedback de busca](/pt-BR/api-reference/endpoint/search-feedback.md), [Raspar](/pt-BR/api-reference/endpoint/scrape.md), [Raspar em lote](/pt-BR/api-reference/endpoint/batch-scrape.md), [Cancelar raspagem em lote](/pt-BR/api-reference/endpoint/batch-scrape-delete.md), [Obter erros de scraping em lote](/pt-BR/api-reference/endpoint/batch-scrape-get-errors.md)

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

`GET /batch/scrape/{id}`

Obtenha o status de uma tarefa de raspagem em lote

## OpenAPI

```json
{
  "security": [
    {
      "bearerAuth": []
    }
  ],
  "parameters": [
    {
      "description": "ID do job de raspagem em lote",
      "in": "path",
      "name": "id",
      "required": true,
      "schema": {
        "format": "uuid",
        "type": "string"
      }
    }
  ],
  "responses": {
    "200": {
      "content": {
        "application/json": {
          "schema": {
            "properties": {
              "completed": {
                "description": "O número de páginas extraídas com sucesso.",
                "type": "integer"
              },
              "completedAt": {
                "description": "A data e a hora em que a extração em lote foi concluída. Presente apenas quando a extração em lote está em um estado final (`completed`, `failed` ou `cancelled`).",
                "format": "date-time",
                "type": "string"
              },
              "createdAt": {
                "description": "A data e a hora em que a extração em lote foi iniciada.",
                "format": "date-time",
                "type": "string"
              },
              "creditsUsed": {
                "description": "O número de créditos utilizados para a raspagem em lote.",
                "type": "integer"
              },
              "data": {
                "description": "Os dados da coleta em lote.",
                "items": {
                  "properties": {
                    "html": {
                      "description": "Versão em HTML do conteúdo da página, caso `includeHtml` seja verdadeiro",
                      "nullable": true,
                      "type": "string"
                    },
                    "links": {
                      "description": "Lista de links na página se `includeLinks` for verdadeiro",
                      "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": "A mensagem de erro da página",
                          "nullable": true,
                          "type": "string"
                        },
                        "keywords": {
                          "description": "Palavras-chave extraídas da página; pode 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 da 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, que 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"
                    },
                    "rawHtml": {
                      "description": "Conteúdo HTML bruto da página, caso `includeRawHtml` seja 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 da extração em lote em segundos. Para extrações em lote em estado final, este é o tempo decorrido de `createdAt` até `completedAt`. Para extrações em lote em andamento, é o tempo decorrido de `createdAt` até o momento atual.",
                "type": "number"
              },
              "expiresAt": {
                "description": "A data e a hora em que a raspagem em lote expira.",
                "format": "date-time",
                "type": "string"
              },
              "next": {
                "description": "A URL para recuperar os próximos 10 MB de dados. Retornada se a raspagem em lote não estiver concluída ou se a resposta for maior que 10 MB.",
                "nullable": true,
                "type": "string"
              },
              "status": {
                "description": "O status atual da raspagem em lote. Pode ser `scraping`, `completed` ou `failed`.",
                "type": "string"
              },
              "total": {
                "description": "O número total de páginas em que se tentou realizar o scraping.",
                "type": "integer"
              }
            },
            "type": "object"
          }
        }
      },
      "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 no servidor"
    }
  }
}
```
