serpapi-webhooks-events

# SerpApi Webhooks & Events ## Overview SerpApi does not have traditional webhooks, but supports async searches and the Searches Archive API. Build SERP monitoring by combining scheduled searches with change detection. Common use case: track keyword rankings over time. ## Instructions ### Step 1: Async Search with Polling ```python import serpapi, os, time client = serpapi.Client(api_key=os.environ["SERPAPI_API_KEY"]) # Submit async search (returns immediately) result = client.search(engine="google", q="your keyword", async_search=True) search_id = result["search_metadata"]["id"] print(f"Submitted: {search_id}") # Poll for completion while True: archived = client.search(engine="google", search_id=search_id) status = archived["search_metadata"]["status"] if status == "Success": break elif status == "Error": raise Exception(f"Search failed: {archived.get('error')}") time.sleep(2) print(f"Results: {len(archived.get('organic_results', []))}") ``` ### Step 2: SERP Monitoring Pipeline ```python import json, hashlib from datetime import datetime class SerpMonitor: def __init__(self, client, db): self.client = client self.db = db def track_keyword(self, keyword: str, domain: str): """Track a domain's ranking position for a keyword.""" result = self.client.search(engine="google", q=keyword, num=100) organic = result.get("organic_results", []) position = None for r in organ...