SERPApi Real-Time SERP

Get real-time Google SERP snapshots with rich result extraction using SERPApi.

Built by John Rippy | johnrippy.link

---

Overview

This actor provides instant, real-time Google SERP snapshots powered by SERPApi. See exactly what appears on the search results page including organic results, local pack, featured snippets, People Also Ask, and more.

Features

• Real-Time Results: Get current SERP state instantly
• Rich Result Extraction: Capture featured snippets, local pack, PAA, knowledge panels
• Location Targeting: Get results for any city, state, or country
• Device Selection: Desktop or mobile SERPs
• Multiple Engines: Google, Bing, Yahoo, DuckDuckGo
• Image Results: Extract Google Images results
• News Results: Extract Google News results
• BYOK Pattern: Bring your own SERPApi key

Input Parameters

Parameter	Type	Required	Description
query	string	Yes	Search query
location	string	No	Geographic location (e.g., "Saint Louis, MO")
engine	string	No	Search engine: google, bing, yahoo (default: google)
device	string	No	Device type: desktop or mobile (default: desktop)
resultType	string	No	Type: search, images, news, maps (default: search)
num	number	No	Number of results (default: 10, max: 100)
serpApiKey	string	Yes	Your SERPApi key
webhookUrl	string	No	URL to receive results when complete
demoMode	boolean	No	Run with sample data (no API calls)

Example Usage

Basic SERP Snapshot

{
  "query": "best marketing agency",
  "location": "New York, NY",
  "device": "desktop",
  "serpApiKey": "your-serpapi-key"
}

Mobile SERP with Local Pack

{
  "query": "plumber near me",
  "location": "Miami, FL",
  "device": "mobile",
  "num": 20,
  "serpApiKey": "your-serpapi-key"
}

Image Search

{
  "query": "modern office design",
  "resultType": "images",
  "num": 50,
  "serpApiKey": "your-serpapi-key"
}

Output Format

{
  "status": "success",
  "timestamp": "2025-12-28T12:00:00.000Z",
  "data": {
    "query": "best marketing agency",
    "location": "New York, NY",
    "device": "desktop",
    "searchInformation": {
      "totalResults": "1,450,000,000",
      "timeTaken": 0.42
    },
    "featuredSnippet": {
      "title": "Top Marketing Agencies",
      "content": "...",
      "source": "forbes.com"
    },
    "localPack": [
      {
        "position": 1,
        "name": "ABC Marketing",
        "rating": 4.8,
        "reviews": 156,
        "address": "123 Main St, NY"
      }
    ],
    "organicResults": [
      {
        "position": 1,
        "title": "10 Best Marketing Agencies in NYC",
        "link": "https://example.com/article",
        "snippet": "...",
        "sitelinks": [...]
      }
    ],
    "peopleAlsoAsk": [
      {
        "question": "How much does a marketing agency cost?",
        "answer": "..."
      }
    ],
    "relatedSearches": [
      "marketing agencies near me",
      "digital marketing services"
    ]
  }
}

Pricing

Pay-per-event pricing:

• realtime-serp-snapshot: Per SERP snapshot

Demo Mode

Set demoMode: true to test with sample data without consuming SERPApi credits.

Related Actors

Part of the SEO Intelligence Suite:

• localhowl~seo-intelligence-mcp-server - Unified MCP orchestrator
• localhowl~dataforseo-serp - SERP rankings and keyword research
• localhowl~dataforseo-onpage - On-page SEO audits
• localhowl~dataforseo-backlinks - Backlink analysis
• localhowl~localfalcon-grid - Local ranking grids

Support

• GitHub: Report issues
• LinkedIn: John Rippy
• Website: johnrippy.link