- Home
- Resources
- Integrations
- BrightData
BrightData n8n integrationAutomate BrightData with n8n.
Need public web data inside a workflow without maintaining your own scraper? The BrightData n8n integration exposes 16 operations across 3 resources: Web Scraper, Marketplace Dataset and Web Unlocker. Nothing listens on its own here, so a Schedule Trigger or a Webhook starts the run.
Community node This node is not shipped with n8n: it is a community package (@brightdata/n8n-nodes-brightdata) you install from Settings › Community nodes on a self-hosted instance. npm
Verified Trustpilot reviews · AI, automation & growth agency
What does the BrightData n8n integration actually give you?
The BrightData n8n integration talks to Bright Data so a workflow can scrape websites, or pull ready-made data out of the marketplace as snapshots. A snapshot is a frozen export of records, produced once and then read, split or shipped elsewhere by its ID.
Three resources cover three different jobs: Web Scraper runs extractions against a dataset, Marketplace Dataset works on catalog data you did not collect yourself, and Web Unlocker reaches a single page or a Google result set.
Scenario one, price watch. A Schedule Trigger fires every morning, webScrapper.triggerCollectionByUrl starts a batch over a list of product pages, and webScrapper.monitorProgressSnapshot checks the status until it turns ready. The rows then land in a sheet through Google Sheets, or in a table through Postgres when you want to keep history.
Scenario two, one page on demand. A form or an internal tool calls an n8n Webhook, and webUnlocker.request fetches that single URL through a zone, with the response returned as Markdown when a language model reads it next. No snapshot, no waiting.
Scenario three, market research on catalog data. marketplaceDataset.listDatasets shows what is available, marketplaceDataset.filterDataset narrows it to the records you care about, and the resulting snapshot goes straight to your own storage. Reshaping the payload before it leaves n8n is a job for the Code node.
When the node stops short, the HTTP Request node calls any other Bright Data API endpoint and reuses the same credential through predefined authentication. That is the escape hatch for anything outside these 16 operations.
Two limits worth knowing before you build. There is no BrightData trigger in n8n, so nothing here reacts to an event on its own. And collection is asynchronous: the batch operations hand you a snapshot ID, not rows, so a workflow that wants the data in the same run has to poll the status or wait for a notification URL. For the wider picture on the platform itself, read the n8n review.
How do you get BrightData running in n8n?
- 01
Install the community package
This node does not ship with n8n. Open Settings, go to Community nodes, and install the npm package
@brightdata/n8n-nodes-brightdata(version1.1.1). That path exists on a self-hosted instance, whether you run n8n through Docker or npm. On n8n Cloud, only verified community nodes can be installed, so check that status before planning around it. - 02
Create the credential once
Open the Credentials menu and create the Bright Data credential there, not inside the workflow. A credential built once is reused by every workflow on the instance, and the node offers it in its own dropdown when you drop it on the canvas. The node itself has no authentication selector, so there is a single credential to pick and nothing else to choose.
- 03
Run one operation to confirm
Pick the Web Unlocker resource and the Send a Request operation, select a Zone and a Country, paste a URL you already know, and set Format to Raw. Execute the node alone. A response coming back means the package, the credential and the zone all line up, and you can move on to the heavier scraping operations.
What can the BrightData node do, operation by operation?
The BrightData node exposes 16 operations across 3 resources. For each one: the node as you configure it in n8n, the required fields, and our field notes.
| Resource | Deliver Snapshot | Download Snapshot | Filter Dataset | Get Dataset Metadata | Get Snapshot Content | Get Snapshot Metadata | Get Snapshot Parts | Get Snapshots | List Datasets | List Snapshots | Monitor Progress Snapshot | Send a Request | Scrape By URL | Trigger Collection By URL | Web Search |
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| Marketplace Dataset | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||||||
| Web Scraper | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | |||||||||
| Web Unlocker | ✓ | ✓ |
Operations index
- Deliver a snapshot to specified storage
- Filter a dataset to create a snapshot
- Retrieve metadata for a specific dataset by dataset id
- Retrieve data by snapshot id
- Get metadata for a selected snapshot by snapshot id
- Split snapshot data to parts by snapshot id
- List available datasets
- List all your snapshot ids
Marketplace Dataset
8 operationsDeliver a snapshot to specified storage
marketplaceDataset.deliverSnapshotWhat you see in n8n
Notes & use cases
Pushes a finished marketplace snapshot into storage you control, instead of leaving it to be downloaded later.
Key parameters
- Snapshot ID: the snapshot to operate on, often
{{ $json.snapshot_id }}carried over from the filter step. - Filename Template: the naming pattern for the delivered file, placeholders included, paired with File Extension set to JSON, JSONL or CSV.
- Deliver Type: picks the destination, from Amazon S3 or Google Cloud Storage to SFTP, Snowflake, Microsoft Azure, Aliyun Object Storage Service, Google Cloud PubSub or a plain Webhook. Each one then asks for its own fields, such as Bucket and AWS Access Key, or Host and Username.
Filter a dataset to create a snapshot
marketplaceDataset.filterDatasetWhat you see in n8n
Notes & use cases
Narrows a marketplace dataset down to the records you want and turns the result into a snapshot you can read afterwards.
Key parameters
- Dataset: the dataset to work on, selected from the list rather than typed.
- Filter Type: Single Filter for one condition, Group Filters when several conditions combine.
- Field Name, Operator and Field Value: the condition itself, with operators covering Equals, Not Equals, Greater Than, Includes, In and their negatives.
- Records Limit: caps how many records end up in the snapshot.
Retrieve metadata for a specific dataset by dataset id
marketplaceDataset.getDatasetMetadataWhat you see in n8n
Notes & use cases
Describes one dataset rather than returning its records: what it holds and how it is shaped, which is what you need before writing a filter against it.
Key parameters
- Dataset: the only field to fill, picked from the list of datasets available on the account.
Retrieve data by snapshot id
marketplaceDataset.getSnapshotContentWhat you see in n8n
Notes & use cases
Returns the actual records held in a marketplace snapshot, in batches when the volume justifies it.
Key parameters
- Snapshot ID: the snapshot to read, typically the one produced by the filter step.
- Batch Size: how many records come back per response, with Part selecting which batch, numbered from 1.
- Format: JSON, JSONL or CSV, and Compress to get the response gzipped.
Get metadata for a selected snapshot by snapshot id
marketplaceDataset.getSnapshotMetadataWhat you see in n8n
Notes & use cases
Gives the description of a marketplace snapshot without pulling any of its records, which keeps the step cheap when all you want is context.
Key parameters
- Snapshot ID: the single required field, the identifier of the snapshot to inspect.
Split snapshot data to parts by snapshot id
marketplaceDataset.getSnapshotPartsWhat you see in n8n
Notes & use cases
Cuts a marketplace snapshot into parts and tells you how it was divided, so the download can be spread over several executions.
Key parameters
- Snapshot ID: the snapshot to split, nothing else to configure.
List available datasets
marketplaceDataset.listDatasetsWhat you see in n8n
Notes & use cases
Returns the marketplace datasets the account can reach, with no parameters at all to fill in.
List all your snapshot ids
marketplaceDataset.listSnapshotsWhat you see in n8n
Notes & use cases
Returns the snapshot identifiers already created on a given marketplace dataset, so a workflow can pick one up instead of generating another.
Key parameters
- Dataset: the dataset whose snapshots you want listed.
- Status: filters on the snapshot state, from Building, Collecting and Digesting through to Ready, Failed or Canceled.
- View: the identifier of a view used to narrow the list further.
Web Scraper
6 operationsDeliver a snapshot to specified storage
webScrapper.deliverSnapshotWhat you see in n8n
Notes & use cases
Same destination options as its marketplace counterpart, applied to a snapshot your own scraping run produced, plus a way to be told when the transfer is done.
Key parameters
- Notify: a URL called once the delivery finishes, which an n8n Webhook can receive to continue the workflow.
- Snapshot ID, Filename Template and File Extension: what to ship, under what name, in JSON, JSONL or CSV.
- Deliver Type: S3, Google Cloud Storage, Azure, SFTP, Snowflake, PubSub, Aliyun or Webhook, each with its own required fields.
Download the snapshot content
webScrapper.downloadSnapshotWhat you see in n8n
Notes & use cases
Brings the scraped records back into the workflow as items, rather than sending them to external storage.
Key parameters
- Snapshot ID: the batch to download, usually the identifier returned when the collection was started.
- Format: JSON or CSV, required either way.
- Split Into Parts: switch it on for large snapshots, then use Batch Size and Part to pull them in chunks.
Get filtered snapshots
webScrapper.getSnapshotsWhat you see in n8n
Notes & use cases
Searches your scraping snapshots over a time window instead of listing everything ever produced.
Key parameters
- Dataset: which dataset the search runs against.
- From Date and To Date: the window, both required, in ISO 8601 format.
- Status: restricts the answer to one state, Ready and Failed being the two that matter most in practice.
- Limit: caps the number of results, with Skip moving past the first ones.
Check the status of a batch extraction
webScrapper.monitorProgressSnapshotWhat you see in n8n
Notes & use cases
Answers a single question about a running scrape: where is it now. Collection is asynchronous, so this is what turns a snapshot ID into a decision.
Key parameters
- Snapshot ID: the extraction being watched, the only field to set.
Extract structured data from a single URL
webScrapper.scrapeByUrlWhat you see in n8n
Notes & use cases
Runs one extraction and gives you the structured result directly, without the snapshot round trip that batch collection requires.
Key parameters
- Dataset: the dataset that defines what gets extracted from the page.
- URLs: the addresses to scrape, passed as JSON, which can come from an earlier node.
- Include Errors: required, and worth leaving on so a failed page is reported rather than silently dropped.
- Format: JSON or CSV.
Initiate batch extraction from URL
webScrapper.triggerCollectionByUrlWhat you see in n8n
Notes & use cases
Starts a scraping job over many addresses at once and returns an identifier, not the data. The rows arrive later.
Key parameters
- Dataset: the extraction template applied to every address in the batch.
- URLs: the list to collect, as JSON.
- Endpoint: where the collected data gets sent once it exists.
- Notify: a URL called when the collection finishes, which removes the need to keep checking.
Web Unlocker
2 operationsSearch the web and get serp results
webUnlocker.WebSearchWhat you see in n8n
Notes & use cases
Sends a query to Google and returns the results page as data, which is the fastest way to get search visibility into a workflow.
Key parameters
- Zone: the Bright Data zone the request goes through.
- Country: where the search is performed from, which changes what Google answers.
- Search Query: the query string itself.
- Page: 1 for the first results page, 2 for the next, and so on.
Access and extract data from a specific URL
webUnlocker.requestWhat you see in n8n
Notes & use cases
Behaves like a request against one page, routed through a zone, and hands back whatever that page returns.
Key parameters
- URL and Method: the target and the verb, GET, POST, PUT, PATCH, DELETE or HEAD.
- Zone and Country: the route the request takes.
- Format: Raw or JSON, and Data Format set to Markdown when the answer feeds a language model, which forces the format back to Raw.
Need help automating BrightData with n8n?
A person reads every message.

