> Markdown versions of all pages of this connector library are available by appending `.md` to the page URL. For the full index of connectors, see [llms.txt](https://connectors.appmixer.com/llms.txt).

# Bright Data connector

- Connector: `appmixer.brightdata`
- Version: 1.0.2
- Components: 7 (0 triggers, 7 actions)

Bright Data is a web data platform: unblock and scrape any public web page through the Web Unlocker, pull structured search-engine results with the SERP API, and run the Web Scraper API to trigger dataset collections, monitor snapshots and download the collected records.

- Connector page: <https://connectors.appmixer.com/connector/appmixer.brightdata/1.0.2>
- Source code: <https://github.com/clientIO/appmixer-connectors/tree/dev/src/appmixer/brightdata>
- Download package: <https://connectors.appmixer.com/connector/appmixer.brightdata/1.0.2/download>

## Authentication

**Type:** API Key

**Fields:**

- `API Token` (text): Create an API token in the Bright Data control panel under [Account settings &rarr; API tokens](https://brightdata.com/cp/setting/users) and paste it here.

## Actions (7)

- [Find Snapshot Records](https://connectors.appmixer.com/connector/appmixer.brightdata/1.0.2/component/appmixer.brightdata.core.FindSnapshotRecords.md) (`appmixer.brightdata.core.FindSnapshotRecords`): Download the records collected in a ready Bright Data Web Scraper API snapshot.
- [Find Search Results](https://connectors.appmixer.com/connector/appmixer.brightdata/1.0.2/component/appmixer.brightdata.core.FindSearchResults.md) (`appmixer.brightdata.core.FindSearchResults`): Run a search-engine query through the Bright Data SERP API and return the parsed organic results.
- [Get Snapshot Status](https://connectors.appmixer.com/connector/appmixer.brightdata/1.0.2/component/appmixer.brightdata.core.GetSnapshotStatus.md) (`appmixer.brightdata.core.GetSnapshotStatus`): Check whether a Bright Data Web Scraper API snapshot is still collecting, ready to download or failed.
- [List Zones](https://connectors.appmixer.com/connector/appmixer.brightdata/1.0.2/component/appmixer.brightdata.core.ListZones.md) (`appmixer.brightdata.core.ListZones`): List all active zones on your Bright Data account, so you know which zone name to pass to the scraping components.
- [Make API Call](https://connectors.appmixer.com/connector/appmixer.brightdata/1.0.2/component/appmixer.brightdata.core.MakeApiCall.md) (`appmixer.brightdata.core.MakeApiCall`): Perform an arbitrary authorized API call to Bright Data. Provide a path (or full URL), method, headers, query parameters and body. The API token header is added automatically.
- [Scrape URL](https://connectors.appmixer.com/connector/appmixer.brightdata/1.0.2/component/appmixer.brightdata.core.ScrapeUrl.md) (`appmixer.brightdata.core.ScrapeUrl`): Fetch any public web page through the Bright Data Web Unlocker, bypassing bot protection, and return the page as HTML or Markdown.
- [Trigger Dataset Collection](https://connectors.appmixer.com/connector/appmixer.brightdata/1.0.2/component/appmixer.brightdata.core.TriggerDatasetCollection.md) (`appmixer.brightdata.core.TriggerDatasetCollection`): Start an asynchronous Web Scraper API collection for a Bright Data dataset and return the snapshot ID used to monitor and download the results.

## Changelog

### 1.0.2

- Quote CSV cells that hold a comma, a double quote or a line break and map cells by header column when exporting results to a file.

### 1.0.1

- MakeApiCall: Request Headers and Query Parameters set in the Designer are now sent. They were silently dropped: the key-value field stores its rows as a JSON object string, which the component did not parse.

### 1.0.0

- Initial release.
