SERPApi Real-Time SERP Snapshots

What is SerpAPI?

SerpAPI provides real-time SERP (Search Engine Results Page) data from Google, Bing, Yahoo, and more. No proxy management or parsing required.

How to Get Your SerpAPI Key

1. Sign up at SerpAPI (free tier: 100 searches/month)
2. Go to Dashboard → API Key
3. Copy your API key
4. Paste it in the serpApiKey field

---

Real-time search engine results from Google, Bing, Yahoo, DuckDuckGo, and more using SERPApi. Get organic results, featured snippets, knowledge panels, and SERP features.

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

Quick Start

{
  "input": "your input here"
}

Demo Mode

Set demoMode: true to test with sample data (no charges). When you're ready for real results, set demoMode: false or omit it.

{
  "demoMode": true,
  ...
}

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)

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

This actor uses pay-per-event billing: Pay-per-event pricing:

• realtime-serp-snapshot: Per SERP snapshot

Use Cases

• Data collection
• Research
• Automation

---

Common Problems & Solutions

"Invalid API key" error

Cause: Your API key is wrong, expired, or doesn't have the right permissions. Fix: Double-check your API key. Make sure you copied it exactly without extra spaces.

"Rate limit exceeded" error

Cause: You've hit the API's rate limits. Fix: Wait a few minutes, then try again. Consider reducing the number of concurrent requests.

Empty or incomplete results

Cause: The target may have anti-scraping protection or the data doesn't exist. Fix:

• Check if the URL/search query is correct
• Try with different parameters
• Some sites may block automated access

Demo data showing instead of real results

Cause: demoMode is still set to true. Fix: Set demoMode: false and provide your API key(s).

---

Built by John Rippy | Actor Arsenal