DataForSEO On-Page Auditor

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

---

Technical SEO audits using DataForSEO On-Page API. Crawl websites, analyze page content, find duplicate content, check links, and run waterfall analysis.

Features

• Technical SEO Audit: Check page speed, mobile-friendliness, SSL, redirects
• Content Analysis: Analyze word count, keyword density, readability
• Meta Tag Review: Evaluate titles, descriptions, Open Graph, Twitter cards
• Heading Structure: Check H1-H6 hierarchy and keyword usage
• Image Optimization: Find missing alt tags, oversized images
• Link Analysis: Internal/external link ratios, broken links
• Core Web Vitals: LCP, FID, CLS scores
• BYOK Pattern: 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
url	string	Yes	URL to audit
maxPages	number	No	Max pages to crawl (default: 10)
checkMobile	boolean	No	Include mobile audit (default: true)
dataForSeoLogin	string	Yes	Your DataForSEO API login
dataForSeoPassword	string	Yes	Your DataForSEO API password
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": {
    "url": "https://example.com",
    "score": 78,
    "issues": {
      "critical": 2,
      "warnings": 5,
      "notices": 12
    },
    "categories": {
      "technical": { "score": 85, "issues": [...] },
      "content": { "score": 72, "issues": [...] },
      "meta": { "score": 80, "issues": [...] },
      "performance": { "score": 75, "issues": [...] }
    },
    "coreWebVitals": {
      "lcp": 2.1,
      "fid": 45,
      "cls": 0.05
    },
    "recommendations": [
      "Add meta description to 3 pages",
      "Compress images to reduce load time",
      "Fix 2 broken internal links"
    ]
  }
}

Pricing

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

• onpage-audit: Per page audited

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