Bright Data for AI agents
Agents read Bright Data at once. Changes and sends are held for a person's approval by default.
About Bright Data
Bright Data provides the world's #1 web data platform with Web Unlocker for bypassing anti-bot systems, SERP API for search engine data, and pre-made scrapers for popular websites. Collect any web data at scale.
What an agent can do in Bright Data
Every Bright Data action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in Bright Data without asking first. 22 actions.
- List Marketplace DatasetsList pre-built datasets in Bright Data's marketplace for structured scraping.
- Download Snapshot ResultsDownload a completed dataset snapshot. A pending response contains no result data; poll BRIGHTDATA_GET_SNAPSHOT_STATUS before retrying.
- Scrape Protected URLScrape a public URL through Web Unlocker when ordinary requests are blocked or require JavaScript rendering. Inspect returned content before retrying CAPTCHA pages.
- Get Customer BalanceGet current and pending Bright Data account balances. This endpoint requires an API key with Admin permission. If HTTP 429 is returned, retry after the Retry-After delay when present.
- Get Dataset MetadataRetrieve field definitions for a Bright Data marketplace dataset.
- Get Deep Lookup ResultsRetrieve enriched records plus available progress, cost, and provider metadata for a completed Deep Lookup request. Each record preserves the lookup's dynamic columns. If the API returns HTTP 429, ret
- Get Deep Lookup StatusCheck a Deep Lookup request's status, progress, cost, and provider metadata. Poll until completion before retrieving results. If the API returns HTTP 429, retry according to Retry-After when present r
- Get Destination Type SchemaRetrieve the fields required to configure a Bright Data delivery destination.
- List Available CitiesList static-network cities available for a country and proxy pool type.
- List Available CountriesList country codes available for each static proxy zone type.
- Get SERP ResultsRetrieve JSON or raw results for an asynchronous BRIGHTDATA_SERP_SEARCH request. A 202 response means the job is still pending and should be retried later.
- Check Snapshot StatusCheck whether a dataset snapshot is running, ready, or failed before downloading it.
Show all 22
- Get Web Archive SearchGet a Web Archive search's status and its matching-file, dump-size-in-bytes, and dump-cost-in-USD estimates. The search only estimates a dump and does not create a billable dump. Up to 100 searches th
- Get Zone BandwidthGet uploaded, downloaded, and total byte usage for one zone and date range. If HTTP 429 is returned, retry after the Retry-After delay when present.
- Get Zone CostGet invoice-aligned billed cost and bandwidth for one zone and date range. The `to_date` boundary is exclusive. If HTTP 429 is returned, retry after the Retry-After delay when present.
- Get Country CitiesList cities in a country for account-level geographic selection. For static datacenter or residential proxy-pool inventory, use BRIGHTDATA_GET_LIST_OF_AVAILABLE_CITIES instead.
- Get Dataset Delivery OptionsList settings supported when configuring Bright Data dataset delivery.
- List Scraper Studio ScrapersList account-owned Scraper Studio scrapers and discover collector IDs.
- List Unlocker ZonesList configured Web Unlocker zones and their types for protected-URL scraping.
- Search Business RecordsSearch public company or professional-profile records synchronously using your Bright Data account. Choose an entity type and use a structured query in Ludicrous mode or natural language in Instant/Sm
- Search Dataset SynchronouslySearch a supported Bright Data Marketplace dataset through your Bright Data account and return matching records synchronously. Use Filter Dataset for bulk asynchronous exports.
- Search SERP SynchronouslySearch Google, Bing, DuckDuckGo or Yandex and return results synchronously. Use for standard text searches; JSON preserves engine-specific organic results and metadata. This action does not submit an
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 7 actions.
- Search SERPSubmit an asynchronous SERP search and return its response_id. Retrieve it with BRIGHTDATA_GET_SERP_RESULTS, selecting the same JSON or raw result format used here.
- Start Deep LookupStart an asynchronous Deep Lookup research request and return its request_id. Billing is $1 per matched record; the first 10 enrichment columns are included, each additional enrichment column costs $0
- Start Site CrawlStart an asynchronous dataset or site crawl. Poll the returned snapshot_id with BRIGHTDATA_GET_SNAPSHOT_STATUS, then download it with BRIGHTDATA_GET_SNAPSHOT_RESULTS.
- Create Safe ZoneCreate a durable SERP API or Scraping Browser zone using a fixed safe plan. This Admin/Ops operation changes account infrastructure and may incur charges. If Bright Data returns HTTP 429, retry after
- Filter DatasetCreate a billable filtered marketplace-dataset snapshot. Use records_limit to cap the number of included records.
- Scrape Data SynchronouslyScrape up to 20 input objects synchronously. Bright Data bills per returned record. Requests exceeding the one-minute synchronous limit fall back to an asynchronous snapshot; use the returned snapshot
- Search Web ArchiveSearch Bright Data's Web Archive and estimate matching files, dump size in bytes, and dump cost in USD. A search that exceeds 30 seconds returns only a search_id; pass it to BRIGHTDATA_GET_WEB_ARCHIVE
Changes wait in Needs you
Changes and sends in Bright Data are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
Related connectors
Bright Data questions
Can an agent change data in Bright Data on its own?
Not by default. Changes and sends in Bright Data are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in Bright Data?
This connector lists 22 read actions. Reads run at once, without waiting for approval.
How does Bright Data connect?
It connects with API key. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.