---
title: "Analyze Url"
method: POST
path: "/api/v1/seo-audit/analyze"
tags: ["seo-audit"]
---

# Analyze Url

`POST /api/v1/seo-audit/analyze`

## Request

- Base URL: `https://api.seoproai.co`
- URL: `https://api.seoproai.co/api/v1/seo-audit/analyze`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://dajosjnaalanhqksxrpe.supabase.co/auth/v1/authorize`, token URL `https://dajosjnaalanhqksxrpe.supabase.co/auth/v1/token`)

Perform a comprehensive SEO audit on a URL.

Rate limits:
- Anonymous: 5 uses/day
- Free users: 15 uses/day
- Paid users: Unlimited

This free tool analyzes:
- Meta tags (title, description, canonical, robots)
- Heading structure (H1-H6 hierarchy)
- Image optimization (alt text, lazy loading)
- Link analysis (internal, external, broken)
- Performance indicators (page size, load time)
- Content quality (word count, structured data)
- Security (HTTPS, security headers)
- Social media meta tags (Open Graph, Twitter Cards)

## Headers

- `x-forwarded-for` string, nullable
- `authorization` string, nullable

## Request body

- AuditRequest: Request model for SEO audit
  - `url` string, required: URL to audit

## Response `200`

Successful Response

- SEOAuditResult: Complete SEO audit result
  - `url` string, required
  - `audit_date` string, required
  - `overall_score` integer
  - `meta_tags` MetaTagsAudit, required: Meta tags audit results
    - `title` string, nullable
    - `title_length` integer
    - `description` string, nullable
    - `description_length` integer
    - `canonical` string, nullable
    - `robots` string, nullable
    - `viewport` string, nullable
    - `charset` string, nullable
    - `og_title` string, nullable
    - `og_description` string, nullable
    - `og_image` string, nullable
    - `twitter_card` string, nullable
    - `twitter_title` string, nullable
    - `twitter_description` string, nullable
  - `headings` HeadingsAudit, required: Headings structure audit results
    - `h1_count` integer
    - `h1_texts` string[]
    - `h2_count` integer
    - `h2_texts` string[]
    - `h3_count` integer
    - `h4_count` integer
    - `h5_count` integer
    - `h6_count` integer
    - `heading_hierarchy_valid` boolean
  - `images` ImagesAudit, required: Images audit results
    - `total_images` integer
    - `images_with_alt` integer
    - `images_without_alt` integer
    - `images_with_lazy_loading` integer
    - `large_images` string[]
    - `missing_alt_images` string[]
  - `links` LinksAudit, required: Links audit results
    - `internal_links` integer
    - `external_links` integer
    - `nofollow_links` integer
    - `broken_links` string[]
    - `links_without_text` integer
  - `performance` PerformanceAudit, required: Performance indicators
    - `load_time_ms` number
    - `page_size_bytes` integer
    - `dom_elements` integer
    - `inline_css_count` integer
    - `inline_js_count` integer
    - `external_css_count` integer
    - `external_js_count` integer
  - `content` ContentAudit, required: Content quality audit
    - `word_count` integer
    - `paragraph_count` integer
    - `avg_paragraph_length` number
    - `reading_time_minutes` number
    - `has_structured_data` boolean
    - `structured_data_types` string[]
  - `security` SecurityAudit, required: Security audit results
    - `is_https` boolean
    - `has_hsts` boolean
    - `has_x_frame_options` boolean
    - `has_x_content_type_options` boolean
    - `has_csp` boolean
  - `issues` AuditIssue[]
    - `category` string, required
    - `type` string, required
    - `title` string, required
    - `description` string, required
    - `impact` string, required
    - `recommendation` string, nullable
    - `value` unknown
  - `passed_checks` integer
  - `warning_checks` integer
  - `error_checks` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/seoproai/apis/seopro-ai.md) · [All operations](https://skmtc.dev/seoproai/apis/seopro-ai/llms.txt) · [OpenAPI document](https://skmtc.dev/seoproai/apis/seopro-ai/revisions/5b4b6391ddc9?raw)