> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brightdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 获取快照填充率

> 获取单个 Bright Data Scraper API 快照的逐字段填充率。GET /datasets/v3/snapshot/{id}/fill_rate 返回每个字段的填充数、评估数和百分比，便于在下载前检查数据覆盖情况。

此端点显示单个 Scraper API 快照中每个输出字段有值的比例，便于在下载或投递结果之前检查数据覆盖情况。


## OpenAPI

````yaml cn-dca-api get /datasets/v3/snapshot/{snapshot_id}/fill_rate
openapi: 3.1.0
info:
  title: Brightdata API
  description: 用于与数据集市场交互的 API
  version: 1.0.0
servers:
  - url: https://api.brightdata.com
security:
  - bearerAuth: []
paths:
  /datasets/v3/snapshot/{snapshot_id}/fill_rate:
    get:
      description: >-
        返回单个快照的字段填充率。对于每个输出字段，响应会给出有填充值的记录数（`filled`）、评估记录总数（`total`）以及百分比（`fill_rate`）。


        如需汇总某个采集器在一段时间内所有快照的填充率，请使用[获取采集器填充率](/cn/api-reference/scrapers/management-apis/get-fill-rates)。
      operationId: getSnapshotFillRate
      parameters:
        - name: snapshot_id
          in: path
          required: true
          description: >-
            快照
            ID，在触发采集时返回。可通过[获取快照](/cn/api-reference/scrapers/management-apis/get-snapshots)列出账户的快照。
          schema:
            type: string
            example: sd_mve1hbze1ctojk1cn9
      responses:
        '200':
          description: 快照的填充率
          content:
            application/json:
              schema:
                type: object
                properties:
                  snapshot_id:
                    type: string
                    description: 快照 ID。
                  dataset_id:
                    type: string
                    description: 采集该快照的采集器的数据集 ID。
                  status:
                    type: string
                    description: 快照状态，例如 `ready`。
                  fields:
                    type: array
                    description: 快照中每个输出字段一项。
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          description: 输出字段的名称。
                        filled:
                          type: integer
                          description: 该字段有填充值的记录数。
                        total:
                          type: integer
                          description: 该字段被评估的记录总数。
                        fill_rate:
                          type: number
                          description: >-
                            有填充值的评估记录所占百分比，范围 `0` 到 `100`：`filled / total *
                            100`。
              examples:
                fill_rates:
                  summary: 包含四条记录的 X 帖子快照（部分字段）
                  value:
                    snapshot_id: sd_mve1hbze1ctojk1cn9
                    dataset_id: gd_lwxkxvnf1cynvib9co
                    status: ready
                    fields:
                      - name: id
                        filled: 4
                        total: 4
                        fill_rate: 100
                      - name: photos
                        filled: 2
                        total: 4
                        fill_rate: 50
                      - name: quoted_post
                        filled: 0
                        total: 4
                        fill_rate: 0
                      - name: tagged_users
                        filled: 1
                        total: 4
                        fill_rate: 25
                      - name: views
                        filled: 3
                        total: 4
                        fill_rate: 75
        '401':
          description: |-
            缺少 API 密钥或 API 密钥无效

            消息（纯文本响应体）：
            - `Credentials are missing`
            - `Invalid credentials`
          content:
            text/plain:
              schema:
                type: string
              examples:
                message:
                  value: Invalid credentials
        '404':
          description: |-
            快照 ID 不存在或属于其他账户

            消息（纯文本响应体）：
            - `Snapshot does not exist`
          content:
            text/plain:
              schema:
                type: string
              examples:
                message:
                  value: Snapshot does not exist
        '409':
          description: >-
            该快照没有可用的填充率


            消息（纯文本响应体）：

            - `Fill rate is not available for this snapshot: no successful
            records were collected (collection errors: N)`

            - `Fill rate is not available for this snapshot: field fill
            statistics were not recorded`
          content:
            text/plain:
              schema:
                type: string
              examples:
                message:
                  value: >-
                    Fill rate is not available for this snapshot: no successful
                    records were collected (collection errors: 1)
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        在 Authorization 头中使用您的 Bright Data API Key 作为 Bearer token。


        **认证方法:**

        1. 从 Bright Data 账户设置获取您的 API Key:
        https://brightdata.com/cp/setting/users

        2. 在请求的 Authorization 头中包含 API Key

        3. 格式: `Authorization: Bearer YOUR_API_KEY`


        **示例:**

        ```

        Authorization: Bearer
        b5648e1096c6442f60a6c4bbbe73f8d2234d3d8324554bd6a7ec8f3f251f07df

        ```


        了解如何获取 Bright Data API Key:
        https://docs.brightdata.com/cn/api-reference/authentication#如何生成新的-api-key？
      bearerFormat: API Key

````