Skip to main content

Website Audit

POST 

/audit

Performs a comprehensive SEO and AI-readiness audit of a specified URL. The audit analyzes:

  • Site files (robots.txt, llms.txt)
  • SEO fundamentals (title, description, headings)
  • Structured data (Schema.org, JSON-LD)
  • Content structure and semantic HTML
  • Image accessibility
  • Automation readiness for AI agents
  • JavaScript rendering and bot accessibility

Returns an overall score (0-100) and detailed recommendations for improvement.

Request

Body

required

    url urirequired

    The full URL of the website to audit

Responses

Successful audit response

Schema

    success boolean

    Indicates if the audit was successful

    data

    object

    url string

    The audited URL (may include trailing slash)

    domain string

    The base domain of the audited URL

    timestamp date-time

    ISO 8601 timestamp of when the audit was performed

    overallScore integer

    Possible values: <= 100

    Overall SEO and AI-readiness score (0-100)

    summary string

    High-level summary of the audit findings

    siteFiles

    object

    status string

    Possible values: [Good, Needs Improvement, Poor]

    Overall status of site files

    explanation string

    Detailed explanation of site files evaluation

    robotsTxt string

    Possible values: [found, not_found, error]

    Status of robots.txt file

    llmsTxt string

    Possible values: [found, not_found, error]

    Status of llms.txt file (AI model instructions)

    botAccess

    object

    gptbot string

    Possible values: [allowed, blocked, not_specified]

    claude string

    Possible values: [allowed, blocked, not_specified]

    googlebot string

    Possible values: [allowed, blocked, not_specified]

    seoFundamentals

    object

    status string

    Possible values: [Good, Needs Improvement, Poor]

    explanation string
    title stringnullable

    Page title tag content

    description stringnullable

    Meta description content

    h1Count integer

    Number of H1 headings on the page

    structuredData

    object

    status string

    Possible values: [Good, Needs Improvement, Poor]

    explanation string
    hasSchema boolean

    Whether schema.org markup is present

    hasJsonLd boolean

    Whether JSON-LD structured data is present

    detectedSchemas string[]

    List of detected schema types

    contentStructure

    object

    status string

    Possible values: [Good, Needs Improvement, Poor]

    explanation string
    semanticHtmlScore integer

    Possible values: <= 10

    Score for semantic HTML usage (0-10)

    imageAccessibility

    object

    status string

    Possible values: [Good, Needs Improvement, Poor]

    explanation string
    missingAltPercentage number

    Possible values: <= 100

    Percentage of images missing alt text

    totalImages integer

    Total number of images on the page

    imagesWithoutAlt integer

    Number of images without alt text

    automationReadiness

    object

    status string

    Possible values: [Good, Needs Improvement, Poor]

    explanation string
    issues string[]

    List of issues affecting automation readiness

    jsRendering

    object

    status string

    Possible values: [Good, Needs Improvement, Poor]

    explanation string
    frameworkDetected string

    Detected JavaScript framework (React, Vue, Angular, etc.)

    renderingType string

    Possible values: [Static, SSR, SSG, CSR, Hybrid]

    Type of rendering used by the site

    aiAccessibility string

    Possible values: [Excellent, Good, Limited, Blocked]

    How accessible the content is to AI agents

    contentAvailability string

    Description of content availability in HTML

    recommendations string[]

    Recommendations for improving JS rendering

    quickWins

    object[]

  • Array [

  • title string

    Title of the quick win recommendation

    description string

    Detailed description of the recommendation

    impact string

    Possible values: [High, Medium, Low]

    Expected impact of implementing this recommendation

  • ]

  • status string

    Possible values: [completed, pending, failed]

    Status of the audit process

    accountId integer

    Account ID associated with the audit

    accountUrl string

    Account URL associated with the audit