Resources · n8n integration

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

Why automate

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.

Connect

How do you get BrightData running in n8n?

  1. 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 (version 1.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.

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

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

Actions

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.

Resources × operations matrix
ResourceDeliver SnapshotDownload SnapshotFilter DatasetGet Dataset MetadataGet Snapshot ContentGet Snapshot MetadataGet Snapshot PartsGet SnapshotsList DatasetsList SnapshotsMonitor Progress SnapshotSend a RequestScrape By URLTrigger Collection By URLWeb Search
Marketplace Dataset✓✓✓✓✓✓✓✓
Web Scraper✓✓✓✓✓✓
Web Unlocker✓✓

Marketplace Dataset

8 operations
01

Deliver a snapshot to specified storage

marketplaceDataset.deliverSnapshot

What 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.
Use cases
a scheduled copy of catalog data dropped into the bucket your reporting stack already reads.
02

Filter a dataset to create a snapshot

marketplaceDataset.filterDataset

What 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.
Use cases
keeping only the listings above a price threshold before anything gets exported.
03

Retrieve metadata for a specific dataset by dataset id

marketplaceDataset.getDatasetMetadata

What 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.
Use cases
reading the field names of a marketplace dataset once, so the Field Name used later in a filter matches what actually exists instead of what you guessed.
04

Retrieve data by snapshot id

marketplaceDataset.getSnapshotContent

What 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.
Use cases
walking a large snapshot batch by batch in a loop, so the workflow never tries to hold every record in memory at once.
05

Get metadata for a selected snapshot by snapshot id

marketplaceDataset.getSnapshotMetadata

What 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.
Use cases
a branch that reads a snapshot description first and only then decides whether the content is worth downloading, or whether the filter needs to be rerun with different values.
06

Split snapshot data to parts by snapshot id

marketplaceDataset.getSnapshotParts

What 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.
Use cases
preparing a heavy export for retrieval, then feeding each part number into the Part field of the content operation. It is the planning step before the reading step, not a replacement for it.
07

List available datasets

marketplaceDataset.listDatasets

What you see in n8n

Notes & use cases

Returns the marketplace datasets the account can reach, with no parameters at all to fill in.

Use cases
a discovery step at the top of a workflow, run once to see what exists before anything else is built. It also works as a sanity check while setting things up, because a list coming back proves the community package is installed and the credential is valid, well before the first scraping operation is configured.
08

List all your snapshot ids

marketplaceDataset.listSnapshots

What 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.
Use cases
a cleanup routine that lists everything stuck on Failed and reports it.

Web Scraper

6 operations
09

Deliver a snapshot to specified storage

webScrapper.deliverSnapshot

What 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.
Use cases
handing a scraped batch to a data team without n8n holding the file.
10

Download the snapshot content

webScrapper.downloadSnapshot

What 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.
Use cases
pulling the finished batch once a status check reports it ready, then routing the items to a database.
11

Get filtered snapshots

webScrapper.getSnapshots

What 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.
Use cases
a weekly report counting the extractions that completed.
12

Check the status of a batch extraction

webScrapper.monitorProgressSnapshot

What 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.
Use cases
placing this between a Schedule Trigger and the download step, so the workflow only reads the data once the batch has actually finished rather than failing on an empty result.
13

Extract structured data from a single URL

webScrapper.scrapeByUrl

What 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.
Use cases
enriching a single lead record the moment it arrives.
14

Initiate batch extraction from URL

webScrapper.triggerCollectionByUrl

What 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.
Use cases
queueing a few thousand product pages overnight.

Web Unlocker

2 operations
15

Search the web and get serp results

webUnlocker.WebSearch

What 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.
Use cases
tracking how a brand name ranks across several countries.
16

Access and extract data from a specific URL

webUnlocker.request

What 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.
Use cases
reading a competitor page as Markdown before summarizing it.
Need help

Need help automating BrightData with n8n?

A person reads every message.

FAQ

BrightData and n8n, the questions that come up next

01Is the BrightData n8n integration free?
On the n8n side, yes. The node costs nothing, but it is not bundled with n8n either: it is a community node, published as the npm package @brightdata/n8n-nodes-brightdata in version 1.1.1. You install it yourself from Settings, then Community nodes, on a self-hosted instance running through Docker or npm. n8n Cloud only accepts community nodes that have been verified, so the install path is not guaranteed there. Whether the platform is hosted by n8n or by you changes nothing about how the workflow behaves once the node is in place. What Bright Data itself costs is a separate matter and is not covered here.
02What credentials do you need to connect BrightData to n8n?
One Bright Data credential, created once. The order matters: install the community package first, because the credential type only appears once the node exists on the instance. Then open the Credentials menu, create the credential there, and every workflow on that instance can reuse it. The node offers it in a dropdown, so there is nothing to paste twice. This node has no authentication selector, meaning you are not asked to choose between methods the way some other nodes do. The exact fields to fill are documented by Bright Data rather than described here.
03What are the limits of the BrightData node in n8n?
Three things to plan around. First, coverage: 16 operations spread over 3 resources, and anything outside that list needs the HTTP Request node, which can call any Bright Data API endpoint while reusing the same credential through predefined authentication. Second, timing: batch collection is asynchronous, so operations hand back a snapshot ID and the records only exist once the run completes. Third, volume: listing and content operations expose Limit, Skip, Batch Size and Part rather than returning everything blindly, so large exports have to be walked in pieces.
04Does BrightData react in real time in n8n?
No, and not because of a setting you missed. There is no BrightData trigger node in n8n at all, so a workflow involving it always starts somewhere else. Three practical options: a Schedule Trigger running at a fixed interval, which fits price watching and recurring exports; an n8n Webhook called by another service when something happens on your side; or the trigger of another tool already in the workflow. Bright Data can also call back: the delivery and collection operations accept a Notify URL, and an n8n Webhook is a valid destination for it.
05n8n or Make for BrightData?
It depends on three criteria, and neither answer is wrong. Hosting comes first: n8n can run on your own servers through Docker or npm, while Make is hosted only, with no self-hosting option. Data control follows from that, which matters when scraped pages and marketplace records pass through the platform. Cost model is the third: Make bills per operation, which is worth modelling against batches that fan out over thousands of URLs. Both are visual builders. If the community node route is closed on your setup, the HTTP Request node in n8n remains the fallback.