Update README.md

Author: Idanvilenski

README.md

@@ -20,18 +20,18 @@
 - **Zone Management**: Automatic zone creation and management
 - **Multiple Output Formats**: JSON, raw HTML, markdown, and more
 
-## Installation from package
+## Installation
 
-```python
+### From pypi
+```bash
 # Enter your project's folder in your terminal
 pip install brightdata
 
 # Make sure that you have pip installed on your device
 ```
 
-## Installation from GitHub
-
-```python
+### From GitHub
+```bash
 # Clone the repository
 git clone https://github.com/brightdata/bright-data-sdk-python.git
 cd bright-temp
@@ -102,18 +102,7 @@ results = client.search(
 ```python
 # Download scraped content
 data = client.scrape("https://example.com")
-filepath = client.download_content(data, "results.json", "json")
-
-# Auto-generate filename with timestamp
-filepath = client.download_content(data, format="json")
-```
-
-### 5. Manage Zones
-
-```python
-# List all active zones
-zones = client.list_zones()
-print(f"Found {len(zones)} zones")
+client.download_content(data, "results.json", "json") # Auto-generate filename if not specified
 ```
 
 ## Configuration
@@ -125,7 +114,6 @@ Create a `.env` file in your project root:
 ```env
 BRIGHTDATA_API_TOKEN=your_bright_data_api_token
 WEB_UNLOCKER_ZONE=your_web_unlocker_zone  # Optional
-BROWSER_ZONE=your_browser_zone            # Optional  
 SERP_ZONE=your_serp_zone                 # Optional
 ```
 
@@ -136,31 +124,33 @@ client = bdclient(
     api_token="your_token",
     auto_create_zones=True,           # Automatically create missing zones
     web_unlocker_zone="custom_zone",  # Custom zone name
-    browser_zone="custom_browser"     # Custom browser zone
 )
 ```
+### Manage Zones
+
+```python
+# List all active zones
+zones = client.list_zones()
+print(f"Found {len(zones)} zones")
+```
 
 ## API Reference
 
 ### bdclient Class
 
-#### Constructor
-
 ```python
 bdclient(
     api_token: str = None,
     auto_create_zones: bool = True,
     web_unlocker_zone: str = None,
-    browser_zone: str = None
 )
 ```
 
-#### Methods
-
-**scrape(url, zone=None, format="json", method="GET", country="us", data_format="markdown", async_request=False, max_workers=None, timeout=None)**
-
-Scrape websites using Bright Data Web Unlocker API.
+### Key Methods
 
+#### scrape(...)
+Scrapes a single URL or list of URLs using the Web Unlocker.
+```python
 - `url`: Single URL string or list of URLs
 - `zone`: Zone identifier (auto-configured if None)
 - `format`: "json" or "raw"
@@ -170,31 +160,32 @@ Scrape websites using Bright Data Web Unlocker API.
 - `async_request`: Enable async processing
 - `max_workers`: Max parallel workers (default: 10)
 - `timeout`: Request timeout in seconds (default: 30)
+```
 
-**search(query, search_engine="google", zone=None, format="json", method="GET", country="us", data_format="markdown", async_request=False, max_workers=None, timeout=None)**
-
-Search using Bright Data SERP API.
-
+#### search(...)
+Searches using the SERP API. Accepts the same arguments as scrape(), plus:
+```python
 - `query`: Search query string or list of queries
 - `search_engine`: "google", "bing", or "yandex"
 - Other parameters same as scrape()
+```
 
-**download_content(content, filename=None, format="json")**
+#### download_content(...)
 
 Save content to local file.
-
+```python
 - `content`: Content to save
 - `filename`: Output filename (auto-generated if None)
 - `format`: File format ("json", "csv", "txt", etc.)
+```
 
-**list_zones()**
+#### list_zones()
 
 List all active zones in your Bright Data account.
 
 ## Error Handling
 
-The SDK includes comprehensive error handling:
-
+The SDK includes built-in input validation and retry logic:
 ```python
 try:
     result = client.scrape("https://example.com")
@@ -214,33 +205,24 @@ except Exception as e:
 
 ## Configuration Constants
 
-The SDK uses the following default values (configurable):
-
-- `DEFAULT_MAX_WORKERS`: 10 parallel workers
-- `DEFAULT_TIMEOUT`: 30 seconds request timeout
-- `CONNECTION_POOL_SIZE`: 20 HTTP connections
-- `MAX_RETRIES`: 3 retry attempts
-- `RETRY_BACKOFF_FACTOR`: 1.5x exponential backoff
+| Constant               | Default | Description                     |
+| ---------------------- | ------- | ------------------------------- |
+| `DEFAULT_MAX_WORKERS`  | `10`    | Max parallel tasks              |
+| `DEFAULT_TIMEOUT`      | `30`    | Request timeout (in seconds)    |
+| `CONNECTION_POOL_SIZE` | `20`    | Max concurrent HTTP connections |
+| `MAX_RETRIES`          | `3`     | Retry attempts on failure       |
+| `RETRY_BACKOFF_FACTOR` | `1.5`   | Exponential backoff multiplier  |
 
 ## Getting Your API Token
 
-1. Sign up at [brightdata.com](https://brightdata.com/)
-2. Navigate to your dashboard
-3. Create or access your API credentials
-4. Copy your API token
-
-## Requirements
-
-- Python 3.7+
-- `requests` library
-- `python-dotenv` (optional, for .env file support)
+1. Sign up at [brightdata.com](https://brightdata.com/), and navigate to your dashboard
+2. Create or access your API credentials
+3. Copy your API token and paste it in your .env or code file
 
 ## License
 
 This project is licensed under the MIT License.
 
 ## Support
 
-For issues related to the Bright Data service, contact [Bright Data support](https://brightdata.com/support).
-
-For SDK-related issues, please open an issue in this repository.
+For any issues, contact [Bright Data support](https://brightdata.com/contact), or open an issue in this repository.