--- 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. license: One-Knowledge-1.0 (https://www.withone.ai/licenses/knowledge) metadata: author: one-systems attribution: Integration knowledge by One (withone.ai) platform: bright-data generated-from: one-knowledge-base --- # 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](https://www.withone.ai/licenses/knowledge). Attribution must be preserved in derivative works.