SEO Health Check — audit page SEO signals

Evaluate SEO Health API

What it does

SEO Health Check evaluates a webpage URL and returns a structured audit of the page’s SEO signals. Send a URL and get back a grade, score, and a breakdown of the page’s metadata and structured-data status.

Use it to spot common issues before a page ships or to monitor live pages for regressions. The response includes warning and critical error counts, JSON-LD and microdata counts, whether Open Graph and Twitter Card tags are present, and totals for rich results and eligible rich results.

You also get a list of top fixes so you can move from diagnosis to action quickly. That makes SEO Health Check useful in CI checks, content QA workflows, and internal tooling where you need a machine-readable audit of a public page.

If you’re validating landing pages, blog posts, or product pages, this gives you a compact snapshot of what search engines and social crawlers can see from the URL alone.

{ "url": "https://example.com", "grade": "A", "score": 92, "breakdown": { "warnings": 2, "json_ld_count": 1, "has_open_graph": true, "critical_errors": 0, "microdata_count": 0, "has_twitter_card": true, "rich_results_total": 4, "rich_results_eligible": 3, "structured_data_present": true }, "top_fixes": [ "Add a meta description", "Improve structured data coverage" ], "source_url": "https://example.com" }

About this endpoint

What it does

Evaluates the SEO health of a webpage from the submitted URL and returns an assessment object with a grade, score, breakdown metrics, top fixes, and source URL.

Request Body

Parameter	Type	Mandatory	Description
url	String	Yes	URL of the webpage to extract, audit, or validate content from. Must be a valid URI using http or https.

Response

Returns a JSON object with url, grade, score, breakdown, top_fixes, and source_url fields. breakdown is an object with several SEO-related metrics, top_fixes is an array of strings, and the other top-level fields are scalar values.

Parameter	Type	Mandatory	Description
url	String	No	The URL that was evaluated. Format: URI.
grade	String	No	The SEO grade returned by the service.
score	Integer	No	The SEO score returned by the service.
breakdown	Object	No	SEO breakdown metrics object containing `warnings`, `json_ld_count`, `has_open_graph`, `critical_errors`, `microdata_count`, `has_twitter_card`, `rich_results_total`, `rich_results_eligible`, and `structured_data_present`.
top_fixes	String Array	No	List of top fixes returned by the service.
source_url	String	No	Source URL returned by the service. Format: URI.

Body

Name

Type

Description

bodyREQUIRED

object

—

Evaluate SEO Health API

What it does

QUICKSTART

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Body

Errors any endpoint can return