API Documentation

Complete reference for the AuditAPI Pro SEO audit API.

Overview

AuditAPI Pro performs comprehensive SEO audits on any publicly accessible URL. Submit a URL, get back a detailed analysis with scores, issues, and recommendations.

Base URL: https://auditapi.pro

Authentication

All API requests require an API key. Get one free.

HEADER

X-API-Key: your_api_key_here

HEADER

Authorization: Bearer your_api_key_here

POST PARAM

api_key=your_api_key_here

SEO Audit Endpoint

POST /ultimate-seo-audit.php

Full SEO audit on any URL.

Parameters

Param	Type	Required	Description
`url`	string	Yes	URL to audit
`api_key`	string	No*	Alternative to header

* Not needed if using header auth.

Auth API

POST /mysql-api.php

Registration, login, API key management.

action=register

Params: email, password, password2

action=login

Params: email, password

action=me

Get current user (session required)

action=create_api_key

Params: label (optional)

action=list_api_keys

List all API keys for user

Response Format

All responses are JSON. Successful audit:

{
  "url": "https://example.com",
  "score": 72,
  "rating": "Good",
  "issues_count": 5,
  "issues": ["Missing meta description", ...],
  "recommendations": ["Add meta description", ...],
  "details": {
    "title": "Example Domain",
    "meta_description": "",
    "word_count": 128,
    "page_size_kb": 1.2,
    "headings": {"h1":1,"h2":0,"h3":0},
    "has_ssl": true,
    "has_robots_txt": false,
    "has_sitemap": false,
    "has_viewport": true,
    "has_lang": true,
    "has_favicon": false,
    "has_canonical": false,
    "has_structured_data": false,
    "images_total": 0,
    "images_missing_alt": 0,
    "og_tags": {},
    "twitter_tags": {}
  },
  "meta": {
    "api_version": "1.0",
    "requested_url": "https://example.com",
    "http_code": 200
  }
}
                    

Error Codes

Code	Error	Description
400	`url_required`	URL missing
400	`invalid_url`	Bad URL format
401	`api_key_required`	No API key
401	`invalid_api_key`	Bad API key
429	`monthly_limit_exceeded`	Monthly limit hit
429	`trial_limit_reached`	Free trial limit (3/day)
502	`fetch_failed`	Cannot fetch URL
500	`internal_server_error`	Server error

Code Examples

curl

curl -X POST https://auditapi.pro/ultimate-seo-audit.php \
  -H "X-API-Key: your_api_key_here" \
  -d "url=https://example.com"
                    

JavaScript

fetch('https://auditapi.pro/ultimate-seo-audit.php', {
  method: 'POST',
  headers: {'X-API-Key': 'your_api_key_here'},
  body: 'url=https://example.com'
}).then(r => r.json()).then(console.log);
                    

Python

import requests
r = requests.post(
  'https://auditapi.pro/ultimate-seo-audit.php',
  headers={'X-API-Key': 'your_api_key_here'},
  data={'url': 'https://example.com'}
)
print(r.json()['score'], r.json()['rating'])
                    

PHP

$ch = curl_init('https://auditapi.pro/ultimate-seo-audit.php');
curl_setopt_array($ch, [
  CURLOPT_POST => true,
  CURLOPT_POSTFIELDS => 'url=https://example.com',
  CURLOPT_HTTPHEADER => ['X-API-Key: your_api_key_here'],
  CURLOPT_RETURNTRANSFER => true,
]);
$data = json_decode(curl_exec($ch), true);
echo $data['score'];
                    

Rate Limits

Tier	Limit	Reset
Free Trial (no account)	3 audits/day	24h
Free Account	1,000 audits/month	Monthly

CORS

All endpoints support CORS with Access-Control-Allow-Origin: *. Preflight OPTIONS requests are handled automatically.