From dbca460ab4bbcca9664840426b849fada1bfea06 Mon Sep 17 00:00:00 2001
From: omri-rulf <omriru@brightdata.com>
Date: Thu, 16 Jul 2026 21:32:48 +0300
Subject: [PATCH 1/4] =?UTF-8?q?docs:=20fix=20outdated=20API=20keys=20URL?=
 =?UTF-8?q?=20(cp/api=5Fkeys=20=E2=86=92=20cp/setting/users)?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md                | 2 +-
 src/brightdata/client.py | 2 +-
 2 files changed, 2 insertions(+), 2 deletions(-)

diff --git a/README.md b/README.md
index 3b4d3d0..8290296 100644
--- a/README.md
+++ b/README.md
@@ -13,7 +13,7 @@ pip install brightdata-sdk
 
 ## Configuration
 
-Get your API Token from the [Bright Data Control Panel](https://brightdata.com/cp/api_keys):
+Get your API Token from the [Bright Data Control Panel](https://brightdata.com/cp/setting/users):
 
 ```bash
 export BRIGHTDATA_API_TOKEN="your_api_token_here"
diff --git a/src/brightdata/client.py b/src/brightdata/client.py
index 08aae05..9f99fd6 100644
--- a/src/brightdata/client.py
+++ b/src/brightdata/client.py
@@ -211,7 +211,7 @@ def _load_token(self, token: Optional[str]) -> str:
             f"Provide token in one of these ways:\n"
             f"  1. Pass as parameter: BrightDataClient(token='your_token')\n"
             f"  2. Set environment variable: {self.TOKEN_ENV_VAR}\n\n"
-            f"Get your API token from: https://brightdata.com/cp/api_keys"
+            f"Get your API token from: https://brightdata.com/cp/setting/users"
         )
 
     async def _ensure_zones(self) -> None:

From b9fe4fd399a3c9393b2956f45237fe5481e4958b Mon Sep 17 00:00:00 2001
From: omri-rulf <omriru@brightdata.com>
Date: Sun, 19 Jul 2026 10:52:40 +0300
Subject: [PATCH 2/4] =?UTF-8?q?docs:=20fix=20Discover=20example=20?=
 =?UTF-8?q?=E2=80=94=20items=20use=20'link',=20not=20'url'?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README copy.md | 376 +++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 376 insertions(+)
 create mode 100644 README copy.md

diff --git a/README copy.md b/README copy.md
new file mode 100644
index 0000000..e94ff3e
--- /dev/null
+++ b/README copy.md	
@@ -0,0 +1,376 @@
+# Bright Data Python SDK
+
+The official Python SDK for [Bright Data](https://brightdata.com) APIs. Scrape any website, get SERP results, bypass bot detection and CAPTCHAs, and access 100+ ready-made datasets.
+
+[![Python](https://img.shields.io/badge/python-3.9%2B-blue)](https://www.python.org/)
+[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
+
+## Installation
+
+```bash
+pip install brightdata-sdk
+```
+
+## Configuration
+
+Get your API Token from the [Bright Data Control Panel](https://brightdata.com/cp/setting/users):
+
+```bash
+export BRIGHTDATA_API_TOKEN="your_api_token_here"
+```
+
+## Quick Start
+
+This SDK is **async-native**. A sync client is also available (see [Sync Client](#sync-client)).
+
+```python
+import asyncio
+from brightdata import BrightDataClient
+
+async def main():
+    async with BrightDataClient() as client:
+        result = await client.scrape_url("https://example.com")
+        print(result.data)
+
+asyncio.run(main())
+```
+
+## Usage Examples
+
+### Web Scraping
+
+```python
+async with BrightDataClient() as client:
+    result = await client.scrape_url("https://example.com")
+    print(result.data)
+```
+
+#### Web Scraping Async Mode
+
+For non-blocking web scraping, use `mode="async"`. This triggers a request and returns a `response_id`, which the SDK automatically polls until results are ready:
+
+```python
+async with BrightDataClient() as client:
+    # Triggers request → gets response_id → polls until ready
+    result = await client.scrape_url(
+        url="https://example.com",
+        mode="async",
+        poll_interval=5,    # Check every 5 seconds
+        poll_timeout=180    # Web Unlocker async can take ~2 minutes
+    )
+    print(result.data)
+
+    # Batch scraping multiple URLs concurrently
+    urls = ["https://example.com", "https://example.org", "https://example.net"]
+    results = await client.scrape_url(url=urls, mode="async", poll_timeout=180)
+```
+
+**How it works:**
+1. Sends request to `/unblocker/req` → returns `response_id` immediately
+2. Polls `/unblocker/get_result?response_id=...` until ready or timeout
+3. Returns the scraped data
+
+**When to use async mode:**
+- Batch scraping with many URLs
+- Background processing while continuing other work
+
+**Performance note:** Web Unlocker async mode typically takes ~2 minutes to complete. For faster results on single URLs, use the default sync mode (no `mode` parameter).
+
+### Search Engines (SERP)
+
+Search across Google, Bing, and Yandex. Google and Bing return parsed organic results (title/url/description/position); Yandex has no upstream parser and returns raw HTML.
+
+```python
+async with BrightDataClient() as client:
+    # Google — parsed results
+    result = await client.search.google(query="python scraping", num_results=10)
+    for item in result.data:
+        print(item["title"], item["url"])
+
+    # Bing — parsed results (same shape as Google)
+    result = await client.search.bing(query="python scraping", num_results=10)
+    for item in result.data:
+        print(item["title"], item["url"])
+
+    # Yandex — raw HTML only (parse it yourself with BeautifulSoup etc.)
+    result = await client.search.yandex(query="python scraping", num_results=10)
+    print(f"{len(result.raw_html)} chars of HTML")
+```
+
+Batch queries: pass a list of strings instead of a single string — each query runs concurrently and you get back a `List[SearchResult]`.
+
+#### SERP Async Mode
+
+For non-blocking SERP requests, use `mode="async"`:
+
+```python
+async with BrightDataClient() as client:
+    # Non-blocking - polls for results
+    result = await client.search.google(
+        query="python programming",
+        mode="async",
+        poll_interval=2,   # Check every 2 seconds
+        poll_timeout=30    # Give up after 30 seconds
+    )
+
+    for item in result.data:
+        print(item['title'], item['link'])
+```
+
+**When to use async mode:**
+- Batch operations with many queries
+- Background processing while continuing other work
+- When scraping may take longer than usual
+
+**Note:** Async mode uses the same zones and returns the same data structure as sync mode - no extra configuration needed!
+
+### Web Scraper API
+
+The SDK includes ready-to-use scrapers for popular websites: Amazon, LinkedIn, Instagram, Facebook, and more.
+
+**Pattern:** `client.scrape.<platform>.<method>(url)`
+
+**Example: Amazon**
+```python
+async with BrightDataClient() as client:
+    # Product details
+    result = await client.scrape.amazon.products(url="https://amazon.com/dp/B0CRMZHDG8")
+
+    # Reviews
+    result = await client.scrape.amazon.reviews(url="https://amazon.com/dp/B0CRMZHDG8")
+
+    # Sellers
+    result = await client.scrape.amazon.sellers(url="https://amazon.com/dp/B0CRMZHDG8")
+```
+
+**Available scrapers:**
+- `client.scrape.amazon` — products, reviews, sellers
+- `client.scrape.linkedin` — profiles, companies, jobs, posts
+- `client.scrape.instagram` — profiles, posts, comments, reels
+- `client.scrape.facebook` — posts, comments, reels, pages, marketplace, events
+- `client.scrape.tiktok` — profiles, posts by keyword/profile/url
+- `client.scrape.youtube` — videos, channels, comments
+- `client.scrape.reddit` — posts, comments, posts by keyword
+- `client.scrape.pinterest` — posts, profiles, posts by keyword/profile
+- `client.scrape.chatgpt` — send prompts, retrieve responses
+- `client.scrape.perplexity` — queries with AI-ranked results
+- `client.scrape.digikey` — electronic component products
+
+### Browser API
+
+Cloud-hosted Chrome instances accessible via the Chrome DevTools Protocol (CDP). The SDK builds the connection URL — you drive the browser with Playwright, Puppeteer, or Selenium.
+
+```python
+from brightdata import BrightDataClient
+from playwright.async_api import async_playwright
+
+client = BrightDataClient(
+    browser_username="brd-customer-<id>-zone-<zone>",
+    browser_password="<password>",
+)
+
+url = client.browser.get_connect_url(country="us")  # country is optional
+
+async with async_playwright() as pw:
+    browser = await pw.chromium.connect_over_cdp(url)
+    page = await browser.new_page()
+    await page.goto("https://example.com")
+    html = await page.content()
+    await browser.close()
+```
+
+**When to use:** sites that require full browser automation — JS rendering, login flows, interactive clicks. For plain HTML fetches, prefer `client.scrape_url()`.
+
+### Discover API
+
+AI-ranked web search. Unlike SERP (which returns engine-ordered results), Discover takes a `query` plus an `intent` phrase and re-ranks by relevance. Optionally extracts full page content as markdown.
+
+```python
+async with BrightDataClient() as client:
+    result = await client.discover(
+        query="artificial intelligence trends 2026",
+        intent="latest AI technology developments",
+        country="us",
+        num_results=10,
+    )
+    for item in result.data:
+        print(f"[{item['relevance_score']:.2f}] {item['title']}  {item['link']}")
+```
+
+For long-running discoveries, trigger and poll separately:
+
+```python
+job = await client.discover_trigger(query="...", intent="...")
+result = await job.wait_and_fetch(timeout=60)
+```
+
+**When to use Discover vs SERP:** Discover when you want *entity-level* relevance ranking driven by a natural-language intent (e.g. "find sustainability-focused AI companies"). SERP when you want raw search engine results.
+
+### Scraper Studio
+
+Run custom collectors built in [Bright Data's Scraper Studio](https://brightdata.com/cp/scrapers). One call triggers the job, polls until ready, and returns the records:
+
+```python
+async with BrightDataClient() as client:
+    data = await client.scraper_studio.run(
+        collector="c_abc123",                       # your collector ID
+        input={"url": "https://example.com"},       # collector-specific input
+        timeout=180,
+    )
+    print(f"Got {len(data)} records")
+```
+
+For manual control over the lifecycle, use `client.scraper_studio.trigger()` → `.status()` → `.fetch()`.
+
+## Datasets API
+
+Access 100+ ready-made datasets from Bright Data — pre-collected, structured data from popular platforms.
+
+```python
+async with BrightDataClient() as client:
+    # Filter a dataset — returns a snapshot_id
+    snapshot_id = await client.datasets.imdb_movies(
+        filter={"name": "title", "operator": "includes", "value": "black"},
+        records_limit=5
+    )
+
+    # Download when ready (polls until snapshot is complete)
+    data = await client.datasets.imdb_movies.download(snapshot_id)
+    print(f"Got {len(data)} records")
+
+    # Quick sample: .sample() auto-discovers fields, no filter needed
+    # Works on any dataset
+    snapshot_id = await client.datasets.imdb_movies.sample(records_limit=5)
+```
+
+**Export results to file:**
+
+```python
+from brightdata.datasets import export
+
+export(data, "results.json")   # JSON
+export(data, "results.csv")    # CSV
+export(data, "results.jsonl")  # JSONL
+```
+
+**Available dataset categories:**
+- **E-commerce:** Amazon, Walmart, Shopee, Lazada, Zalando, Zara, H&M, Shein, IKEA, Sephora, and more
+- **Business intelligence:** ZoomInfo, PitchBook, Owler, Slintel, VentureRadar, Manta
+- **Jobs & HR:** Glassdoor (companies, reviews, jobs), Indeed (companies, jobs), Xing
+- **Reviews:** Google Maps, Yelp, G2, Trustpilot, TrustRadius
+- **Social media:** Pinterest (posts, profiles), Facebook Pages
+- **Real estate:** Zillow, Airbnb, and 8+ regional platforms
+- **Luxury brands:** Chanel, Dior, Prada, Balenciaga, Hermes, YSL, and more
+- **Entertainment:** IMDB, NBA, Goodreads
+
+**Discover available fields:**
+
+```python
+metadata = await client.datasets.imdb_movies.get_metadata()
+for name, field in metadata.fields.items():
+    print(f"{name}: {field.type}")
+```
+
+## Async Usage
+
+Run multiple requests concurrently:
+
+```python
+import asyncio
+from brightdata import BrightDataClient
+
+async def main():
+    async with BrightDataClient() as client:
+        urls = ["https://example.com/page1", "https://example.com/page2", "https://example.com/page3"]
+        tasks = [client.scrape_url(url) for url in urls]
+        results = await asyncio.gather(*tasks)
+
+asyncio.run(main())
+```
+
+### Manual Trigger/Poll/Fetch
+
+For long-running scrapes:
+
+```python
+async with BrightDataClient() as client:
+    # Trigger
+    job = await client.scrape.amazon.products_trigger(url="https://amazon.com/dp/B123")
+
+    # Wait for completion
+    await job.wait(timeout=180)
+
+    # Fetch results
+    data = await job.fetch()
+```
+
+## Sync Client
+
+For simpler use cases, use `SyncBrightDataClient`:
+
+```python
+from brightdata import SyncBrightDataClient
+
+with SyncBrightDataClient() as client:
+    result = client.scrape_url("https://example.com")
+    print(result.data)
+
+    # All methods work the same
+    result = client.scrape.amazon.products(url="https://amazon.com/dp/B123")
+    result = client.search.google(query="python")
+```
+
+See [docs/sync_client.md](docs/sync_client.md) for details.
+
+## Account & Zones
+
+Inspect the account, list zones, and clean up unused ones:
+
+```python
+async with BrightDataClient() as client:
+    # Verify token + connectivity (never raises — returns False on any error)
+    if await client.test_connection():
+        print("Connected")
+
+    # Account status, usage stats, credit balance
+    info = await client.get_account_info()
+    print(info)
+
+    # All zones on this account, with type and usage
+    zones = await client.list_zones()
+    for z in zones:
+        print(z["name"], z["type"])
+
+    # Delete a zone — destructive, confirm before calling
+    await client.delete_zone("zone_to_remove")
+```
+
+## Troubleshooting
+
+**RuntimeError: SyncBrightDataClient cannot be used inside async context**
+```python
+# Wrong - using sync client in async function
+async def main():
+    with SyncBrightDataClient() as client:  # Error!
+        ...
+
+# Correct - use async client
+async def main():
+    async with BrightDataClient() as client:
+        result = await client.scrape_url("https://example.com")
+```
+
+**RuntimeError: BrightDataClient not initialized**
+```python
+# Wrong - forgot context manager
+client = BrightDataClient()
+result = await client.scrape_url("...")  # Error!
+
+# Correct - use context manager
+async with BrightDataClient() as client:
+    result = await client.scrape_url("...")
+```
+
+## License
+
+MIT License

From 6ffacf11978254fc09856d7e6b1b7c594fe0635c Mon Sep 17 00:00:00 2001
From: omri-rulf <omriru@brightdata.com>
Date: Sun, 19 Jul 2026 11:03:25 +0300
Subject: [PATCH 3/4] Delete README copy.md

---
 README copy.md | 376 -------------------------------------------------
 1 file changed, 376 deletions(-)
 delete mode 100644 README copy.md

diff --git a/README copy.md b/README copy.md
deleted file mode 100644
index e94ff3e..0000000
--- a/README copy.md	
+++ /dev/null
@@ -1,376 +0,0 @@
-# Bright Data Python SDK
-
-The official Python SDK for [Bright Data](https://brightdata.com) APIs. Scrape any website, get SERP results, bypass bot detection and CAPTCHAs, and access 100+ ready-made datasets.
-
-[![Python](https://img.shields.io/badge/python-3.9%2B-blue)](https://www.python.org/)
-[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)
-
-## Installation
-
-```bash
-pip install brightdata-sdk
-```
-
-## Configuration
-
-Get your API Token from the [Bright Data Control Panel](https://brightdata.com/cp/setting/users):
-
-```bash
-export BRIGHTDATA_API_TOKEN="your_api_token_here"
-```
-
-## Quick Start
-
-This SDK is **async-native**. A sync client is also available (see [Sync Client](#sync-client)).
-
-```python
-import asyncio
-from brightdata import BrightDataClient
-
-async def main():
-    async with BrightDataClient() as client:
-        result = await client.scrape_url("https://example.com")
-        print(result.data)
-
-asyncio.run(main())
-```
-
-## Usage Examples
-
-### Web Scraping
-
-```python
-async with BrightDataClient() as client:
-    result = await client.scrape_url("https://example.com")
-    print(result.data)
-```
-
-#### Web Scraping Async Mode
-
-For non-blocking web scraping, use `mode="async"`. This triggers a request and returns a `response_id`, which the SDK automatically polls until results are ready:
-
-```python
-async with BrightDataClient() as client:
-    # Triggers request → gets response_id → polls until ready
-    result = await client.scrape_url(
-        url="https://example.com",
-        mode="async",
-        poll_interval=5,    # Check every 5 seconds
-        poll_timeout=180    # Web Unlocker async can take ~2 minutes
-    )
-    print(result.data)
-
-    # Batch scraping multiple URLs concurrently
-    urls = ["https://example.com", "https://example.org", "https://example.net"]
-    results = await client.scrape_url(url=urls, mode="async", poll_timeout=180)
-```
-
-**How it works:**
-1. Sends request to `/unblocker/req` → returns `response_id` immediately
-2. Polls `/unblocker/get_result?response_id=...` until ready or timeout
-3. Returns the scraped data
-
-**When to use async mode:**
-- Batch scraping with many URLs
-- Background processing while continuing other work
-
-**Performance note:** Web Unlocker async mode typically takes ~2 minutes to complete. For faster results on single URLs, use the default sync mode (no `mode` parameter).
-
-### Search Engines (SERP)
-
-Search across Google, Bing, and Yandex. Google and Bing return parsed organic results (title/url/description/position); Yandex has no upstream parser and returns raw HTML.
-
-```python
-async with BrightDataClient() as client:
-    # Google — parsed results
-    result = await client.search.google(query="python scraping", num_results=10)
-    for item in result.data:
-        print(item["title"], item["url"])
-
-    # Bing — parsed results (same shape as Google)
-    result = await client.search.bing(query="python scraping", num_results=10)
-    for item in result.data:
-        print(item["title"], item["url"])
-
-    # Yandex — raw HTML only (parse it yourself with BeautifulSoup etc.)
-    result = await client.search.yandex(query="python scraping", num_results=10)
-    print(f"{len(result.raw_html)} chars of HTML")
-```
-
-Batch queries: pass a list of strings instead of a single string — each query runs concurrently and you get back a `List[SearchResult]`.
-
-#### SERP Async Mode
-
-For non-blocking SERP requests, use `mode="async"`:
-
-```python
-async with BrightDataClient() as client:
-    # Non-blocking - polls for results
-    result = await client.search.google(
-        query="python programming",
-        mode="async",
-        poll_interval=2,   # Check every 2 seconds
-        poll_timeout=30    # Give up after 30 seconds
-    )
-
-    for item in result.data:
-        print(item['title'], item['link'])
-```
-
-**When to use async mode:**
-- Batch operations with many queries
-- Background processing while continuing other work
-- When scraping may take longer than usual
-
-**Note:** Async mode uses the same zones and returns the same data structure as sync mode - no extra configuration needed!
-
-### Web Scraper API
-
-The SDK includes ready-to-use scrapers for popular websites: Amazon, LinkedIn, Instagram, Facebook, and more.
-
-**Pattern:** `client.scrape.<platform>.<method>(url)`
-
-**Example: Amazon**
-```python
-async with BrightDataClient() as client:
-    # Product details
-    result = await client.scrape.amazon.products(url="https://amazon.com/dp/B0CRMZHDG8")
-
-    # Reviews
-    result = await client.scrape.amazon.reviews(url="https://amazon.com/dp/B0CRMZHDG8")
-
-    # Sellers
-    result = await client.scrape.amazon.sellers(url="https://amazon.com/dp/B0CRMZHDG8")
-```
-
-**Available scrapers:**
-- `client.scrape.amazon` — products, reviews, sellers
-- `client.scrape.linkedin` — profiles, companies, jobs, posts
-- `client.scrape.instagram` — profiles, posts, comments, reels
-- `client.scrape.facebook` — posts, comments, reels, pages, marketplace, events
-- `client.scrape.tiktok` — profiles, posts by keyword/profile/url
-- `client.scrape.youtube` — videos, channels, comments
-- `client.scrape.reddit` — posts, comments, posts by keyword
-- `client.scrape.pinterest` — posts, profiles, posts by keyword/profile
-- `client.scrape.chatgpt` — send prompts, retrieve responses
-- `client.scrape.perplexity` — queries with AI-ranked results
-- `client.scrape.digikey` — electronic component products
-
-### Browser API
-
-Cloud-hosted Chrome instances accessible via the Chrome DevTools Protocol (CDP). The SDK builds the connection URL — you drive the browser with Playwright, Puppeteer, or Selenium.
-
-```python
-from brightdata import BrightDataClient
-from playwright.async_api import async_playwright
-
-client = BrightDataClient(
-    browser_username="brd-customer-<id>-zone-<zone>",
-    browser_password="<password>",
-)
-
-url = client.browser.get_connect_url(country="us")  # country is optional
-
-async with async_playwright() as pw:
-    browser = await pw.chromium.connect_over_cdp(url)
-    page = await browser.new_page()
-    await page.goto("https://example.com")
-    html = await page.content()
-    await browser.close()
-```
-
-**When to use:** sites that require full browser automation — JS rendering, login flows, interactive clicks. For plain HTML fetches, prefer `client.scrape_url()`.
-
-### Discover API
-
-AI-ranked web search. Unlike SERP (which returns engine-ordered results), Discover takes a `query` plus an `intent` phrase and re-ranks by relevance. Optionally extracts full page content as markdown.
-
-```python
-async with BrightDataClient() as client:
-    result = await client.discover(
-        query="artificial intelligence trends 2026",
-        intent="latest AI technology developments",
-        country="us",
-        num_results=10,
-    )
-    for item in result.data:
-        print(f"[{item['relevance_score']:.2f}] {item['title']}  {item['link']}")
-```
-
-For long-running discoveries, trigger and poll separately:
-
-```python
-job = await client.discover_trigger(query="...", intent="...")
-result = await job.wait_and_fetch(timeout=60)
-```
-
-**When to use Discover vs SERP:** Discover when you want *entity-level* relevance ranking driven by a natural-language intent (e.g. "find sustainability-focused AI companies"). SERP when you want raw search engine results.
-
-### Scraper Studio
-
-Run custom collectors built in [Bright Data's Scraper Studio](https://brightdata.com/cp/scrapers). One call triggers the job, polls until ready, and returns the records:
-
-```python
-async with BrightDataClient() as client:
-    data = await client.scraper_studio.run(
-        collector="c_abc123",                       # your collector ID
-        input={"url": "https://example.com"},       # collector-specific input
-        timeout=180,
-    )
-    print(f"Got {len(data)} records")
-```
-
-For manual control over the lifecycle, use `client.scraper_studio.trigger()` → `.status()` → `.fetch()`.
-
-## Datasets API
-
-Access 100+ ready-made datasets from Bright Data — pre-collected, structured data from popular platforms.
-
-```python
-async with BrightDataClient() as client:
-    # Filter a dataset — returns a snapshot_id
-    snapshot_id = await client.datasets.imdb_movies(
-        filter={"name": "title", "operator": "includes", "value": "black"},
-        records_limit=5
-    )
-
-    # Download when ready (polls until snapshot is complete)
-    data = await client.datasets.imdb_movies.download(snapshot_id)
-    print(f"Got {len(data)} records")
-
-    # Quick sample: .sample() auto-discovers fields, no filter needed
-    # Works on any dataset
-    snapshot_id = await client.datasets.imdb_movies.sample(records_limit=5)
-```
-
-**Export results to file:**
-
-```python
-from brightdata.datasets import export
-
-export(data, "results.json")   # JSON
-export(data, "results.csv")    # CSV
-export(data, "results.jsonl")  # JSONL
-```
-
-**Available dataset categories:**
-- **E-commerce:** Amazon, Walmart, Shopee, Lazada, Zalando, Zara, H&M, Shein, IKEA, Sephora, and more
-- **Business intelligence:** ZoomInfo, PitchBook, Owler, Slintel, VentureRadar, Manta
-- **Jobs & HR:** Glassdoor (companies, reviews, jobs), Indeed (companies, jobs), Xing
-- **Reviews:** Google Maps, Yelp, G2, Trustpilot, TrustRadius
-- **Social media:** Pinterest (posts, profiles), Facebook Pages
-- **Real estate:** Zillow, Airbnb, and 8+ regional platforms
-- **Luxury brands:** Chanel, Dior, Prada, Balenciaga, Hermes, YSL, and more
-- **Entertainment:** IMDB, NBA, Goodreads
-
-**Discover available fields:**
-
-```python
-metadata = await client.datasets.imdb_movies.get_metadata()
-for name, field in metadata.fields.items():
-    print(f"{name}: {field.type}")
-```
-
-## Async Usage
-
-Run multiple requests concurrently:
-
-```python
-import asyncio
-from brightdata import BrightDataClient
-
-async def main():
-    async with BrightDataClient() as client:
-        urls = ["https://example.com/page1", "https://example.com/page2", "https://example.com/page3"]
-        tasks = [client.scrape_url(url) for url in urls]
-        results = await asyncio.gather(*tasks)
-
-asyncio.run(main())
-```
-
-### Manual Trigger/Poll/Fetch
-
-For long-running scrapes:
-
-```python
-async with BrightDataClient() as client:
-    # Trigger
-    job = await client.scrape.amazon.products_trigger(url="https://amazon.com/dp/B123")
-
-    # Wait for completion
-    await job.wait(timeout=180)
-
-    # Fetch results
-    data = await job.fetch()
-```
-
-## Sync Client
-
-For simpler use cases, use `SyncBrightDataClient`:
-
-```python
-from brightdata import SyncBrightDataClient
-
-with SyncBrightDataClient() as client:
-    result = client.scrape_url("https://example.com")
-    print(result.data)
-
-    # All methods work the same
-    result = client.scrape.amazon.products(url="https://amazon.com/dp/B123")
-    result = client.search.google(query="python")
-```
-
-See [docs/sync_client.md](docs/sync_client.md) for details.
-
-## Account & Zones
-
-Inspect the account, list zones, and clean up unused ones:
-
-```python
-async with BrightDataClient() as client:
-    # Verify token + connectivity (never raises — returns False on any error)
-    if await client.test_connection():
-        print("Connected")
-
-    # Account status, usage stats, credit balance
-    info = await client.get_account_info()
-    print(info)
-
-    # All zones on this account, with type and usage
-    zones = await client.list_zones()
-    for z in zones:
-        print(z["name"], z["type"])
-
-    # Delete a zone — destructive, confirm before calling
-    await client.delete_zone("zone_to_remove")
-```
-
-## Troubleshooting
-
-**RuntimeError: SyncBrightDataClient cannot be used inside async context**
-```python
-# Wrong - using sync client in async function
-async def main():
-    with SyncBrightDataClient() as client:  # Error!
-        ...
-
-# Correct - use async client
-async def main():
-    async with BrightDataClient() as client:
-        result = await client.scrape_url("https://example.com")
-```
-
-**RuntimeError: BrightDataClient not initialized**
-```python
-# Wrong - forgot context manager
-client = BrightDataClient()
-result = await client.scrape_url("...")  # Error!
-
-# Correct - use context manager
-async with BrightDataClient() as client:
-    result = await client.scrape_url("...")
-```
-
-## License
-
-MIT License

From 59bcf803b53149695a138f009066a32c8bf3ed25 Mon Sep 17 00:00:00 2001
From: omri-rulf <omriru@brightdata.com>
Date: Sun, 19 Jul 2026 11:08:02 +0300
Subject: [PATCH 4/4] =?UTF-8?q?docs:=20fix=20Discover=20example=20?=
 =?UTF-8?q?=E2=80=94=20items=20use=20'link',=20not=20'url'?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/README.md b/README.md
index 8290296..e94ff3e 100644
--- a/README.md
+++ b/README.md
@@ -194,7 +194,7 @@ async with BrightDataClient() as client:
         num_results=10,
     )
     for item in result.data:
-        print(f"[{item['relevance_score']:.2f}] {item['title']}  {item['url']}")
+        print(f"[{item['relevance_score']:.2f}] {item['title']}  {item['link']}")
 ```
 
 For long-running discoveries, trigger and poll separately: