Add sync and async batch-fetch usage examples

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

Author: cursoragent

README.md

@@ -257,12 +257,14 @@ Contributor workflow details are available in [CONTRIBUTING.md](CONTRIBUTING.md)
 
 Ready-to-run examples are available in `examples/`:
 
+- `examples/async_batch_fetch.py`
 - `examples/async_crawl.py`
 - `examples/async_extract.py`
 - `examples/async_scrape.py`
 - `examples/async_session_list.py`
 - `examples/async_web_fetch.py`
 - `examples/async_web_search.py`
+- `examples/sync_batch_fetch.py`
 - `examples/sync_crawl.py`
 - `examples/sync_extract.py`
 - `examples/sync_scrape.py`

examples/async_batch_fetch.py

@@ -0,0 +1,38 @@
+"""
+Asynchronous batch fetch example.
+
+Run:
+    export HYPERBROWSER_API_KEY="your_api_key"
+    python3 examples/async_batch_fetch.py
+"""
+
+import asyncio
+
+from hyperbrowser import AsyncHyperbrowser
+from hyperbrowser.exceptions import HyperbrowserTimeoutError
+from hyperbrowser.models import StartBatchFetchJobParams
+
+
+async def main() -> None:
+    async with AsyncHyperbrowser() as client:
+        try:
+            result = await client.web.batch_fetch.start_and_wait(
+                StartBatchFetchJobParams(
+                    urls=[
+                        "https://hyperbrowser.ai",
+                        "https://docs.hyperbrowser.ai",
+                    ],
+                ),
+                poll_interval_seconds=1.0,
+                max_wait_seconds=120.0,
+            )
+        except HyperbrowserTimeoutError:
+            print("Batch fetch job timed out.")
+            return
+
+        print(f"Status: {result.status}")
+        print(f"Fetched pages: {len(result.data or [])}")
+
+
+if __name__ == "__main__":
+    asyncio.run(main())

examples/sync_batch_fetch.py

@@ -0,0 +1,36 @@
+"""
+Synchronous batch fetch example.
+
+Run:
+    export HYPERBROWSER_API_KEY="your_api_key"
+    python3 examples/sync_batch_fetch.py
+"""
+
+from hyperbrowser import Hyperbrowser
+from hyperbrowser.exceptions import HyperbrowserTimeoutError
+from hyperbrowser.models import StartBatchFetchJobParams
+
+
+def main() -> None:
+    with Hyperbrowser() as client:
+        try:
+            result = client.web.batch_fetch.start_and_wait(
+                StartBatchFetchJobParams(
+                    urls=[
+                        "https://hyperbrowser.ai",
+                        "https://docs.hyperbrowser.ai",
+                    ],
+                ),
+                poll_interval_seconds=1.0,
+                max_wait_seconds=120.0,
+            )
+        except HyperbrowserTimeoutError:
+            print("Batch fetch job timed out.")
+            return
+
+        print(f"Status: {result.status}")
+        print(f"Fetched pages: {len(result.data or [])}")
+
+
+if __name__ == "__main__":
+    main()