bright-data

name

bright-data

description

Bright Data (formerly Luminati) is a comprehensive web data platform offering a global proxy network (residential, mobile, ISP, data center), browser-based scraping, SERP APIs, and managed data pipelines—empowering developers and businesses to collect structured and unblocked web data at scale for AI, BI, and insights. Read and write BrightData data through One: datasets, zones, datasetsnapshots, zoneips, deeplookuprequests, zoneblacklist and more, 103 actions with real parameter documentation. Use whenever the user asks to look something up in BrightData, create or update a record there, or build code against the BrightData API.

BrightData through One

Bright Data (formerly Luminati) is a comprehensive web data platform offering a global proxy network (residential, mobile, ISP, data center), browser-based scraping, SERP APIs, and managed data pipelines—empowering developers and businesses to collect structured and unblocked web data at scale for AI, BI, and insights.

One exposes BrightData through four MCP tools. The table below carries real action ids from One's knowledge base, so for a common operation you can skip search and go straight to reading the action's parameters.

How to run an action

1. Find the action in the table below, or call search_one_platform_actions with platform bright-data if it is not listed.
2. Call get_one_action_knowledge with the action id. Do this every time, including for actions in this table. The table gives you the id, not the parameters.
3. Call execute_one_action with parameters copied from that knowledge.

Never guess a parameter name, a body field, or an enum value. The knowledge has the real schema, and a guessed field is either a 400 or a silent write of the wrong thing.

Before you start

Call list_one_integrations once and confirm BrightData is connected. If it is missing, the user has not connected it: say so and point them at https://app.withone.ai rather than reaching for raw HTTP.

Each connection carries an access field. If it reports {"policy": "methods", "methods": ["GET"]} the agent is read-only here, so plan a read-only answer instead of attempting a write that will be refused.

Before a write

Creates, updates, deletes and sends land on a real BrightData account and cannot be recalled. State the action and the specific target in one line before the first write in a task, and let the user stop you. Reads need no confirmation.

Actions

Datasets

Action	Method	Path	Action id
Get a Dataset’s Metadata	GET	/datasets/{{datasetId}}/metadata	conn_mod_def::GJ0-sdifsI0::TOiyubNnR7yX07r82l6aLA
List Available Datasets	GET	/datasets/list	conn_mod_def::GJ0-r52Lq6A::i-78lxSZQl-VOCwwanU00g
Receive Batch Data (Get a Dataset by ID)	GET	/dca/dataset	conn_mod_def::GJ0-tKd3D-4::V5QEEYT8SG6X6InsVMdjiA
Deliver a Dataset Snapshot to Storage	POST	/datasets/v3/deliver/{{snapshotId}}	conn_mod_def::GJ0-wDVuz4g::mM93upuARqKa5_RpzyoY7g
Filter a Dataset (BETA) (Create Snapshot by Filter)	POST	/datasets/filter	conn_mod_def::GJ0-sXOsOgM::il38dZAnSrq5ss_VxYOOOg
Filter a Dataset (Create Snapshot from Filter; JSON or File Uploads)	POST	/datasets/filter	conn_mod_def::GJ0-sQJ2sBA::PGK8IwONRiyUgWMOgjMXNA
Synchronous Dataset Scrape (Return Results in Response)	POST	/datasets/v3/scrape	conn_mod_def::GJ0-yGobWYk::knz8Z-uDR7ufAOzsgA7iSQ
Trigger a Crawl API Dataset Collection Job	POST	/datasets/v3/trigger	conn_mod_def::GJ0-v7n_CQM::T5Oh9083TiKk6uL-ZPQHsQ
Trigger a Web Scraping Collection (Asynchronous)	POST	/datasets/v3/trigger	conn_mod_def::GJ0-vbhbxFw::sQeMlvBBQVuFZXbdPAA8Yg

Zones

Action	Method	Path	Action id
Get Zone Status (Zone Info)	GET	/zone	conn_mod_def::GJ0-pAbmS3k::lMOye257RXyQo8hJ-6-yoQ
List Active Zones	GET	/zone/get_active_zones	conn_mod_def::GJ0-j2wn7H4::YfCs7W_HQum8JTK1DrVUeA
List All Zones	GET	/zone/get_all_zones	conn_mod_def::GJ0-kMcpUQM::-SlVMWULRBmud36TcUnJ6w
Add a Zone	POST	/zone	conn_mod_def::GJ0-j9zLbxE::QFxUWpO0RLqGz4zl8I-hrw
Remove a Zone (or All Zones)	DELETE	/zone	conn_mod_def::GJ0-nj0Mn5Y::japYP-7aTOixFalJM3dw3g
Switch Automatic Failover for a Static Zone	POST	/zone/switch_100uptime	conn_mod_def::GJ0-oa18mYA::41RisEhTQo2fgQCBho9vYQ
Turn On/Off a Zone	POST	/zone/change_disable	conn_mod_def::GJ0-o40DyU0::lEHoC0-9QkOXQP6Z_l4qWw

DatasetSnapshots

Action	Method	Path	Action id
Download a Dataset Snapshot’s Content	GET	/datasets/v3/snapshot/{{snapshotId}}	conn_mod_def::GJ0-wL1OSR4::crsoCwOdRKW3XnqmpRzhlA
Get a Dataset Snapshot’s Content (Download)	GET	/datasets/snapshots/{{id}}/download	conn_mod_def::GJ0-s6tB4Ww::c6qA63xMSM6lvK4Ds2sdgA
Get Dataset Snapshot Metadata	GET	/datasets/snapshots/{{id}}	conn_mod_def::GJ0-snAti2o::qtDjI7CLR3GjT3ZV7la24Q
List Dataset Snapshots	GET	/datasets/v3/snapshots	conn_mod_def::GJ0-x0xnJ0E::bRiuxQPVTKOqVASBCRsUGQ
Monitor a Dataset Snapshot’s Progress	GET	/datasets/v3/progress/{{snapshotId}}	conn_mod_def::GJ0-wjChXr0::EfanGUP8RkqcrEXS4yOZ9w
Deliver a Dataset Snapshot	POST	/datasets/snapshots/{{id}}/deliver	conn_mod_def::GJ0-sDgl_Mc::IwdlpkgASYaDc9kvAoxMCA

ZoneIps

Action	Method	Path	Action id
Get a Zone’s Static (Datacenter/ISP) IPs (Zone Statistics)	GET	/zone/ips	conn_mod_def::GJ0-pdnxBGc::WwuKtHiJTt62794yKX5lXQ
Add Static IP(s) (Datacenter/ISP Zone)	POST	/zone/ips	conn_mod_def::GJ0-kFP3PNE::nlrCbqPYTYKeFrfvwfVHYQ
Migrate Static IPs Between Zones	POST	/zone/ips/migrate	conn_mod_def::GJ0-m9V72kw::02YagFb8RBmnRO_TQfHhoA
Refresh Dedicated Residential IPs (Zone)	POST	/zone/ips/refresh	conn_mod_def::GJ0-nPztp4Q::2zc8Ahz4RH6Ny70mIIeLDg
Remove Static IPs (Datacenter/ISP)	DELETE	/zone/ips	conn_mod_def::GJ0-oQgeUZk::oBdypuq6QRKSbnA0jhbZ_A

DeepLookupRequests

Action	Method	Path	Action id
Download Deep Lookup Request Results	GET	/request/{{id}}/download	conn_mod_def::GJ0-rDi-Hi0::taEgxsZTQueHVhhCX_wggQ
Get Deep Lookup Request Data	GET	/datasets/deep_lookup/v1/request/{{id}}	conn_mod_def::GJ0-rjmGewI::YGML3tPvQwSMPocuGJwmkg
Get Deep Lookup Request Status	GET	/request/{{id}}/status	conn_mod_def::GJ0-rq0QH1Q::ZdJq0ji7Ry6TFY9ypOWyqg
Cancel a Deep Lookup Request	POST	/request/{{id}}/cancel	conn_mod_def::GJ0-qxKNpPo::q-2IX_mGRhm-yawQ1_pA2g
Enrich a Request's Results (Add Columns)	POST	/request/{{id}}/enrich	conn_mod_def::GJ0-rVBEclc::0kUI9LK8RvmXUPbOl3b7uw

ZoneBlacklist

Action	Method	Path	Action id
List Denylisted IPs for Zones	GET	/zone/blacklist	conn_mod_def::GJ0-msN8Nt0::4tztaEFjQcqV9GmHVPtezQ
Add IP(s) to a Zone Denylist	POST	/zone/blacklist	conn_mod_def::GJ0-lthXnUs::2xB38XEqQuC6PjK2nhSg2w
Remove an IP from a Zone Denylist	DELETE	/zone/blacklist	conn_mod_def::GJ0-oI4qnQA::rF69N1hHQ8et9jJHPKRvYQ

Snapshots

Action	Method	Path	Action id
Get a Snapshot’s Input	GET	/datasets/v3/snapshot/{{snapshotId}}/input	conn_mod_def::GJ0-xonMlF8::rSHDYypfQgih9yaLGxEzpA
Cancel a Snapshot Collection	POST	/datasets/v3/snapshot/{{snapshotId}}/cancel	conn_mod_def::GJ0-viYiaWo::aLPG-xxXRJOCQaLEgKuRCQ

AccountStatus

Action	Method	Path	Action id
Get Account Status	GET	/status	conn_mod_def::GJ0-jvp6si4::FaVj_-x6QdC57l7CVZ9HhQ
Change Account Status	PUT	/status	conn_mod_def::GJ0-lhoQFkY::w27rmOtFTfS5yv9OKHgIbg

ZoneDomainPermissions

Action	Method	Path	Action id
Add Domain(s) to a Zone Allowlist/Denylist	POST	/zone/domain_perm	conn_mod_def::GJ0-kWI2hMM::pFiG16dERriXtU6rBsSCDQ
Remove Domains from a Zone Allowlist/Denylist	DELETE	/zone/domain_perm	conn_mod_def::GJ0-n0Wrk7c::J1HBBfQ0Q5a1YoR6Lgbwgw

ZoneAllowlist

Action	Method	Path	Action id
Add an IP to a Zone Allowlist	POST	/zone/whitelist	conn_mod_def::GJ0-keCMerU::ewBYZo4ZTrerpGuR5NLXtQ
Remove an IP from a Zone Allowlist	DELETE	/zone/whitelist	conn_mod_def::GJ0-n-vD9yc::-1rWNIiaSSaMtjaCbQndgw

WebArchiveSearch

Action	Method	Path	Action id
Get Web Archive Search Status	GET	/webarchive/search/{{searchId}}	conn_mod_def::GJ0-qID2g2w::06f08z0bSNmoDh1J7UFl4Q
Run a Web Archive Search	POST	/webarchive/search	conn_mod_def::GJ0-qZFydkg::hNye5An2Sba6SfxNqy_v0w

BrowserSessions

Action	Method	Path	Action id
Get a Browser Session	GET	/browser_sessions/{{sessionId}}	conn_mod_def::GJ0-qgjpJyg::S8Ww5C4zRGeCZycWq7fnYQ
List Browser Sessions	GET	/browser_sessions	conn_mod_def::GJ0-qpl473U::2u-Cl90BRAGQO9EbKmhIIw

DeepLookup

Action	Method	Path	Action id
Enhance a Deep Lookup Research Query	POST	/datasets/deep_lookup/v1/enhance_query	conn_mod_def::GJ0-rM9jBmY::ggRsYR_zSi6WVZlrp_S6mg
Trigger Full Request (Deep Lookup)	POST	/datasets/deep_lookup/v1/trigger	conn_mod_def::GJ0-rx8OHkg::c_NN09KkRzeCt72PgejMWw

SerpRequests

Action	Method	Path	Action id
Create a SERP Request (Scrape Search Results)	POST	/request	conn_mod_def::GJ0-uzeR7yI::ohqcTSrWT5apaN8zOz_O4A
Create an Async SERP Request (Job)	POST	/serp/req	conn_mod_def::GJ0-uiV9_uA::NtIeGIa5TfeqUxrKJmp4Ow

LinkedinPosts

Action	Method	Path	Action id
Collect a LinkedIn Post by URL	POST	/linkedin/posts/collect	conn_mod_def::GJ0-w0gAqvA::ei1LSqHkTlWg1TehEOixFg

InstagramProfiles

Action	Method	Path	Action id
Collect an Instagram Profile by URL	POST	/profiles/collect	conn_mod_def::GJ0-w91pRrA::qOUzyZECTVq1OAqlWTODTA

Reels

Action	Method	Path	Action id
Collect an Instagram Reel by URL	POST	/reels/collect	conn_mod_def::GJ0-xOyogQ0::COomCzVsQtawqJFZTv-pXw

ZoneRouteIps

Action	Method	Path	Action id
Get Available Datacenter & ISP IPs for a Zone	GET	/zone/route_ips	conn_mod_def::GJ0-kyv1uqI::KM-ZgLa7T5-REwvrS3AOoA

DedicatedIps

Action	Method	Path	Action id
Get Available Dedicated IPs per Zone	GET	/zone/route_vips	conn_mod_def::GJ0-k6jGYQ4::na_nXLyPShifxxHMPVmlFw

ZoneCostStats

Action	Method	Path	Action id
Get Total Cost & Bandwidth Stats for a Zone	GET	/zone/cost	conn_mod_def::GJ0-ovTb1Q0::p8Fh3DamT8-Dz49jQ6CMoA

ShieldDomainsByClass

Action	Method	Path	Action id
List Domains Usage by Classification	GET	/shield/domains_by_class	conn_mod_def::GJ0-uCKM-pc::b698fwy2RQWiOplxmUqGhQ

ShieldZonesByClass

Action	Method	Path	Action id
List Shield Zones Usage by Classification	GET	/shield/zones_by_class	conn_mod_def::GJ0-uW-dEyE::t1z1MYf5R3aj_E_TiUCS-Q

LinkedInJobs

Action	Method	Path	Action id
Collect a LinkedIn Job Listing by URL	POST	/linkedin/jobs/collect	conn_mod_def::GJ0-wTjSV6M::hor_JbaVS-uVD1H0vVgo1A

DatasetDeliveries

Action	Method	Path	Action id
Monitor a Dataset Delivery	GET	/datasets/v3/delivery/{{deliveryId}}	conn_mod_def::GJ0-wbH-4Io::M4ZUgxWPS3myOli2Xk0Tyw

Posts

Action	Method	Path	Action id
Collect an Instagram Post by URL	POST	/posts/collect	conn_mod_def::GJ0-wqPbLjs::PLa0GXkzRMKhU3ULRYbe-g

LinkedinProfiles

Action	Method	Path	Action id
Collect a LinkedIn Profile by URL	POST	/linkedin/profiles/collect	conn_mod_def::GJ0-xHH0SLI::yT6BxsvjSnKDJpgF6OBirQ

DatasetSnapshotLogs

Action	Method	Path	Action id
Get Snapshot Data (Dataset Snapshot Logs)	GET	/datasets/v3/log/{{snapshotId}}	conn_mod_def::GJ0-xV4wE-Y::6eYyf1yfTsWCFn8zmsZDiQ

DatasetsSnapshot

Action	Method	Path	Action id
Get Snapshot Delivery Parts (Datasets Snapshot)	GET	/datasets/v3/snapshot/{{snapshotId}}/parts	conn_mod_def::GJ0-xhu-TGo::QwgEZ5_iSMaSUh4F8DnhkQ

Zone

Action	Method	Path	Action id
Count Available IPs for a Zone Plan	GET	/zone/count_available_ips	conn_mod_def::GJ0-kqXUW5s::UcfoUlQBTJ-xCkmZWQaY2Q

ZoneBandwidthStats

Action	Method	Path	Action id
Get Bandwidth Stats for a Zone	GET	/zone/bw	conn_mod_def::GJ0-lI9AN-M::3SY9BHBeSlq3nVG_3Lxw7Q

BandwidthStats

Action	Method	Path	Action id
Get Bandwidth Stats for All Zones	GET	/customer/bw	conn_mod_def::GJ0-lXA3ZkY::cJo-0G2IT1udqF2pDg9AWA

DomainUsageMetrics

Action	Method	Path	Action id
Get Domain Usage Metrics (Bandwidth or Request Count)	GET	/domains/{{metric}}	conn_mod_def::GJ0-l2XJ8QU::kRwFZQmoQWq3cX3A53bs9w

CountriesList

Action	Method	Path	Action id
Get Available Countries (per Zone Type)	GET	/countrieslist	conn_mod_def::GJ0-l9PLSYI::Xi3iM1BySJegRjZMc14Nxg

Cities

Action	Method	Path	Action id
Get Country Cities	GET	/cities	conn_mod_def::GJ0-mEUHJj0::GgXm8wmtRJ-hy7cpsnEU5w

NetworkStatus

Action	Method	Path	Action id
Get Current Service Status (by Network Type)	GET	/network_status/{{networkType}}	conn_mod_def::GJ0-mLru9Ig::TRbxupH1SXmDUqDC003mRg

ProxiesPendingReplacement

Action	Method	Path	Action id
List Proxies Pending Replacement (by Zone)	GET	/zone/proxies_pending_replacement	conn_mod_def::GJ0-mTmyyXI::6o55ik5wQQuKDb-Kn6bnyg

StaticNetworkCities

Action	Method	Path	Action id
List a Country’s Static Network Cities	GET	/zone/static/cities	conn_mod_def::GJ0-mbPDzTM::gx3clEdcRuCLDxhN2tNB9g

ZoneWhitelist

Action	Method	Path	Action id
List Allowlisted IPs for Zones	GET	/zone/whitelist	conn_mod_def::GJ0-mipV9dI::CUDP7-4RQN667_HEGN8uDw

StaticZoneUnavailableIps

Action	Method	Path	Action id
Get Unavailable IPs for Static Zones (Live Status)	GET	/zone/ips/unavailable	conn_mod_def::GJ0-mzqiVUE::VlYxFDEiQGmqrbSrjw8ojA

RecentIps

Action	Method	Path	Action id
List Recent IPs Attempting to Use Your Zone	GET	/zone/recent_ips	conn_mod_def::GJ0-nFGKPUM::7Bnu7513TOadFqYaFepABQ

StaticIps

Action	Method	Path	Action id
Refresh Static IPs (Datacenter/ISP)	POST	/zone/ips/refresh	conn_mod_def::GJ0-nZgwO5c::vGc4Z_5TR9eBTqMm-Q_4qA

ZoneVips

Action	Method	Path	Action id
Remove Dedicated Residential IPs (Remove VIPs From a Zone)	DELETE	/zone/vips	conn_mod_def::GJ0-nriQ-4o::gI13OQTiQLmLcdqlsNFjVw

CustomerBalance

Action	Method	Path	Action id
Get Total Customer Balance	GET	/customer/balance	conn_mod_def::GJ0-okQses8::XrGPJSZcTjq0tpy2G3k9ng

ZonePasswords

Action	Method	Path	Action id
Get Zone Passwords	GET	/zone/passwords	conn_mod_def::GJ0-pKT9kZw::72pOSA8eTe66peMAo0w_gA

ZonePermissions

Action	Method	Path	Action id
Get Zone Permissions	GET	/zone/permissions	conn_mod_def::GJ0-pT4xnBc::JQEIjim8TDWPhpne3GFsHw

ZoneStatus

Action	Method	Path	Action id
Get Zone Status	GET	/zone/status	conn_mod_def::GJ0-pm1XG6A::6okO_OVVTY-91mCoHojcig

WebArchiveSearchStatuses

Action	Method	Path	Action id
Get All Web Archive Search Statuses	GET	/webarchive/searches	conn_mod_def::GJ0-pxZfdME::cSG-qD4sQdGWTUVC6oPmXQ

WebArchiveDumps

Action	Method	Path	Action id
List All Web Archive Data Snapshot (Dump) Statuses	GET	/webarchive/dumps	conn_mod_def::GJ0-p5ndbjE::ZYEEKoISSua-Y21yMgsFlQ

WebarchiveDump

Action	Method	Path	Action id
Deliver a Web Archive Snapshot Dump to Cloud Storage (S3, Azure Blob, or Webhook)	POST	/webarchive/dump	conn_mod_def::GJ0-qBFq0-o::fpT-fk_xThOqLnYkBS8Exg

WebarchiveDumps

Action	Method	Path	Action id
Get a Data Snapshot (Dump) Status	GET	/webarchive/dump/{{dumpId}}	conn_mod_def::GJ0-qP9dp-c::Wl1pSVEDRC-EwkNxjsl69g

DeepLookupPreviews

Action	Method	Path	Action id
Create Deep Lookup Preview	POST	/datasets/deep_lookup/v1/preview	conn_mod_def::GJ0-q5IgxT8::p38uz1ayQS-SMRm7T-x_5Q

DeepLookupPreview

Action	Method	Path	Action id
Get Preview Data (Deep Lookup)	GET	/datasets/deep_lookup/v1/preview/{{id}}	conn_mod_def::GJ0-rcAWEGU::bDAfOlzrT3WferBQwrD71A

DatasetSnapshotParts

Action	Method	Path	Action id
Get Dataset Snapshot Parts	GET	/datasets/snapshots/{{id}}/parts	conn_mod_def::GJ0-sxjW7QE::Y_P8m3KnQcSSUSutxjoEQA

This lists 90 of 103 actions. For anything not here, call search_one_platform_actions with platform bright-data. The full catalog is at https://www.withone.ai/knowledge/bright-data.

When a call fails

The error comes from BrightData, not from One. A 400 or 422 means your parameters do not match the schema, so re-read the knowledge and fix the field. A 401 or 403 means the connection needs re-authorizing, which no retry will fix. A 404 means the id is not on this account. A 429 means slow down. Never retry a write more than once: the first attempt may have landed.

Full catalog: https://www.withone.ai/knowledge/bright-data

Integration knowledge by One (withone.ai), licensed under One-Knowledge-1.0. Attribution must be preserved in derivative works.