Audits

Audit a single page

Synchronously scrape and audit a single URL, returning E-E-A-T, GEO, and SEO scores along with detected issues. Every route uses the canonical page scorer; no background audit job is queued.

post/audits/page

Request

  • Base URL: https://next.frase.io/api/v1
  • URL: https://next.frase.io/api/v1/audits/page
  • Auth: one of:
    • API key in header X-API-KEY
    • HTTP bearer

Request body

urlstring uri required

The URL to audit. Must be http or https.

keywordstring

Optional target keyword for SEO scoring context.

audit_page_idstring uuid

Optional audit page ID. When provided, re-audits the page within its site audit context, updating the auditPages row and recalculating the parent audit score.

site_audit_idstring uuid

Optional site audit ID. Used together with audit_page_id to specify which site audit the page belongs to.

site_idstring uuid

Optional site ID. When provided, the endpoint uses this site for routing instead of auto-detecting by domain.

confirm_target_keyword_changeboolean

Retry with true only after the user explicitly confirms replacing the page's canonical target keyword following a 409 response.

Response

Audit completed successfully (synchronous). Returned for routes: standalone, reaudit_in_site_audit, add_to_site_audit.

route'standalone' | 'reaudit_in_site_audit' | 'add_to_site_audit'

The routing path taken by the endpoint.

idstring uuid
urlstring uri
status'completed' | 'failed'
keywordstring nullable
content_type'blog_post' | 'page' | 'faq' | 'glossary' | 'comparison' | 'pillar' | 'how_to' | 'landing' | 'listicle' | 'case_study' | 'tutorial' | 'news' | 'product_update' | 'data_report' | 'event' | 'resource' | 'alternative' | 'tool_review' | 'null' nullable

Canonical content type. Null when classification is not applicable or unmeasured.

content_type_confidence'high' | 'medium' | 'low' | 'null' nullable

Categorical confidence in the canonical content classification.

content_type_status'classified' | 'fallback' | 'not_applicable' | 'unmeasured'

Whether canonical classification succeeded, used a deterministic fallback, was not applicable, or was unmeasured.

content_type_method'llm' | 'deterministic' | 'null' nullable

Classification method. Null when no classifier ran.

content_type_versionstring nullable

Internal classifier revision. Null when no classifier ran.

titlestring nullable
meta_descriptionstring nullable
word_countinteger
overall_scoreinteger nullable
eeat_scoreinteger nullable
eeat_breakdownobject nullable
geo_scoreinteger nullable
geo_breakdownobject nullable
seo_scoreinteger nullable
seo_breakdownobject nullable
issuesobject[]
outbound_linksstring[]
author_namestring nullable
analyzed_atstring date-time
created_atstring date-time

Changes

No recorded changes to this operation across all 1 revision of this API.