NewAPIVerve Academy: free courses and certifications anyone can verify.Explore the Academy →

SEO Quick Validator API

POST

Catch on-page SEO issues and missing tags across any web page.

SEO Quick Validator inspects live web pages for on-page SEO errors and tag issues. Pass any URL to inspect title lengths, meta descriptions, H1 headings, viewport and canonical tags, image alt text, and unverified external links.

Try it — live request, no key required

Request
POSTapi.apiverve.com/v1/seovalidator
Body
Verification
Format

No key required to try it. Get a key to use it in your app.

Example
{
  "status": "ok",
  "error": null,
  "data": {
    "url": "https://apiverve.com",
    "passed": false,
    "issueCount": 6,
    "issues": [
      "Image missing 'alt' attribute: '/assets/img/hero-diagram.png'",
      "Image missing 'alt' attribute: '/assets/img/logo-mark.svg'",
      "External link missing 'rel' attribute: 'https://twitter.com/apiverve'",
      "External link missing 'rel' attribute: 'https://github.com/apiverve'",
      "External link missing 'rel' attribute: 'https://status.apiverve.com'",
      "Missing meta 'keywords' tag in head"
    ],
    "checks": {
      "hasTitle": true,
      "titleLength": 54,
      "hasMetaDescription": true,
      "metaDescriptionLength": 158,
      "hasMetaKeywords": false,
      "h1Count": 1,
      "hasCanonical": true,
      "hasViewport": true,
      "imagesTotal": 8,
      "imagesMissingAlt": 2,
      "externalLinksTotal": 10,
      "externalLinksMissingRel": 3
    },
    "seoScore": 93,
    "grade": "A",
    "titleRelevance": 47.91,
    "descriptionRelevance": 51.65
  }
}

About the SEO Quick Validator API

An SEO validator API for an on-page SEO check of any live URL. It fetches and parses the web page, then evaluates its on-page SEO signals — title, meta description, H1 structure, canonical link, mobile viewport, image alt text and external-link rel attributes — and returns a plain list of issues to fix alongside a structured breakdown of every check.

The Free plan returns the issue list, an issue count, a passed flag and the checks object: title and meta description lengths, H1 count, whether canonical and viewport tags exist, image and link totals, and how many images are missing alt text. That is enough to check meta tags in a CMS publish hook, audit webpage SEO across a sitemap, or fail a deploy that ships a page without a title.

Paid plans add a weighted 0-100 score with an A–F grade, so you can gauge a page's SEO health at a glance and track it over time. They also add two relevance scores, computed with a sentence-embedding model, showing how closely the title and the meta description match what the page's main content is about.

How it works

The page is fetched as plain HTML first, with a headless browser render as a fallback; images, fonts and media are not downloaded. Private and internal URLs are refused, and an empty page returns 503, as does a bot-block or WAF denial page (Akamai, Cloudflare challenge, DataDome, PerimeterX) served in place of the site; those are not scored or cached. Results are cached per URL for about a minute.

The HTML is parsed with cheerio and each rule adds a line to issues: an <img> with no alt attribute (an empty alt="" marks a decorative image, so it is counted in checks.imagesEmptyAlt and not flagged), an external http(s) link with no rel (links to the same site, including its other subdomains, are skipped), no <title> in the head, no meta description, no meta keywords, zero or several <h1>, no viewport tag and no canonical link. passed is true only when issues is empty, and since a missing meta keywords tag is listed, a page needs one to pass. checks exposes the same rules as values; titleLength and metaDescriptionLength are character counts, null when the tag is absent. An empty <title> sets hasTitle false without adding an issue.

seoScore starts at 100 and subtracts 20 for no title, 15 for no meta description, 15 for no H1 or 8 for several, 8 each for no canonical and no viewport, 2 for no meta keywords, up to 12 in proportion to images lacking alt, and up to 6 in proportion to external links lacking rel. grade is A at 90+, B 80+, C 70+, D 60+, otherwise F.

titleRelevance and descriptionRelevance compare each tag with up to 5,000 characters of main content, with navigation, header and footer removed, using a sentence-embedding model, scaled 0-100. They are null when the tag is missing, the content is under 200 characters or the model fails. On the Free plan these four fields are null.

What people use it for

CMS Publishing Check
Before publishing a blog post, CMS editors verify that title tags, meta descriptions, and image alt text meet basic standards.
Staging Site Audits
When deploying a site update, QA engineers test generated landing pages to catch missing canonical tags and duplicate H1 headings.
Agency Client Onboarding
Marketing agencies inspect client websites to list total issue counts and flag external links lacking security rel attributes.
Ecommerce Catalog Monitoring
To keep product catalogs discoverable, ecommerce platforms scan merchant pages to detect missing image descriptions and absent viewport configurations.

Ways to call it

One endpoint, many ways in — REST with JSON, XML, YAML and CSV, plus GraphQL and an MCP interface for AI agents.

JSON
Default REST response
XML
Markup format
YAML
Human-readable
CSV
Tabular export
Beta
GraphQL
Query language
New
MCP
For AI agents

Other ways to use SEO Quick Validator

Same data, same APIVerve account, same credit balance — one key works on all of them.

Questions.

Common questions about the SEO Quick Validator API.

Read the docs →
What on-page SEO signals does the validator check?
It evaluates core on-page elements including title tag presence and length, meta description presence and length, meta keywords, H1 tag count, and canonical link tags. It also checks for mobile viewport meta tags, counts images missing alt text, and flags external links missing rel attributes.
Do I get the composite SEO score and letter grade on the Free plan?
No, the 0-100 SEO health score and A through F letter grade are premium fields. Any paid subscription unlocks them, starting with Starter. The Free plan returns the pass status, issue count, issue list, and the raw rule check breakdown.
How many page validations does the Free plan cover?
The Free plan gives you 200 monthly credits, which covers 20 page validations at 10 credits each. If you need higher volume, the Starter plan covers up to 20,000 page validations per month, which works out to about $0.0015 per check or $1.50 per 1,000 calls.
Does the validator evaluate live web pages in real time?
Yes, SEO Quick Validator fetches and parses the live web page directly when you make the call. It evaluates the current HTML markup on demand rather than pulling from an outdated or cached database.
What values are returned if a page is missing a title or meta description?
When an element is absent, its corresponding boolean check returns false and its character length field returns null. The omission is also flagged inside the issues array and included in the total issue count.
Can I display these SEO audit results inside my own client dashboard?
Yes, commercial use is allowed on any paid plan. You can integrate the checks, issues, and grades into your own client reports or SaaS platform, provided you do not resell or redistribute the raw API data as-is.
What happens if the URL is not an HTML page?
A URL that returns JSON or plain text is not scored. The API returns a 422 saying the URL did not return an HTML page, instead of grading the document as a page with every tag missing.

Ready to build with SEO Quick Validator? Start with 200 free credits — one key unlocks all 406+ APIs.

Explore the catalog

406+ APIs on the same key and the same response shape.

Browse all APIs