---
title: "Get the status of a batch scrape job"
method: GET
path: "/batch/scrape/{id}"
tags: ["Scraping"]
---

# Get the status of a batch scrape job

`GET /batch/scrape/{id}`

## Response `200`

Successful response

- BatchScrapeStatusResponseObj
  - `status` string — The current status of the batch scrape. Can be `scraping`, `completed`, or `failed`.
  - `total` integer — The total number of pages that were attempted to be scraped.
  - `completed` integer — The number of pages that have been successfully scraped.
  - `creditsUsed` integer — The number of credits used for the batch scrape.
  - `expiresAt` string, date-time — The date and time when the batch scrape will expire.
  - `createdAt` string, date-time — The date and time when the batch scrape was started.
  - `completedAt` string, date-time — The date and time when the batch scrape finished. Present only when the batch scrape is in a terminal state (`completed`, `failed`, or `cancelled`).
  - `duration` number — Batch scrape duration in seconds. For terminal batch scrapes, this is the elapsed time from `createdAt` to `completedAt`. For in-progress batch scrapes, it is the elapsed time from `createdAt` to now.
  - `next` string, nullable — The URL to retrieve the next 10MB of data. Returned if the batch scrape is not completed or if the response is larger than 10MB.
  - `data` object[] — The data of the batch scrape.
    - `markdown` string
    - `html` string, nullable — HTML version of the content on page if `includeHtml` is true
    - `rawHtml` string, nullable — Raw HTML content of the page if `includeRawHtml` is true
    - `links` string[] — List of links on the page if `includeLinks` is true
    - `screenshot` string, nullable — Screenshot of the page if `includeScreenshot` is true
    - `metadata` object
      - `title` union — Title extracted from the page, can be a string or array of strings
        - string
        - string[]
      - `description` union — Description extracted from the page, can be a string or array of strings
        - string
        - string[]
      - `language` union — Language extracted from the page, can be a string or array of strings
        - string
        - string[]
      - `sourceURL` string, uri — The original URL that was requested. May differ from the page's final URL if redirects occurred.
      - `url` string, uri — The final URL of the page after all redirects have been followed.
      - `keywords` union — Keywords extracted from the page, can be a string or array of strings
        - string
        - string[]
      - `ogLocaleAlternate` string[] — Alternative locales for the page
      - `<any other metadata> ` string
      - `statusCode` integer — The status code of the page
      - `numPages` integer — For PDF inputs, the number of pages parsed (capped by the parsers maxPages option).
      - `totalPages` integer — For PDF inputs, the document's true page count before any maxPages capping. Omitted when it cannot be determined; a totalPages greater than numPages indicates the result was truncated.
      - `error` string, nullable — The error message of the page
      - `concurrencyLimited` boolean — Whether this scrape was throttled due to team concurrency limits
      - `concurrencyQueueDurationMs` number — Time in milliseconds the request waited in the concurrency queue. Only present when concurrencyLimited is true.

## Other responses

- `402` — Payment required
- `429` — Too many requests
- `500` — Server error

---

[API](https://skmtc.net/firecrawl/apis/firecrawl-api.md) · [All operations](https://skmtc.net/firecrawl/apis/firecrawl-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/firecrawl/firecrawl-api/versions/e350fafb5a2a/schema)