11. Dashboard API | SEO Forge - Rank Higher with AI-Powered SEO

Site-wide SEO statistics and content optimization endpoints.

GET /seoforge/v1/dashboard

Returns an aggregate view of all analyzed posts including score distribution, common issues, and content health metrics.

curl -u "admin:ABCD 1234 EFGH 5678 IJKL 9012" 
  https://example.com/wp-json/seoforge/v1/dashboard

Response (200 OK):

{
    "total_analyzed": 45,
    "avg_score": 68,
    "good": 12,
    "medium": 22,
    "bad": 11,
    "no_meta_description": 8,
    "top_issues": {
        "Meta description is missing": 8,
        "No focus keyword set": 15,
        "No internal links found": 6
    }
}

Score buckets: good = 80+, medium = 50-79, bad = below 50.

GET /seoforge/v1/ai-readiness/{post_id}

Analyze how well content is optimized for AI search engines (AEO). PRO only.

curl -u "admin:ABCD 1234 EFGH 5678 IJKL 9012" 
  https://example.com/wp-json/seoforge/v1/ai-readiness/42

Response (200 OK):

{
    "score": 75,
    "checks": [
        { "name": "Structured headings", "pass": true },
        { "name": "FAQ section present", "pass": false },
        { "name": "Clear definitions", "pass": true },
        { "name": "Schema markup", "pass": true }
    ],
    "suggestions": [
        "Add a FAQ section to improve AI discoverability.",
        "Include a concise summary paragraph at the top."
    ]
}

POST /seoforge/v1/optimize/{post_id}

Get AI-powered content optimization suggestions. PRO only.

curl -X POST -u "admin:ABCD 1234 EFGH 5678 IJKL 9012" 
  -H "Content-Type: application/json" 
  -d '{"force": true}' 
  https://example.com/wp-json/seoforge/v1/optimize/42

Response (200 OK):

{
    "success": true,
    "score_before": 55,
    "suggestions": [
        {
            "type": "add_faq",
            "priority": 1,
            "title": "Add FAQ Section",
            "description": "Adding a FAQ section would help capture featured snippets.",
            "example": "<h2>Frequently Asked Questions</h2>..."
        }
    ],
    "word_count": 850,
    "keyword": "wordpress seo"
}

Valid suggestion types: add_section, expand_section, add_table, update_data, improve_heading, add_faq, add_images, improve_intro, improve_conclusion, add_list

POST /seoforge/v1/optimize/apply/{post_id}

Apply a specific content optimization suggestion. PRO only.

curl -X POST -u "admin:ABCD 1234 EFGH 5678 IJKL 9012" 
  -H "Content-Type: application/json" 
  -d '{
    "type": "add_faq",
    "content": "<h2>FAQ</h2><h3>What is SEO?</h3><p>SEO stands for...</p>",
    "position": "before_end"
  }' 
  https://example.com/wp-json/seoforge/v1/optimize/apply/42

Position values: before_end (default), after_intro, before_conclusion

—