SEO Health Checker — audit page SEO signals

Evaluate SEO Health API

What it does

SEO Health Checker evaluates a webpage URL and returns a structured audit of its search-engine signals. Send it an http or https URL, and you get a score, a grade, and a breakdown of the page’s SEO-related metadata and structured data.

Use it when you need a quick technical read on a landing page, blog post, or product page before publishing. The response includes counts for warnings, critical errors, JSON-LD items, microdata items, and rich results, plus booleans for Open Graph, Twitter Card, and structured data presence. That makes it useful for spotting missing metadata and comparing pages in a crawl or content QA workflow.

You also get a top_fixes array with the main issues to address, along with the audited url and source_url. If you are building an internal SEO review tool or automating pre-publish checks, this gives you a compact machine-readable summary without parsing the page yourself.

What you'll get back

Returns a JSON object with these top-level fields: url (string), grade (string), score (integer), breakdown (object), top_fixes (array of strings), and source_url (string). The breakdown object can include warnings, json_ld_count, has_open_graph, critical_errors, microdata_count, has_twitter_card, rich_results_total, rich_results_eligible, and structured_data_present.

{
  "url": "https://apyhub.com",
  "score": 89,
  "grade": "B",
  "breakdown": {
    "structured_data_present": true,
    "json_ld_count": 22,
    "microdata_count": 0,
    "has_open_graph": true,
    "has_twitter_card": true,
    "rich_results_eligible": 5,
    "rich_results_total": 5,
    "critical_errors": 0,
    "warnings": 5
  },
  "top_fixes": [
    "\"logo\": \"https://example.com/logo.png\"",
    "\"contactPoint\": { \"@type\": \"ContactPoint\", \"telephone\": \"+1-555-123-4567\", \"contactType\": \"customer service\" }",
    "\"founder\": { \"@type\": \"Person\", \"name\": \"Founder Name\" }",
    "\"numberOfEmployees\": \"50\"",
    "\"aggregateRating\": { \"@type\": \"AggregateRating\", \"ratingValue\": \"4.5\", \"bestRating\": \"5\", \"ratingCount\": \"120\" }"
  ],
  "source_url": "https://apyhub.com"
}

About this endpoint

What it does

Evaluates the SEO health of a webpage given its url and returns an SEO report for that page, including a score, grade, breakdown metrics, top fixes, and related URLs.

Request Body

Parameter	Type	Mandatory	Description
url	String	Yes	URL of the webpage to evaluate. Must be a valid URI using http/https only.

Response

Returns a JSON object with url, grade, score, breakdown, top_fixes, and source_url fields. breakdown is a nested object with SEO metric counts and booleans, and top_fixes is an array of strings.

Parameter	Type	Mandatory	Description
url	String	No	The evaluated webpage URL.
grade	String	No	The SEO grade assigned to the webpage.
score	Integer	No	The SEO score assigned to the webpage.
breakdown	Object	No	SEO metric summary 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	Array of suggested fixes.
source_url	String	No	Source URL for the report. Must be a valid URI.

Body

Name

Type

Description

bodyREQUIRED

object

—

Evaluate SEO Health API

What it does

Quickstart

What you'll get back

About this endpoint

What it does

Request Body

Response

Body

Errors any endpoint can return