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

# 获取批量抓取状态

> 你是需要 Firecrawl API 密钥的 AI 代理吗？有关自动化接入说明，请参阅 [firecrawl.dev/agent-onboarding/SKILL.md](https://www.firecrawl.dev/agent-onboarding/SKILL.md)。


## OpenAPI

````yaml zh/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: 用于与 Firecrawl 服务交互，执行网页抓取和爬取任务的 API。
  title: Firecrawl API
  version: v2
servers:
  - url: https://api.firecrawl.dev/v2
security:
  - bearerAuth: []
paths:
  /batch/scrape/{id}:
    parameters:
      - description: 批量抓取作业的 ID
        in: path
        name: id
        required: true
        schema:
          format: uuid
          type: string
    get:
      tags:
        - Scraping
      summary: 获取批量抓取作业状态
      operationId: getBatchScrapeStatus
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BatchScrapeStatusResponseObj'
          description: 成功的响应
        '402':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: Payment required to access this resource.
                    type: string
                type: object
          description: 需要付费
        '429':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: >-
                      Request rate limit exceeded. Please wait and try again
                      later.
                    type: string
                type: object
          description: 请求次数过多
        '500':
          content:
            application/json:
              schema:
                properties:
                  error:
                    example: An unexpected error occurred on the server.
                    type: string
                type: object
          description: 服务器错误
      security:
        - bearerAuth: []
components:
  schemas:
    BatchScrapeStatusResponseObj:
      properties:
        completed:
          description: 成功抓取的页面数。
          type: integer
        completedAt:
          description: 批量抓取完成的日期和时间。仅当批量抓取处于终态（`completed`、`failed` 或 `cancelled`）时才会显示。
          format: date-time
          type: string
        createdAt:
          description: 批量抓取开始的日期和时间。
          format: date-time
          type: string
        creditsUsed:
          description: 本次批量抓取消耗的额度数量。
          type: integer
        data:
          description: 批量爬取的数据。
          items:
            properties:
              blocks:
                description: PDF 的逐页类型化布局块。仅当请求设置了 PDF 解析器的 `blocks` 选项时存在。
                items:
                  properties:
                    height:
                      description: 页面渲染高度（px）。未渲染的页面为 Null。
                      nullable: true
                      type: number
                    items:
                      items:
                        properties:
                          bbox:
                            description: >-
                              [x0, y0, x1, y1]，相对于页面宽度和高度归一化到
                              0-1。乘以页面宽度和高度即可得到像素坐标。页面尺寸未知时为 Null。
                            items:
                              type: number
                            maxItems: 4
                            minItems: 4
                            nullable: true
                            type: array
                          confidence:
                            properties:
                              layout:
                                description: 布局模型检测得分（0-1）。页面跳过布局分析时为 Null。
                                nullable: true
                                type: number
                              ocr:
                                description: 源路径提供文本置信度时的置信度；否则为 null。
                                nullable: true
                                type: number
                            type: object
                          content:
                            description: 此块贡献给文档 Markdown 的 Markdown 片段。
                            type: string
                          id:
                            description: 在同一响应内保持稳定：p<page>.b<index in reading order>。
                            type: string
                          label:
                            description: 原始布局模型标签，直接透传以实现前向兼容。
                            nullable: true
                            type: string
                          markdownSpan:
                            description: >-
                              文档 Markdown 中此块片段的字符偏移量 [start, end)。后处理转换重写该片段时为
                              Null。
                            items:
                              type: integer
                            maxItems: 2
                            minItems: 2
                            nullable: true
                            type: array
                          readingOrder:
                            type: integer
                          source:
                            description: >-
                              生成该块的流水线路径（例如
                              native_text、layout_ocr、tsr、formula_model、full_page）。
                            nullable: true
                            type: string
                          type:
                            description: >-
                              块类型：title、section_header、text、table、formula、figure、caption、page_number、page_header、page_footer。后续可能会新增类型。
                            type: string
                        type: object
                      type: array
                    pageNumber:
                      description: 从 1 开始的物理 PDF 页码。
                      type: integer
                    status:
                      description: 页面级汇总：ok | partial | failed。
                      type: string
                    width:
                      description: 页面渲染宽度（px）— 用于反归一化 bbox 坐标的基准。未渲染的页面为 Null。
                      nullable: true
                      type: number
                  type: object
                nullable: true
                type: array
              html:
                description: 当 `includeHtml` 为 true 时，页面内容的 HTML 版本
                nullable: true
                type: string
              links:
                description: 若 `includeLinks` 为 true，则为页面上的链接列表
                items:
                  type: string
                type: array
              markdown:
                type: string
              metadata:
                properties:
                  '<any other metadata> ':
                    type: string
                  concurrencyLimited:
                    description: 此次抓取是否因团队并发限制而被限流
                    type: boolean
                  concurrencyQueueDurationMs:
                    description: 该请求在并发队列中的等待时间（毫秒）。仅当 concurrencyLimited 为 true 时返回。
                    type: number
                  description:
                    description: 从页面提取的描述，可以是字符串或字符串数组
                    oneOf:
                      - type: string
                      - items:
                          type: string
                        type: array
                  error:
                    description: 页面错误信息
                    nullable: true
                    type: string
                  keywords:
                    description: 从页面中提取的关键词，可以是一个字符串或字符串数组
                    oneOf:
                      - type: string
                      - items:
                          type: string
                        type: array
                  language:
                    description: 从页面提取的语言，可以是字符串或字符串数组
                    nullable: true
                    oneOf:
                      - type: string
                      - items:
                          type: string
                        type: array
                  numPages:
                    description: 对于 PDF 输入，表示已解析的页数（上限由解析器的 maxPages 选项决定）。
                    type: integer
                  ogLocaleAlternate:
                    description: 此页面的其他语言版本
                    items:
                      type: string
                    type: array
                  sourceURL:
                    description: 初始请求的 URL。如果发生重定向，可能与页面的最终 URL 不同。
                    format: uri
                    type: string
                  statusCode:
                    description: 页面状态码
                    type: integer
                  title:
                    description: 从页面中提取的标题，可以是字符串或字符串数组
                    oneOf:
                      - type: string
                      - items:
                          type: string
                        type: array
                  totalPages:
                    description: >-
                      对于 PDF 输入，表示文档在应用任何 maxPages 限制前的实际总页数。无法确定时将省略；如果
                      totalPages 大于 numPages，则表示结果已被截断。
                    type: integer
                  url:
                    description: 跟随所有重定向后得到的页面最终 URL。
                    format: uri
                    type: string
                type: object
              pages:
                description: PDF 按物理页划分的 Markdown。仅当请求设置了 PDF 解析器的 `pages` 选项时存在。
                items:
                  properties:
                    markdown:
                      type: string
                    pageNumber:
                      description: 从 1 开始的物理 PDF 页码。
                      type: integer
                  type: object
                nullable: true
                type: array
              rawHtml:
                description: 当 `includeRawHtml` 为 true 时，页面的原始 HTML 内容
                nullable: true
                type: string
              screenshot:
                description: 当 `includeScreenshot` 为 true 时的页面截图
                nullable: true
                type: string
            type: object
          type: array
        duration:
          description: >-
            批量抓取持续时间，单位为秒。对于已结束的批量抓取，这是从 `createdAt` 到 `completedAt`
            的耗时。对于进行中的批量抓取，这是从 `createdAt` 到当前的耗时。
          type: number
        expiresAt:
          description: 批量抓取过期的日期和时间。
          format: date-time
          type: string
        next:
          description: 用于获取下一个 10 MB 数据的 URL。如果批量抓取未完成，或响应内容超过 10 MB，则会返回该字段。
          nullable: true
          type: string
        status:
          description: 批量抓取任务的当前状态。可能为 `scraping`、`completed` 或 `failed`。
          type: string
        total:
          description: 尝试爬取的页面总数。
          type: integer
      type: object
  securitySchemes:
    bearerAuth:
      scheme: bearer
      type: http

````