DataForSEO SERP Tracker

What is DataForSEO?

DataForSEO is an API provider for SERP data, backlinks, on-page SEO, and more. It's a cost-effective alternative to SEMrush/Ahrefs APIs.

How to Get Your DataForSEO API Key

1. Sign up at DataForSEO (free trial available)
2. Go to Dashboard → API Access
3. Copy your login and password
4. Use them as dataforSeoLogin and dataforSeoPassword

---

Track keyword rankings, analyze SERPs, and perform keyword research using the DataForSEO API. Get organic results, featured snippets, people also ask, and more for any keyword.

Features

• Live SERP Analysis: Real-time search results from Google, Bing, Yahoo
• Keyword Research: Suggestions, ideas, and search volume data
• Ranked Keywords: Find what keywords a domain ranks for
• Competitor Analysis: Discover competing domains
• Multi-Device: Desktop and mobile SERP data
• BYOK: Bring your own DataForSEO API credentials

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
See input schema

Output Format

SERP Results

{
  "keyword": "best digital marketing agency",
  "location": "United States",
  "searchEngine": "google",
  "organicResults": [
    {
      "position": 1,
      "url": "https://example.com",
      "domain": "example.com",
      "title": "Top Digital Marketing Agency",
      "description": "Award-winning agency..."
    }
  ],
  "organicCount": 10,
  "featuredSnippet": {
    "type": "paragraph",
    "title": "What makes a great agency?",
    "description": "..."
  },
  "peopleAlsoAsk": ["What services do agencies offer?"],
  "totalResults": 1240000000,
  "scannedAt": "2024-01-15T10:30:00.000Z"
}

Keyword Data

{
  "keyword": "digital marketing agency",
  "searchVolume": 33100,
  "cpc": 15.42,
  "competition": 0.87,
  "competitionLevel": "HIGH",
  "trend": [100, 95, 98, 102, 110, 108, 115, 120, 118, 125, 130, 128]
}

Pricing

This actor uses pay-per-event billing:

Event	Cost
serp-query	$0.005
keyword-research	$0.05
competitor-analysis	$0.10

Plus DataForSEO API costs (BYOK)

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