Update README.md

Author: Idanvilenski

README.md

@@ -3,8 +3,7 @@
 
 <h3 align="center">A Python SDK for the Bright Data's Data extraction and Web unlocking tools, providing easy-to-use scalable methods for web scraping, web searches and more.</h3>
 
-
-For a quick start you can try to run our example files in this repositories under the "Codespace" section.
+For a quick start run this repo's example files "Codespace" section.
 
 ## Features
 
@@ -18,58 +17,37 @@ For a quick start you can try to run our example files in this repositories unde
 
 ## Installation
 To install the package, open your terminal:
-> [!NOTE]
-> If you are using macOS you will need to open a virtual environment for your project first.
 
-```bash
+```python
 pip install brightdata-sdk
+# If using macOS, first open a virtual environment for your project.
 ```
 
 ## Quick Start
 
+Create a [Bright Data](https://brightdata.com/) account and copy your API key
+
 ### 1. Initialize the Client
-> [!IMPORTANT]
-> Go to your [**account settings**](https://brightdata.com/cp/setting/users), to verify that your API key have **"admin permissions"**.
 
 ```python
 from brightdata import bdclient
 
 client = bdclient(api_token="your_api_token_here") # can also be defined as BRIGHTDATA_API_TOKEN in your .env file
 ```
 
-Or you can use a custom zone name
+Or you can configure a custom zone name
+
 ```python
 client = bdclient(
     api_token="your_token",
     auto_create_zones=False,          # Else it creates the Zone automatically
-    web_unlocker_zone="custom_zone",  # Custom zone name for web scraping
-    serp_zone="custom_serp_zone"      # Custom zone name for search requests
+    web_unlocker_zone="custom_zone",
+    serp_zone="custom_serp_zone"
 )
-```
-> [!TIP]
-> Hover over the "bdclient" (or over each function in the package) with your cursor to see all its available parameters.
-
 
-### 2. Scrape Websites
-
-```python
-# Single URL
-result = client.scrape("https://example.com")
-
-# Multiple URLs (parallel processing)
-urls = ["https://example1.com", "https://example2.com", "https://example3.com"]
-results = client.scrape(urls)
-
-# Custom options
-result = client.scrape(
-    "https://example.com",
-    format="raw",
-    country="gb",
-    data_format="screenshot"
-)
 ```
 
-### 3. Search Engine Results
+### 2. Search Engine Results
 
 ```python
 # Single search query
@@ -90,6 +68,30 @@ results = client.search(
 )
 ```
 
+> [!TIP]
+> Hover over the "search" or each function in the package, to see all its available parameters.
+
+![Hover-Over1](https://github.com/user-attachments/assets/51324485-5769-48d5-8f13-0b534385142e)
+
+### 3. Scrape Websites
+
+```python
+# Single URL
+result = client.scrape("https://example.com")
+
+# Multiple URLs (parallel processing)
+urls = ["https://example1.com", "https://example2.com", "https://example3.com"]
+results = client.scrape(urls)
+
+# Custom options
+result = client.scrape(
+    "https://example.com",
+    format="raw",
+    country="gb",
+    data_format="screenshot"
+)
+```
+
 ### 4. Download Content
 
 ```python
@@ -216,6 +218,9 @@ cd bright-data-sdk-python
 pip install .
 ```
 
+> [!IMPORTANT]
+> Go to your [**account settings**](https://brightdata.com/cp/setting/users), to verify that your API key have **"admin permissions"**.
+
 ## License
 
 This project is licensed under the MIT License.