> ## Documentation Index
> Fetch the complete documentation index at: https://developers.octaviatech.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Article SEO Analysis

> Get Article SEO Analysis.



## OpenAPI

````yaml GET /articles/seoAnalysis/{id}
openapi: 3.1.0
info:
  title: Blog API
  version: 1.0.0
servers:
  - url: https://api.octaviatech.app/cms
    description: Production
security:
  - ApiKeyAuth: []
tags:
  - name: Tags
    description: Tag management endpoints
paths:
  /articles/seoAnalysis/{id}:
    get:
      tags:
        - Articles
      summary: Get SEO analysis for article
      description: >-
        Returns comprehensive SEO analysis including keyword analysis,
        link/image metrics, readability scores, and technical SEO checks.
        Supports filtering by language via query parameter.
      parameters:
        - in: path
          name: id
          required: true
          schema:
            type: string
            pattern: ^[a-fA-F0-9]{24}$
            example: '{{objectId}}'
          description: Article ID
        - in: query
          name: lang
          schema:
            type: string
            example: en
          description: >-
            Optional language code to filter results for specific language. If
            not provided, returns analysis for all languages.
      responses:
        '200':
          description: SEO analysis retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                    example: true
                  statusCode:
                    type: integer
                    example: 200
                  message:
                    type: string
                    example: SEO analysis retrieved successfully
                  data:
                    type: object
                    properties:
                      articleId:
                        type: string
                        example: '{{objectId}}'
                      slug:
                        type: string
                        example: seo-article
                      language:
                        type: string
                        example: en
                        description: Only present when the `lang` query param is provided
                      seo:
                        type: object
                        description: >-
                          Analysis for the single language named by `lang`,
                          otherwise keyed by language code
                        additionalProperties:
                          type: object
                          properties:
                            score:
                              type: integer
                              example: 89
                              description: Overall SEO score (0-100)
                            potentialScore:
                              type: integer
                              example: 95
                              description: Potential score if suggestions are implemented
                            scores:
                              type: object
                              properties:
                                titleMeta:
                                  type: integer
                                  example: 100
                                structure:
                                  type: integer
                                  example: 100
                                keywords:
                                  type: integer
                                  example: 100
                                content:
                                  type: integer
                                  example: 30
                                readability:
                                  type: integer
                                  example: 65
                                links:
                                  type: integer
                                  example: 100
                                images:
                                  type: integer
                                  example: 100
                                technical:
                                  type: integer
                                  example: 80
                            stats:
                              type: object
                              properties:
                                wordCount:
                                  type: integer
                                  example: 286
                                keywordDensity:
                                  type: number
                                  example: 2.8
                                readabilityScore:
                                  type: number
                                  example: 0.5
                                readabilityLevel:
                                  type: string
                                  example: Very Easy
                                totalImages:
                                  type: integer
                                  example: 1
                                totalLinks:
                                  type: integer
                                  example: 2
                                headingsCount:
                                  type: integer
                                  example: 5
                            topKeywords:
                              type: array
                              description: Up to 5 most frequent related terms
                              items:
                                type: object
                                properties:
                                  term:
                                    type: string
                                    example: nose
                                  count:
                                    type: integer
                                    example: 12
                                  inTitle:
                                    type: boolean
                                    example: true
                            allKeywords:
                              type: array
                              items:
                                type: object
                                properties:
                                  term:
                                    type: string
                                    example: nose
                                  count:
                                    type: integer
                                    example: 12
                                  density:
                                    type: number
                                    example: 2.8
                                  inTitle:
                                    type: boolean
                                    example: true
                                  inHeadings:
                                    type: boolean
                                    example: false
                            issues:
                              type: object
                              properties:
                                critical:
                                  type: array
                                  items:
                                    type: string
                                  example:
                                    - seo_no_schema_markup
                                warnings:
                                  type: array
                                  items:
                                    type: string
                                  example:
                                    - seo_content_too_short
                                criticalCount:
                                  type: integer
                                  example: 1
                                warningCount:
                                  type: integer
                                  example: 1
                            checks:
                              type: object
                              properties:
                                hasH1:
                                  type: boolean
                                  example: true
                                hasImages:
                                  type: boolean
                                  example: true
                                hasLinks:
                                  type: boolean
                                  example: true
                                hasGoodReadability:
                                  type: boolean
                                  example: false
                                urlOptimized:
                                  type: boolean
                                  example: true
        '404':
          description: Article not found
          content:
            application/json:
              example:
                success: false
                statusCode: 404
                message: Article not found
                data: null
components:
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: x-api-key

````