curl "https://api.brightdata.com/shield/samples?category=Ads" -H "Authorization: <Bearer Token>" 
[
    {
        "timestamp":"2024-02-07T11:35:45.197Z",
        "ip":"13.229.30.41",
        "zone":"zone_name",
        "bw":82345,
        "time":62594
    }, ... 
]

Query parameters

from
string

start time frame of requested data

Example: from=2018-07-01T00:00:00

to
string

end time frame of requested data

Example: to=2018-07-02T00:00:00

cn
string

country of the request origin

Example: cn=uk

peer_cn
string

country of the peer IP

Example: peer_cn=us

categories
string

returns only specific classifications

Example: categories=ads

host
string

returns only specific domains

Example: host=example.com

curl "https://api.brightdata.com/shield/samples?category=Ads" -H "Authorization: <Bearer Token>" 
[
    {
        "timestamp":"2024-02-07T11:35:45.197Z",
        "ip":"13.229.30.41",
        "zone":"zone_name",
        "bw":82345,
        "time":62594
    }, ... 
]