Skip to main content

Get Audit Analytics

GET /api/v1/analytics/audit/{audit_id} Returns comprehensive analytics for a completed audit.
curl -X GET https://api.latentgeo.com/api/v1/analytics/audit/123 \
  -H "Authorization: Bearer YOUR_TOKEN"
{
  "audit_id": 123,
  "domain": "example.com",
  "total_pages": 25,
  "is_ymyl": false,
  "category": "blog",
  "issues": {
    "critical": 3,
    "high": 8,
    "medium": 15,
    "low": 22,
    "total": 48
  },
  "scores": {
    "h1_score": 7.5,
    "structure_score": 8.2,
    "content_score": 6.8,
    "eeat_score": 7.1,
    "schema_score": 5.4,
    "overall_score": 7.0
  },
  "pages": [
    {
      "url": "https://example.com/blog/post-1",
      "path": "/blog/post-1",
      "overall_score": 7.5,
      "issues": {
        "critical": 0,
        "high": 2,
        "medium": 3,
        "low": 5
      }
    }
  ]
}
audit_id
integer
Audit ID
domain
string
Domain name
total_pages
integer
Number of pages analyzed
issues
object
Issue counts by severity level
scores
object
Average scores across all pages
pages
array
Per-page analytics data

Get Competitor Analysis

GET /api/v1/analytics/competitors/{audit_id} Returns competitive analysis comparing your site against competitors.
audit_id
integer
Audit ID
total_competitors
integer
Number of competitors analyzed
your_geo_score
number
Your GEO optimization score
average_competitor_score
number
Average competitor GEO score
position
string
Position relative to competitors
competitors
array
Competitor details sorted by GEO score
identified_gaps
array
Top gaps identified vs competitors

Get Dashboard Data

GET /api/v1/analytics/dashboard Returns overview statistics for the main dashboard.
summary
object
Overall statistics (total audits, success rate, etc.)
recent_audits
array
Most recent audits with status
metrics
object
Key metrics (unique domains, total issues)

Get Issues by Priority

GET /api/v1/analytics/issues/{audit_id} Returns issues grouped by priority level.
curl -X GET https://api.latentgeo.com/api/v1/analytics/issues/123 \
  -H "Authorization: Bearer YOUR_TOKEN"
{
  "audit_id": 123,
  "total_issues": 48,
  "by_priority": {
    "CRITICAL": [
      {
        "page_path": "/blog/post-1",
        "issue_code": "MISSING_TITLE",
        "description": "Page title is missing",
        "suggestion": "Add a descriptive title tag"
      }
    ],
    "HIGH": [],
    "MEDIUM": [],
    "LOW": []
  }
}
audit_id
integer
Audit ID
total_issues
integer
Total number of issues
by_priority
object
Issues grouped by priority (CRITICAL, HIGH, MEDIUM, LOW)

Error Codes

404
error
Audit or fix plan not found
500
error
Internal server error

Build docs developers (and LLMs) love