recipes
Serp Monitoring

Recipe: SERP Monitoring

Track how a keyword's Google search result page changes — top organic listing, AI Overview, featured snippet — and get notified the moment any of them shift.

curl -X POST https://api.verid.dev/v1/monitors \
  -H "Authorization: Bearer $VERID_API_KEY" \
  -d '{
    "name": "SERP — best invoicing software",
    "url": "https://www.google.com/search?q=best+invoicing+software&hl=en&gl=us&pws=0",
    "fetch_mode": "browser",
    "schedule_interval_seconds": 1800,
    "extract_config": {
      "method": "xpath",
      "fields": {
        "top_result_title":  "(//div[@id=\"search\"]//h3)[1]",
        "top_result_url":    "(//div[@id=\"search\"]//a[h3])[1]/@href",
        "ai_overview":       "//div[contains(@aria-label,\"AI Overview\")]",
        "featured_snippet":  "//div[@data-attrid=\"wa:/description\"]"
      }
    },
    "diff_predicate": { "type": "any_field_changes" },
    "deliveries": [
      { "type": "webhook", "url": "https://your-app.com/hooks/serp-shift" }
    ]
  }'

Notes:

  • fetch_mode: "browser" is required — Google's results are JavaScript-rendered.
  • Pin hl, gl, and pws=0 in the URL so personalization can't introduce noise.
  • Selectors evolve when Google ships layout changes; expect to update them occasionally.
  • For high-frequency or geo-specific tracking, configure the residential proxy layer so layer-3 fallback can route requests from the right region.
Price Drop AlertSitemap Monitor