Analyze web page SEO
Check a web page's on-page SEO: title, meta tags, robots, canonical, hreflang, headings, structured data, links and images.
Headers
Get your API keyAPI key (`sfk_...`)
Web page URL to audit, for example `https://www.socialfetch.dev/pricing`.
min 1 chars · max 2083 chars
Most expensive proxy tier to use. The page is tried on `datacenter` first and moves up only if it is blocked, stopping at this tier. Default: every tier (`mobile`).
one of: datacenter, residential, mobile
Most credits this call may cost (1–25). Default 1, which loads about 1.6 MB on the datacenter proxy or 190 KB on residential or mobile. Raise it for heavy pages; you're charged only for what the page uses.
≥ 1 · ≤ 25
Endpoint-specific response payload.
Whether page content could be extracted. `restricted`: bot protection blocked the page on every proxy tier allowed. `budget_exceeded`: the page needed more than `maxCredits` allows before any content loaded.
one of: found, restricted, budget_exceeded
Proxy tier the page was loaded on: the tier that served it, or the last one tried. Null when not measured.
one of: datacenter, residential, mobile, null
Whether the page needed more than `maxCredits` allows. Loading stopped early, so content may be incomplete.
Data the page loaded through the proxy, in bytes, across every tier tried. Null when not measured.
≥ 0
URL that was requested.
URL that answered after redirects; null when not loaded.
HTTP status the final URL answered with; null when not loaded.
Redirect hops before the final URL, in order, at most 10.
URL that answered with a redirect.
Redirect status, for example 301 or 302.
The audit when lookupStatus is found; otherwise null.
Response `Content-Type` header, or null when absent.
Size of the HTML read, in bytes (after decompression).
≥ 0
Time from the first request to the full response, redirects included, in milliseconds.
≥ 0
Page `<title>`, or null.
Title length in characters.
≥ 0
Meta description, or null.
Meta description length in characters.
≥ 0
Meta keywords, or null.
Canonical URL (absolute), or null.
Robots directives from the page and its headers.
Content of the robots meta tag, or null.
`X-Robots-Tag` response header, or null.
Whether either one says `noindex` (or `none`).
Whether either one says `nofollow` (or `none`).
`lang` attribute of `<html>`, for example `en-GB`, or null.
Declared charset, or null.
Viewport meta tag, or null.
Meta refresh content, or null.
Favicon URL, or null.
AMP version URL, or null.
hreflang alternates, at most 100.
Language and region, for example `fr` or `x-default`.
Alternate URL (absolute).
Number of hreflang alternates on the page.
≥ 0
Heading texts by level, at most 50 per level.
`<h1>` texts, in page order.
`<h2>` texts, in page order.
`<h3>` texts, in page order.
`<h4>` texts, in page order.
`<h5>` texts, in page order.
`<h6>` texts, in page order.
Number of headings at each level.
Number of `<h1>` headings.
≥ 0
Number of `<h2>` headings.
≥ 0
Number of `<h3>` headings.
≥ 0
Number of `<h4>` headings.
≥ 0
Number of `<h5>` headings.
≥ 0
Number of `<h6>` headings.
≥ 0
Open Graph tags (`og:title`, `og:image` and so on).
Twitter card tags (`twitter:card` and so on).
Structured data found in the page.
JSON-LD blocks, at most 20.
Schema.org `@type` values in the block, `@graph` included.
Whether the block is valid JSON; null when it was too large to read.
The parsed block, or null when invalid or over 20,000 characters.
Whether the block was too large to return.
Number of JSON-LD blocks on the page.
≥ 0
Distinct microdata `itemtype` values.
Number of elements with an `itemtype`.
≥ 0
Links on the page. Counts cover every link.
Links to the same site (`www.` ignored).
≥ 0
Links to other sites.
≥ 0
Links with `nofollow`, `ugc` or `sponsored`.
≥ 0
http(s) links in page order, at most 300.
Absolute link URL.
Anchor text, or null when empty.
Whether the link stays on the same site.
Whether `rel` has `nofollow`, `ugc` or `sponsored`.
The link's `rel` values, or null.
Images on the page. Counts cover every image.
Number of `<img>` elements.
≥ 0
Images with no `alt` attribute.
≥ 0
Images with an empty `alt` (decorative).
≥ 0
Images in page order, at most 200.
Absolute image URL.
Alt text, or null when absent.
Whether the image has non-empty alt text.
Words of visible body text (scripts and styles excluded).
≥ 0
Number of `<script>` elements.
≥ 0
Number of linked stylesheets.
≥ 0
Number of `<iframe>` elements.
≥ 0
Pass or fail checks. Each is true when the page has the property it names.
Whether the response is HTML (or has no content type).
Whether the final URL uses https.
Whether the URL redirected before answering.
Whether the page answered 400 to 499.
Whether the page answered 500 or above.
Whether the HTML declares a doctype.
Whether the page has a non-empty title.
Whether the title is under 30 characters.
Whether the title is over 60 characters.
Whether the page has more than one `<title>`.
Whether the page has a meta description.
Whether the meta description is under 70 characters.
Whether the meta description is over 160 characters.
Whether the page has more than one meta description.
Whether the page has an `<h1>`.
Whether the page has more than one `<h1>`.
Whether the page declares `<link rel="canonical">`.
Whether the canonical URL is the page's own final URL.
Whether the page declares different canonical URLs.
Whether the meta robots tag or `X-Robots-Tag` header says `noindex`.
Whether the meta robots tag or `X-Robots-Tag` header says `nofollow`.
Whether `<html>` declares a `lang` attribute.
Whether the page has a viewport meta tag.
Whether the page or its headers declare a character set.
Whether the page redirects with a meta refresh.
Whether the page has JSON-LD or microdata.
Whether the page has Open Graph (`og:`) tags.
Whether any image has no `alt` attribute.
Whether the page body has fewer than 200 words.
Whether the URL path contains underscores.
Whether the final URL is over 115 characters.
Whether the HTML was cut off (over 5 MB, or `maxCredits` ran out), so the audit covers only the first part.
Metadata describing the request and billing outcome.
Unique request identifier for tracing this API call.
min 1 chars
Credits charged for this request.
≥ 0
Public API version that served the response.
one of: v1
Present, and `true`, only when the source couldn't be reached and this is the last good answer for the same request instead, up to 24 hours old. Absent on every live answer.
one of: true
When a stale answer (`stale: true`) was originally fetched (ISO 8601, UTC). Absent on every live answer.
Code example
curl "https://api.socialfetch.dev/v1/web/seo?url=https://www.socialfetch.dev" \
-H "x-api-key: YOUR_API_KEY"Responses
On-page SEO audit of the web page.