feat: move to static docs site using great-docs package

Author: adarshdigievo

docs/examples/11-amazon-product-search.md

@@ -0,0 +1,35 @@
+---
+title: "Amazon Product Search"
+description: "Search Amazon products and read price, rating, delivery, and product identifiers."
+---
+
+# Amazon Product Search
+
+Use the Amazon Search API when you need product listings, prices, ratings, delivery details, sponsored products, or Amazon product identifiers. The Amazon engine uses `k` for the search query.
+
+## Search Products
+
+```python
+import os
+import serpapi
+
+
+client = serpapi.Client(api_key=os.environ["SERPAPI_KEY"], timeout=20)
+
+results = client.search(
+    engine="amazon",
+    k="coffee grinder",
+    amazon_domain="amazon.com",
+)
+
+for product in results.get("organic_results", [])[:5]:
+    print(product.get("title"))
+    print(product.get("price"), product.get("rating"), product.get("reviews"))
+    print(product.get("asin"), product.get("link_clean"))
+```
+
+## What to Read
+
+Start with `organic_results` for product cards. Useful fields include `title`, `asin`, `price`, `extracted_price`, `rating`, `reviews`, `thumbnail`, `delivery`, `prime`, `link_clean`, and `serpapi_link`. Some searches also return `product_ads`, `featured_products`, `video_results`, `filters`, and `related_searches`.
+
+For localization, sorting, category nodes, and Amazon-specific filters, see the [Amazon Search API documentation](https://serpapi.com/amazon-search-api). Use the [SerpApi Playground](https://serpapi.com/playground) to inspect result shapes for the product category you care about.

docs/examples/12-walmart-product-search.md

@@ -0,0 +1,36 @@
+---
+title: "Walmart Product Search"
+description: "Search Walmart products and read pricing, reviews, shipping, and product IDs."
+---
+
+# Walmart Product Search
+
+Use the Walmart Search API for product search, price monitoring, catalog enrichment, and availability checks. Walmart uses `query` instead of `q`.
+
+## Search Products
+
+```python
+import os
+import serpapi
+
+
+client = serpapi.Client(api_key=os.environ["SERPAPI_KEY"], timeout=20)
+
+results = client.search(
+    engine="walmart",
+    query="coffee maker",
+    walmart_domain="walmart.com",
+)
+
+for product in results.get("organic_results", [])[:5]:
+    offer = product.get("primary_offer", {})
+    print(product.get("title"))
+    print(offer.get("offer_price"), product.get("rating"), product.get("reviews"))
+    print(product.get("us_item_id"), product.get("product_page_url"))
+```
+
+## What to Read
+
+Start with `organic_results`. Useful fields include `title`, `us_item_id`, `product_id`, `rating`, `reviews`, `seller_name`, `primary_offer.offer_price`, `price_per_unit`, `out_of_stock`, `product_page_url`, and `serpapi_product_page_url`.
+
+Use `sort`, `min_price`, `max_price`, `store_id`, and `facet` when you need more targeted product monitoring. See the [Walmart Search API documentation](https://serpapi.com/walmart-search-api) for supported filters and pagination behavior.

docs/examples/13-tripadvisor-travel-search.md

@@ -0,0 +1,35 @@
+---
+title: "Tripadvisor Travel Search"
+description: "Search Tripadvisor places, hotels, restaurants, and attractions."
+---
+
+# Tripadvisor Travel Search
+
+Use the Tripadvisor Search API when you need destination, hotel, restaurant, attraction, or forum search results from Tripadvisor. The `ssrc` parameter narrows the search to a result type such as hotels, restaurants, or things to do.
+
+## Search Places
+
+```python
+import os
+import serpapi
+
+
+client = serpapi.Client(api_key=os.environ["SERPAPI_KEY"], timeout=20)
+
+results = client.search(
+    engine="tripadvisor",
+    q="Rome",
+    ssrc="h",
+)
+
+for place in results.get("places", [])[:5]:
+    print(place.get("title"))
+    print(place.get("place_type"), place.get("location"))
+    print(place.get("link"))
+```
+
+## What to Read
+
+Start with `places`. Useful fields include `title`, `place_type`, `place_id`, `location`, `description`, `thumbnail`, `link`, and `serpapi_link`.
+
+Use `ssrc` to focus the search: `h` for hotels, `r` for restaurants, `A` for things to do, `g` for destinations, and `a` for all results. See the [Tripadvisor Search API documentation](https://serpapi.com/tripadvisor-search-api) for the current filter and pagination options.

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

@@ -0,0 +1,41 @@
+---
+title: "Google Shopping Price Monitoring"
+description: "Filter Google Shopping results by price and read product cards for monitoring workflows."
+---
+
+# Google Shopping Price Monitoring
+
+Use the Google Shopping API when you need product cards from many merchants. For price monitoring, combine query, market, price filters, and selected result fields.
+
+## Search Filtered Products
+
+```python
+import os
+import serpapi
+
+
+client = serpapi.Client(api_key=os.environ["SERPAPI_KEY"], timeout=20)
+
+results = client.search(
+    engine="google_shopping",
+    q="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}",
+)
+
+for product in results.get("shopping_results", [])[:5]:
+    print(product.get("title"))
+    print(product.get("price"), product.get("source"))
+    print(product.get("rating"), product.get("reviews"))
+```
+
+## What to Read
+
+Start with `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` for monitoring workflows. For pagination, prefer `serpapi_pagination.next` over hand-built offsets when it is present. See the [Google Shopping API documentation](https://serpapi.com/google-shopping-api) for the full parameter set.

docs/examples/15-duckduckgo-search.md

@@ -0,0 +1,33 @@
+---
+title: "DuckDuckGo Search"
+description: "Run a DuckDuckGo search and read organic result fields."
+---
+
+# DuckDuckGo Search
+
+Use the DuckDuckGo Search API when you need another privacy-oriented web result source alongside Google and Bing. Start with a simple query, then add region and time filters when your workflow needs them.
+
+## Search DuckDuckGo
+
+```python
+import os
+import serpapi
+
+
+client = serpapi.Client(api_key=os.environ["SERPAPI_KEY"], timeout=20)
+
+results = client.search(
+    engine="duckduckgo",
+    q="coffee",
+)
+
+for result in results.get("organic_results", [])[:5]:
+    print(result.get("position"), result.get("title"))
+    print(result.get("link"))
+```
+
+## What to Read
+
+Most workflows start with `organic_results`. Useful fields include `title`, `link`, `snippet`, `position`, and any rich result blocks returned for the query.
+
+See the [DuckDuckGo Search API documentation](https://serpapi.com/duckduckgo-search-api) for region, date, and safe-search options.

docs/examples/16-baidu-search.md

@@ -0,0 +1,33 @@
+---
+title: "Baidu Search"
+description: "Search Baidu results for China-focused research workflows."
+---
+
+# Baidu Search
+
+Use the Baidu Search API when your application needs results from Baidu's web index. It is useful for China-focused SEO checks, market research, and search result monitoring.
+
+## Search Baidu
+
+```python
+import os
+import serpapi
+
+
+client = serpapi.Client(api_key=os.environ["SERPAPI_KEY"], timeout=20)
+
+results = client.search(
+    engine="baidu",
+    q="coffee",
+)
+
+for result in results.get("organic_results", [])[:5]:
+    print(result.get("position"), result.get("title"))
+    print(result.get("link"))
+```
+
+## What to Read
+
+Start with `organic_results`, then inspect any top-level result blocks returned by the query. Baidu result shapes can vary by keyword, so store only fields you have observed in sample responses.
+
+See the [Baidu Search API documentation](https://serpapi.com/baidu-search-api) for supported filters.

docs/examples/17-google-local-services.md

@@ -0,0 +1,35 @@
+---
+title: "Google Local Services"
+description: "Read Google Local Services ad cards for a service category."
+---
+
+# Google Local Services
+
+Use the Google Local Services API when you need local services ad data for a category, provider, or market. It returns ad cards rather than general Google Maps place results.
+
+## Search Local Services
+
+```python
+import os
+import serpapi
+
+
+client = serpapi.Client(api_key=os.environ["SERPAPI_KEY"], timeout=20)
+
+results = client.search(
+    engine="google_local_services",
+    q="electrician",
+    data_cid="6745062158417646970",
+)
+
+for ad in results.get("local_ads", [])[:5]:
+    print(ad.get("title"))
+    print(ad.get("rating"), ad.get("reviews"))
+    print(ad.get("phone"))
+```
+
+## What to Read
+
+Start with `local_ads`. Useful fields include `title`, `rating`, `reviews`, `phone`, `service_area`, `years_in_business`, and `link` when present.
+
+See the [Google Local Services API documentation](https://serpapi.com/google-local-services-api) for query and provider detail options.

docs/examples/18-ebay-product-listings.md

@@ -0,0 +1,34 @@
+---
+title: "eBay Product Listings"
+description: "Search eBay listings and read product, price, and seller fields."
+---
+
+# eBay Product Listings
+
+Use the eBay Search API when you need marketplace listings, prices, condition data, or seller result pages. eBay uses `_nkw` for the search keyword.
+
+## Search eBay
+
+```python
+import os
+import serpapi
+
+
+client = serpapi.Client(api_key=os.environ["SERPAPI_KEY"], timeout=20)
+
+results = client.search(
+    engine="ebay",
+    _nkw="coffee",
+)
+
+for listing in results.get("organic_results", [])[:5]:
+    print(listing.get("title"))
+    print(listing.get("price"), listing.get("condition"))
+    print(listing.get("link"))
+```
+
+## What to Read
+
+Start with `organic_results`. Useful fields include `title`, `price`, `condition`, `shipping`, `location`, `seller`, `thumbnail`, and `link`.
+
+See the [eBay Search API documentation](https://serpapi.com/ebay-search-api) for filters, sorting, and pagination.

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

@@ -0,0 +1,34 @@
+---
+title: "Home Depot Product Search"
+description: "Search Home Depot product cards and read price, rating, and product identifiers."
+---
+
+# Home Depot Product Search
+
+Use The Home Depot Search API for home improvement product discovery, price tracking, and catalog enrichment. Start with a broad query and then add filters once you know the category shape.
+
+## Search Products
+
+```python
+import os
+import serpapi
+
+
+client = serpapi.Client(api_key=os.environ["SERPAPI_KEY"], timeout=20)
+
+results = client.search(
+    engine="home_depot",
+    q="table",
+)
+
+for product in results.get("products", [])[:5]:
+    print(product.get("title"))
+    print(product.get("price"), product.get("rating"))
+    print(product.get("product_id"))
+```
+
+## What to Read
+
+Start with `products`. Useful fields include `title`, `product_id`, `price`, `rating`, `reviews`, `brand`, `thumbnail`, and product URLs when present.
+
+See the [The Home Depot Search API documentation](https://serpapi.com/home-depot-search-api) for product filters and pagination.

docs/examples/20-google-events-discovery.md

@@ -0,0 +1,34 @@
+---
+title: "Google Events Discovery"
+description: "Search Google Events for upcoming event cards."
+---
+
+# Google Events Discovery
+
+Use the Google Events API when you need event cards for a topic, venue, or local market. It returns event-specific metadata instead of general organic search results.
+
+## Search Events
+
+```python
+import os
+import serpapi
+
+
+client = serpapi.Client(api_key=os.environ["SERPAPI_KEY"], timeout=20)
+
+results = client.search(
+    engine="google_events",
+    q="coffee",
+)
+
+for event in results.get("events_results", [])[:5]:
+    print(event.get("title"))
+    print(event.get("date", {}).get("when"))
+    print(event.get("address"))
+```
+
+## What to Read
+
+Start with `events_results`. Useful fields include `title`, `date`, `address`, `link`, `ticket_info`, `venue`, and `description` when present.
+
+See the [Google Events API documentation](https://serpapi.com/google-events-api) for date and location parameters.