Getting Started with SEOScanHQ

Getting Started

SEOScanHQ helps you understand how AI search engines view your website. Follow these three steps to run your first scan:

Scan Categories

SEOScanHQ organizes its checks into 6 categories. Each category covers a distinct aspect of AI search readiness.

For in-depth information about what AI search engines look for in each category, read our AI SEO Guide.

Understanding Scores

Your AI readiness score is calculated on a 0-100 scale. Here is how it works:

Overall Score

Your overall score is a weighted average of your 6 category scores. The weights reflect each category's relative importance for AI search visibility:

Score Ranges

Plans & Limits

SEOScanHQ offers three plans to fit different needs. All plans include access to the same scan engine -- the difference is in the number of checks and features available.

See the full feature comparison on our Pricing page.

API Reference

The SEOScanHQ API allows Pro plan users to programmatically trigger scans and retrieve results. This is ideal for agencies managing multiple client sites, CI/CD pipelines, or building custom integrations.

Quick Start

1. 1

   Generate an API key

   Navigate to Settings > API Keys in your dashboard or visit the API Keys page.

2. 2

   Trigger a scan

   Send a POST request to /api/scan with your URL and API key.

3. 3

   Retrieve results

   Poll the scan status endpoint or use webhooks to receive results when the scan completes.

Example: Trigger a Scan

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

Example: Retrieve Results

curl https://seoscanhq.com/api/scan/SCAN_ID \
  -H "Authorization: Bearer YOUR_API_KEY"

# Response
{
  "id": "scan_abc123",
  "url": "https://example.com",
  "status": "completed",
  "score": 78,
  "categories": {
    "ai_crawlers": { "score": 92, "passed": 11, "total": 13 },
    "ai_readability": { "score": 60, "passed": 3, "total": 6 },
    "structured_data": { "score": 80, "passed": 8, "total": 10 },
    ...
  }
}

Frequently Asked Questions