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

# Get scraper fill rates

> Get per-field fill rates for a Bright Data Scraper API scraper. GET /datasets/v3/scraper/{id}/fill_rate covers your snapshots over up to 31 days.

This endpoint shows how often each output field of a Scraper API scraper was populated across the snapshots your account collected in a time frame of up to 31 days.

> [!TIP]
>
> To check fill rates for a Marketplace dataset before you buy it, see [Marketplace fill rates](https://docs.brightdata.com/products/marketplace/fill-rates-and-statistics.md).


## OpenAPI

````yaml api-reference/dca-api get /datasets/v3/scraper/{dataset_id}/fill_rate
openapi: 3.1.0
info:
  title: Brightdata API
  description: API for interaction with datasets marketplace
  version: 1.0.0
servers:
  - url: https://api.brightdata.com
security:
  - bearerAuth: []
paths:
  /datasets/v3/scraper/{dataset_id}/fill_rate:
    get:
      description: >-
        Returns field-level fill rates for a scraper, aggregated across the
        snapshots the account collected with that scraper between `from_date`
        and `to_date`. For each output field, the response gives the number of
        evaluated records with a populated value (`filled`), the number of
        records evaluated (`total`) and the percentage (`fill_rate`).


        - The time frame can span at most 31 days. A longer range returns HTTP
        400 `Max date range is 31 days`.

        - When no snapshots match, the request still returns HTTP 200 with
        `snapshots_count` `0` and an empty `fields` array. This includes a
        `dataset_id` the account has never collected with.
      operationId: getScraperFillRate
      parameters:
        - name: dataset_id
          in: path
          required: true
          description: >-
            Dataset ID of the scraper, for example `gd_l7q7dkf244hwjntr0`
            (Amazon products). Find dataset IDs with [Get all
            scrapers](/api-reference/scrapers/management-apis/get-scrapers).
          schema:
            type: string
            example: gd_l7q7dkf244hwjntr0
        - name: from_date
          in: query
          required: true
          description: >-
            Start of the time frame, in ISO 8601 format. A date without a time
            (`2026-11-01`) is read as midnight UTC.
          schema:
            type: string
            format: date-time
            example: '2026-11-01T00:00:00.000Z'
        - name: to_date
          in: query
          required: true
          description: >-
            End of the time frame, in ISO 8601 format. Must be on or after
            `from_date` and at most 31 days later.
          schema:
            type: string
            format: date-time
            example: '2026-11-16T00:00:00.000Z'
      responses:
        '200':
          description: Fill rates for the requested scraper and time frame
          content:
            application/json:
              schema:
                type: object
                properties:
                  dataset_id:
                    type: string
                    description: Dataset ID of the scraper.
                  from_date:
                    type: string
                    description: >-
                      Start of the requested time frame, normalized to ISO 8601
                      with milliseconds.
                    format: date-time
                  to_date:
                    type: string
                    description: >-
                      End of the requested time frame, normalized to ISO 8601
                      with milliseconds.
                    format: date-time
                  snapshots_count:
                    type: integer
                    description: >-
                      Number of snapshots the account collected with this
                      scraper in the time frame.
                  included_snapshots_count:
                    type: integer
                    description: >-
                      Number of snapshots used in the fill-rate calculation.
                      Lower than `snapshots_count` when some snapshots have no
                      fill-rate statistics: snapshots that collected no
                      successful records, and older snapshots whose field
                      statistics were not recorded. [Get snapshot fill
                      rates](/api-reference/scrapers/management-apis/get-snapshot-fill-rates)
                      returns HTTP 409 for those snapshots.
                  fields:
                    type: array
                    description: >-
                      One entry per output field. Empty when no snapshots are
                      included.
                    items:
                      type: object
                      properties:
                        name:
                          type: string
                          description: Name of the output field.
                        filled:
                          type: integer
                          description: >-
                            Number of evaluated records with a populated value
                            for the field.
                        total:
                          type: integer
                          description: >-
                            Number of records evaluated for the field across the
                            included snapshots. Can differ from field to field.
                        fill_rate:
                          type: number
                          description: >-
                            Percentage of evaluated records with a populated
                            value, from `0` to `100`, rounded to two decimals:
                            `filled / total * 100`.
              examples:
                fill_rates:
                  summary: Amazon products, 15 days (subset of fields)
                  value:
                    dataset_id: gd_l7q7dkf244hwjntr0
                    from_date: '2026-11-01T00:00:00.000Z'
                    to_date: '2026-11-16T00:00:00.000Z'
                    snapshots_count: 207
                    included_snapshots_count: 207
                    fields:
                      - name: title
                        filled: 299
                        total: 299
                        fill_rate: 100
                      - name: final_price
                        filled: 253
                        total: 299
                        fill_rate: 84.62
                      - name: seller_name
                        filled: 240
                        total: 285
                        fill_rate: 84.21
                      - name: categories
                        filled: 92
                        total: 285
                        fill_rate: 32.28
                no_snapshots:
                  summary: No snapshots in the time frame
                  value:
                    dataset_id: gd_l7q7dkf244hwjntr0
                    from_date: '2026-12-01T00:00:00.000Z'
                    to_date: '2026-12-05T00:00:00.000Z'
                    snapshots_count: 0
                    included_snapshots_count: 0
                    fields: []
        '400':
          description: |-
            Invalid query parameters

            Messages:
            - `"from_date" is required` / `"to_date" is required`
            - `"from_date" must be in ISO 8601 date format`
            - `"to_date" must be greater than or equal to "ref:from_date"`
            - `Max date range is 31 days` (plain text body)
          content:
            application/json:
              schema:
                type: object
                properties:
                  validation_errors:
                    type: array
                    items:
                      type: string
              examples:
                missing_dates:
                  value:
                    validation_errors:
                      - '"from_date" is required'
                      - '"to_date" is required'
            text/plain:
              schema:
                type: string
              examples:
                range_too_long:
                  value: Max date range is 31 days
        '401':
          description: |-
            Missing or invalid API key

            Messages (plain text body):
            - `Credentials are missing`
            - `Invalid credentials`
          content:
            text/plain:
              schema:
                type: string
              examples:
                invalid_key:
                  value: Invalid credentials
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Use your Bright Data API Key as a Bearer token in the Authorization
        header.


        **How to authenticate:**

        1. Obtain your API Key from the Bright Data account settings at
        https://brightdata.com/cp/setting/users

        2. Include the API Key in the Authorization header of your requests

        3. Format: `Authorization: Bearer YOUR_API_KEY`


        **Example:**

        ```

        Authorization: Bearer YOUR_API_KEY

        ```


        Learn how to get your Bright Data API key:
        https://docs.brightdata.com/api-reference/authentication
      bearerFormat: API Key

````