Skip to main content
GET
cURL
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.
To check fill rates for a Marketplace dataset before you buy it, see Marketplace fill rates.

Authorizations

Authorization
string
header
required

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:

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

Path Parameters

dataset_id
string
required

Dataset ID of the scraper, for example gd_l7q7dkf244hwjntr0 (Amazon products). Find dataset IDs with Get all scrapers.

Example:

"gd_l7q7dkf244hwjntr0"

Query Parameters

from_date
string<date-time>
required

Start of the time frame, in ISO 8601 format. A date without a time (2026-11-01) is read as midnight UTC.

Example:

"2026-11-01T00:00:00.000Z"

to_date
string<date-time>
required

End of the time frame, in ISO 8601 format. Must be on or after from_date and at most 31 days later.

Example:

"2026-11-16T00:00:00.000Z"

Response

Fill rates for the requested scraper and time frame

dataset_id
string

Dataset ID of the scraper.

from_date
string<date-time>

Start of the requested time frame, normalized to ISO 8601 with milliseconds.

to_date
string<date-time>

End of the requested time frame, normalized to ISO 8601 with milliseconds.

snapshots_count
integer

Number of snapshots the account collected with this scraper in the time frame.

included_snapshots_count
integer

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 returns HTTP 409 for those snapshots.

fields
object[]

One entry per output field. Empty when no snapshots are included.