bright-data-best-practices
Audited by Runlayer on Mar 4, 2026
Malicious tool definition detected
### Flow **Step 1: Submit request** ```python response = requests.post( "https://api.brightdata.com/unblocker/req", params={"zone": "YOUR_ZONE_NAME"}, headers={"Authorization": f"Bearer {API_KEY}"}, json={"url": "https://example.com"} ) response_id = response.json()["response_id"] ``` **Step 2: Poll for result** ```python import time while True: result = requests.get( "https://api.brightdata.com/unblocker/get_result", params={"response_id": response_id}, headers={"Authorization": f"Bearer {API_K
### Mobile User Agent Append `-ua-mobile` to proxy username, or use via proxy username flag, to use mobile-specific user agents. ### Auto-Throttling System automatically adjusts based on success rates: - Default threshold: 70% success rate - Automatically applies better-performing configurations - When custom headers/cookies are enabled: customizable threshold ### Debug Header Add `-debug-full` to proxy username to receive `x-brd-debug` response header containing: request ID, traffic metrics, bi
Tool passed security scan
Malicious tool definition detected
Tool passed security scan
Malicious tool definition detected
--- ## Premium Domains Certain websites classified as "premium" require more Browser API resources: - Enable during zone creation: toggle "Premium Domains" ON - Only traffic to premium-classified domains incurs the higher rate - The list of premium domains updates regularly based on Bright Data's algorithms - Check current premium domain list in your zone settings --- ## Error Codes | Code | Issue | Solution | |------|-------|----------| | `407` | Wrong port | Playwright/Puppeteer = port `9222`,
Tool passed security scan
Malicious tool definition detected
```python if len(urls) <= 20: # Use /scrape for immediate results endpoint = "https://api.brightdata.com/datasets/v3/scrape" else: # Use /trigger for bulk endpoint = "https://api.brightdata.com/datasets/v3/trigger" ``` ### 2.
Tool passed security scan