API docs v1
GET /v1/brands/{brand_id}/seo-pages/{page_id}/technical-checks

Retrieve the latest technical check

scope read:seo cost 1 RU idempotent required

Fetch the most recent technical SEO check for a page: an overall score plus per-category findings (robots.txt, sitemap, meta robots, canonical, Open Graph, Twitter card, schema.org, indexability, SSL, redirects, internal links, meta content, headings, hreflang, images, security headers, page weight). Returns 404 not_found when no check has been run yet; run one with POST.

Path parameters

Query parameters

  • dry_run boolean optional

    Preview the call without executing it. Runs auth, scope, eligibility and body validation, then returns 200 with a dry_run object reporting the request-unit and credit cost plus a non-consuming quota snapshot. Nothing is debited, reserved, dispatched or mutated. An invalid body still returns 422.

    default: false

Header parameters

Responses

Returned the latest technical check application/json
Type: SeoTechnicalCheck
  • brand_id string required

    Owning brand id (UUID).

  • created_at string required

    When the check was requested.

    format: `date-time`

  • id string required

    Technical check id (UUID).

  • page_id string required

    Page this check belongs to (UUID).

  • status enum required

    Check lifecycle state. One of processing, completed, failed.

  • canonical object (nullable) nullable

    Canonical URL findings.

  • error_message string (nullable) nullable

    User-facing failure reason when status is failed.

  • finished_at string (nullable) nullable

    When the check finished.

    format: `date-time`

  • headings object (nullable) nullable

    Heading hierarchy findings.

  • hreflang object (nullable) nullable

    Hreflang findings for international SEO.

  • images object (nullable) nullable

    Image alt-text coverage findings.

  • indexability object (nullable) nullable

    Overall indexability findings.

  • issues_count integer

    Number of issues found across all checks.

    min: 0 · default: `0`

  • meta_content object (nullable) nullable

    Title and meta description findings.

  • meta_robots object (nullable) nullable

    Meta robots directive findings.

  • object string

    Always seo_technical_check.

    default: `seo_technical_check`

  • open_graph object (nullable) nullable

    Open Graph tag findings.

  • overall_score integer (nullable) nullable

    Overall technical score 0-100, based on how many checks passed.

  • page_error_type string (nullable) nullable

    Category of the fetch error, if any.

  • page_fetch_error string (nullable) nullable

    Reason the page could not be fetched, if any.

  • page_fetch_warning string (nullable) nullable

    Note when the page was reachable only through a fallback path.

  • page_url string (nullable) nullable

    URL that was checked.

  • page_warning_type string (nullable) nullable

    Category of the fetch warning, if any.

  • page_weight object (nullable) nullable

    Page HTML weight findings.

  • passed_count integer

    Number of checks that passed.

    min: 0 · default: `0`

  • redirect_chain object (nullable) nullable

    Redirect chain findings.

  • robots_txt object (nullable) nullable

    Robots.txt findings.

  • schema_org object (nullable) nullable

    Schema.org structured-data findings.

  • security_headers object (nullable) nullable

    HTTP security header findings.

  • sitemap object (nullable) nullable

    Sitemap findings.

  • ssl_certificate object (nullable) nullable

    SSL certificate findings.

  • started_at string (nullable) nullable

    When the check began running.

    format: `date-time`

  • twitter_card object (nullable) nullable

    Twitter card findings.

  • updated_at string (nullable) nullable

    When the check row was last updated.

    format: `date-time`

Request validation failed application/json
Type: ApiError
  • error object required
    Show fields
    • code string required

      Stable machine-readable error code from the catalog.

    • message string required

      Human-readable description suitable for logging.

    • details object

      Optional, code-specific context (e.g. errors array for validation_error, retry_after for service_unavailable). Shape depends on error.code; treat as opaque otherwise.

      Show fields

      Empty object (no properties).

  • request_id string

    Server-generated correlation id for the request. Mirrors the X-Correlation-ID response header. Include this when contacting support.

    format: `uuid`

Example response 
{
  "error": {
    "code": "validation_error",
    "message": "Request validation failed"
  },
  "request_id": "9f6c4e8a-1d3b-4c8b-9f1e-7a3b1c2d3e4f"
}
Missing or invalid credentials application/json
Type: ApiError
  • error object required
    Show fields
    • code string required

      Stable machine-readable error code from the catalog.

    • message string required

      Human-readable description suitable for logging.

    • details object

      Optional, code-specific context (e.g. errors array for validation_error, retry_after for service_unavailable). Shape depends on error.code; treat as opaque otherwise.

      Show fields

      Empty object (no properties).

  • request_id string

    Server-generated correlation id for the request. Mirrors the X-Correlation-ID response header. Include this when contacting support.

    format: `uuid`

Example response 
{
  "error": {
    "code": "unauthorized",
    "message": "Missing or invalid credentials"
  },
  "request_id": "9f6c4e8a-1d3b-4c8b-9f1e-7a3b1c2d3e4f"
}
You do not have permission to access this resource application/json
Type: ApiError
  • error object required
    Show fields
    • code string required

      Stable machine-readable error code from the catalog.

    • message string required

      Human-readable description suitable for logging.

    • details object

      Optional, code-specific context (e.g. errors array for validation_error, retry_after for service_unavailable). Shape depends on error.code; treat as opaque otherwise.

      Show fields

      Empty object (no properties).

  • request_id string

    Server-generated correlation id for the request. Mirrors the X-Correlation-ID response header. Include this when contacting support.

    format: `uuid`

Example response 
{
  "error": {
    "code": "forbidden",
    "message": "You do not have permission to access this resource"
  },
  "request_id": "9f6c4e8a-1d3b-4c8b-9f1e-7a3b1c2d3e4f"
}
Resource not found application/json
Type: ApiError
  • error object required
    Show fields
    • code string required

      Stable machine-readable error code from the catalog.

    • message string required

      Human-readable description suitable for logging.

    • details object

      Optional, code-specific context (e.g. errors array for validation_error, retry_after for service_unavailable). Shape depends on error.code; treat as opaque otherwise.

      Show fields

      Empty object (no properties).

  • request_id string

    Server-generated correlation id for the request. Mirrors the X-Correlation-ID response header. Include this when contacting support.

    format: `uuid`

Example response 
{
  "error": {
    "code": "not_found",
    "message": "Resource not found"
  },
  "request_id": "9f6c4e8a-1d3b-4c8b-9f1e-7a3b1c2d3e4f"
}
Resource conflict application/json
Type: ApiError
  • error object required
    Show fields
    • code string required

      Stable machine-readable error code from the catalog.

    • message string required

      Human-readable description suitable for logging.

    • details object

      Optional, code-specific context (e.g. errors array for validation_error, retry_after for service_unavailable). Shape depends on error.code; treat as opaque otherwise.

      Show fields

      Empty object (no properties).

  • request_id string

    Server-generated correlation id for the request. Mirrors the X-Correlation-ID response header. Include this when contacting support.

    format: `uuid`

Example response 
{
  "error": {
    "code": "conflict",
    "message": "Resource conflict"
  },
  "request_id": "9f6c4e8a-1d3b-4c8b-9f1e-7a3b1c2d3e4f"
}
Per-minute rate limit exceeded application/json
Type: ApiError
  • error object required
    Show fields
    • code string required

      Stable machine-readable error code from the catalog.

    • message string required

      Human-readable description suitable for logging.

    • details object

      Optional, code-specific context (e.g. errors array for validation_error, retry_after for service_unavailable). Shape depends on error.code; treat as opaque otherwise.

      Show fields

      Empty object (no properties).

  • request_id string

    Server-generated correlation id for the request. Mirrors the X-Correlation-ID response header. Include this when contacting support.

    format: `uuid`

Example response 
{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Per-minute rate limit exceeded"
  },
  "request_id": "9f6c4e8a-1d3b-4c8b-9f1e-7a3b1c2d3e4f"
}
An unexpected error occurred application/json
Type: ApiError
  • error object required
    Show fields
    • code string required

      Stable machine-readable error code from the catalog.

    • message string required

      Human-readable description suitable for logging.

    • details object

      Optional, code-specific context (e.g. errors array for validation_error, retry_after for service_unavailable). Shape depends on error.code; treat as opaque otherwise.

      Show fields

      Empty object (no properties).

  • request_id string

    Server-generated correlation id for the request. Mirrors the X-Correlation-ID response header. Include this when contacting support.

    format: `uuid`

Example response 
{
  "error": {
    "code": "internal_error",
    "message": "An unexpected error occurred"
  },
  "request_id": "9f6c4e8a-1d3b-4c8b-9f1e-7a3b1c2d3e4f"
}
Service temporarily unavailable, please retry application/json
Type: ApiError
  • error object required
    Show fields
    • code string required

      Stable machine-readable error code from the catalog.

    • message string required

      Human-readable description suitable for logging.

    • details object

      Optional, code-specific context (e.g. errors array for validation_error, retry_after for service_unavailable). Shape depends on error.code; treat as opaque otherwise.

      Show fields

      Empty object (no properties).

  • request_id string

    Server-generated correlation id for the request. Mirrors the X-Correlation-ID response header. Include this when contacting support.

    format: `uuid`

Example response 
{
  "error": {
    "code": "service_unavailable",
    "message": "Service temporarily unavailable, please retry"
  },
  "request_id": "9f6c4e8a-1d3b-4c8b-9f1e-7a3b1c2d3e4f"
}