chore: improve examples and test search requests

Author: adarshdigievo

README.md

@@ -196,7 +196,7 @@ import serpapi
 client = serpapi.Client(api_key=os.getenv("API_KEY"))
 results = client.search({
     'engine': 'home_depot',
-    'q': 'table',
+    'q': 'chair',
 })
 ```
 - API Documentation: [serpapi.com/home-depot-search-api](https://serpapi.com/home-depot-search-api)
@@ -363,7 +363,7 @@ import serpapi
 client = serpapi.Client(api_key=os.getenv("API_KEY"))
 results = client.search({
     'engine': 'google_jobs',
-    'q': 'coffee',
+    'q': 'software engineer',
 })
 ```
 - API Documentation: [serpapi.com/google-jobs-api](https://serpapi.com/google-jobs-api)

docs/examples/google-shopping-price-monitoring.md

@@ -1,11 +1,11 @@
 ---
 title: "Google Shopping Price Monitoring"
-description: "Filter Google Shopping listings by price and read selected product fields."
+description: "Compare US espresso-machine listings within a budget."
 ---
 
 # Google Shopping Price Monitoring
 
-Filter Google Shopping listings by price to compare offers from different merchants. The example searches for espresso machines priced between 100 and 800 in the search's currency.
+Search Google Shopping for a De'Longhi Stilosa espresso machine in Austin, Texas, and compare offers priced from $100 to $200. The example filters the returned prices in Python using the numeric `extracted_price` field.
 
 ## Search Filtered Products
 
@@ -20,17 +20,17 @@ client = serpapi.Client(api_key=os.environ["SERPAPI_KEY"], timeout=20)
 
 results = client.search(
     engine="google_shopping",
-    q="espresso machine",
+    q="DeLonghi Stilosa espresso machine",
     location="Austin, Texas",
     gl="us",
     hl="en",
-    min_price=100,
-    max_price=800,
-    sort_by=1,
-    json_restrictor="shopping_results[].{title, price, source, rating, reviews, link}",
+    json_restrictor="error, shopping_results[].{title, price, extracted_price, source, rating, reviews, product_link}",
 )
 
-for product in results.get("shopping_results", [])[:5]:
+for product in results.get("shopping_results", []):
+    price = product.get("extracted_price")
+    if price is None or not 100 <= price <= 200:
+        continue
     print(product.get("title"))
     print(product.get("price"), product.get("source"))
     print(product.get("rating"), product.get("reviews"))
@@ -40,4 +40,4 @@ for product in results.get("shopping_results", [])[:5]:
 
 Read product listings from `shopping_results`. Useful fields include `title`, `product_id`, `price`, `extracted_price`, `source`, `rating`, `reviews`, `thumbnail`, `delivery`, `product_link`, and `serpapi_immersive_product_api`.
 
-Use `min_price`, `max_price`, `sort_by`, `free_shipping`, and `on_sale` to filter and order offers. To fetch more pages, use `serpapi_pagination.next` when it is present. The example limits response fields with `json_restrictor`. Include `serpapi_pagination` in that selector if you need pagination. See the [Google Shopping API documentation](https://serpapi.com/google-shopping-api) for the full parameter set.
+The example limits response fields with `json_restrictor` and keeps `error` so API errors remain visible. Use `extracted_price` for numeric comparisons and `price` for display. See the [Google Shopping API documentation](https://serpapi.com/google-shopping-api) for the full parameter set.

docs/examples/home-depot-product-search.md

@@ -20,7 +20,7 @@ client = serpapi.Client(api_key=os.environ["SERPAPI_KEY"], timeout=20)
 
 results = client.search(
     engine="home_depot",
-    q="table",
+    q="chair",
 )
 
 for product in results.get("products", [])[:5]:

tests/example_search_google_jobs_test.py

@@ -6,7 +6,7 @@
 def test_search_google_jobs(client):
   data = client.search({
       'engine': 'google_jobs',
-      'q': 'coffee',
+      'q': 'software engineer',
   })
   assert data.get('error') is None
   assert data['jobs_results']

tests/example_search_home_depot_test.py

@@ -7,7 +7,7 @@ def test_search_home_depot(client):
 
   data = client.search({
       'engine': 'home_depot',
-      'q': 'table',
+      'q': 'chair',
   })
   assert data.get('error') is None
   assert data['products']