Audits

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/nicolasleiva/LatentGEO/llms.txt

Use this file to discover all available pages before exploring further.

​

Overview

​

Audit Creation Workflow

​

Starting an Audit

1. Submit URL: Provide the target website URL to analyze
2. Configure Settings: Specify language, market, and competitor domains
3. Automated Analysis: The platform automatically:
   • Crawls the website structure
   • Analyzes content and metadata
   • Evaluates schema markup
   • Compares against competitors
   • Generates actionable recommendations

​

Audit Statuses

• Pending: Audit created, waiting for configuration
• Running: Analysis in progress
• Completed: All analysis finished, results available
• Failed: Error occurred during processing

​

Audit Types

​

Technical SEO Audit

• HTML structure and heading hierarchy
• Meta tags and descriptions
• Schema.org markup
• Internal linking structure
• Mobile-friendliness
• Crawlability issues

​

GEO (Generative Engine Optimization) Audit

• Content structure for AI comprehension
• Citation-ready content blocks
• Authority signals and references
• FAQ schema implementation
• E-E-A-T (Experience, Expertise, Authoritativeness, Trust)

​

PageSpeed Analysis

• LCP (Largest Contentful Paint)
• INP (Interaction to Next Paint)
• CLS (Cumulative Layout Shift)
• Mobile and desktop strategies
• Optimization opportunities
• Diagnostics and best practices

​

Competitor Analysis

• GEO scores and rankings
• Content gap analysis
• Schema markup comparison
• Backlink profiles
• Citation visibility in LLMs

​

Audit Summary Data

{
  "id": 123,
  "url": "https://example.com",
  "status": "completed",
  "progress": 100,
  "domain": "example.com",
  "geo_score": 7.5,
  "total_pages": 45,
  "issues": {
    "critical": 3,
    "high": 8,
    "medium": 15,
    "low": 22
  },
  "scores": {
    "h1_score": 8.2,
    "structure_score": 7.5,
    "content_score": 6.8,
    "eeat_score": 7.0,
    "schema_score": 5.5,
    "overall_score": 7.0
  }
}

​

Pages Analysis

• H1 Score: Heading structure quality
• Structure Score: HTML semantic markup
• Content Score: Content quality and relevance
• E-E-A-T Score: Authority and trust signals
• Schema Score: Structured data implementation
• Overall Score: Composite quality metric

• Critical: Major problems requiring immediate attention
• High: Important issues affecting performance
• Medium: Optimization opportunities
• Low: Minor improvements

​

Fix Plan

[
  {
    "page_path": "/products/widget",
    "issue_code": "MISSING_H1",
    "priority": "CRITICAL",
    "description": "Page missing H1 heading",
    "suggestion": "Add a descriptive H1 that includes primary keyword"
  },
  {
    "page_path": "/blog/article",
    "issue_code": "NO_AUTHOR_INFO",
    "priority": "HIGH",
    "description": "Author information not found",
    "suggestion": "Add author bio with credentials to improve E-E-A-T"
  }
]

​

PDF Report Generation

​

Comprehensive Context

​

Automatic PageSpeed Trigger

1. Checks if PageSpeed data exists and is fresh (<24 hours)
2. Runs PageSpeed analysis if needed or forced
3. Includes complete mobile and desktop metrics
4. Generates comprehensive report with all context

​

Force Refresh Options

POST /api/v1/audits/{audit_id}/generate-pdf
{
  "force_pagespeed_refresh": true,    // Re-run PageSpeed analysis
  "force_report_refresh": true,        // Regenerate report markdown
  "force_external_intel_refresh": true // Refresh competitor intelligence
}

​

Downloading Reports

# Get download URL (JSON response)
GET /api/v1/audits/{audit_id}/download-pdf-url

# Direct download (redirect to signed URL)
GET /api/v1/audits/{audit_id}/download-pdf

​

API Endpoints

​

Create Audit

POST /api/v1/audits/
{
  "url": "https://example.com",
  "language": "en",
  "market": "US",
  "competitors": ["competitor1.com", "competitor2.com"]
}

​

Get Audit Status

GET /api/v1/audits/{audit_id}/status

• Audit ID and URL
• Current status and progress percentage
• GEO score
• Total pages analyzed

​

Get Full Audit Details

GET /api/v1/audits/{audit_id}

• All scores and metrics
• Fix plan
• Page-level analysis
• Target audit data

​

List All Audits

GET /api/v1/audits/?skip=0&limit=100

​

Get Pages

GET /api/v1/audits/{audit_id}/pages

​

Get Competitors

GET /api/v1/audits/{audit_id}/competitors?limit=5

​

Run PageSpeed Analysis

POST /api/v1/audits/{audit_id}/run-pagespeed
{
  "strategy": "both"  // "mobile", "desktop", or "both"
}

• Performance scores
• Core Web Vitals metrics
• Opportunities for optimization
• Diagnostics
• Accessibility, SEO, and best practices audits

​

Best Practices

​

Performance Optimization

• PageSpeed runs on-demand to keep audits fast
• Use SSE for real-time progress updates instead of polling
• Limit competitor analysis to 5-10 domains
• Cache PDF reports for 24 hours

​

Error Handling

• Monitor audit status for failures
• Check error_message field for debugging
• Implement retry logic for transient failures
• Fall back to polling if SSE unavailable

​

Security

• All endpoints require authentication
• Users can only access their own audits
• PDF URLs expire after 1 hour
• Sensitive data never exposed in logs

​

Next Steps