API Documentation

Integrate SEO Snapshot into your workflow with our REST API.

POST/api/v1/analyze

Analyze a URL and get a full SEO report with score, issues, and recommendations.

Request

curl -X POST https://seosnapshot.dev/api/v1/analyze \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -d '{"url": "https://example.com"}'

Response

{
  "score": 72,
  "url": "https://example.com",
  "statusCode": 200,
  "fetchTime": 340,
  "issues": [
    {
      "severity": "critical",
      "problem": "Meta description is missing",
      "fix": "Add <meta name=\"description\" content=\"...\">",
      "category": "Meta",
      "impact": 15
    }
  ],
  "meta": { "title": {...}, "description": {...} },
  "security": { "grade": "B", "score": 73 },
  "techStack": [{ "name": "Next.js", "icon": "NX" }]
}

Rate Limits

Free (no API key)5/day

Pro (with API key)100/day

Lifetime500/day

Response Fields

scoreOverall SEO score 0-100

issues[]Array of detected issues with severity, problem, fix, category, impact

metaTitle, description, canonical, viewport, lang, favicon, doctype

securityGrade (A+ to F), score, headers, cookies, HTTPS

performanceTTFB, HTML size, scripts, stylesheets, render-blocking

techStack[]Detected technologies (WordPress, Next.js, etc)

categoryScoresPer-category scores: meta, technical, performance, security, content, social

potentialScoreEstimated score if all critical issues are fixed

Authentication

API key is optional for free-tier usage. Pro users get an API key from their dashboard.

Authorization: Bearer sk_live_...