Add synchronous web search usage example

Co-authored-by: Shri Sukhani <shrisukhani@users.noreply.github.com>

Author: cursoragent

README.md

@@ -259,6 +259,7 @@ Ready-to-run examples are available in `examples/`:
 
 - `examples/sync_scrape.py`
 - `examples/async_extract.py`
+- `examples/sync_web_search.py`
 
 ## License
 

examples/sync_web_search.py

@@ -0,0 +1,35 @@
+"""
+Example: synchronous web search with the Hyperbrowser SDK.
+
+Run:
+    export HYPERBROWSER_API_KEY="your_api_key"
+    python3 examples/sync_web_search.py
+"""
+
+from hyperbrowser import Hyperbrowser
+from hyperbrowser.models import WebSearchParams
+
+
+def main() -> None:
+    with Hyperbrowser() as client:
+        response = client.web.search(
+            WebSearchParams(
+                query="Hyperbrowser Python SDK",
+                page=1,
+            )
+        )
+
+        print(f"Job ID: {response.job_id}")
+        print(f"Status: {response.status}")
+
+        if not response.data:
+            print("No results returned.")
+            return
+
+        print(f"Query: {response.data.query}")
+        for index, result in enumerate(response.data.results[:5], start=1):
+            print(f"{index}. {result.title} -> {result.url}")
+
+
+if __name__ == "__main__":
+    main()