Web

Analyze web page SEO

Check a web page's on-page SEO: title, meta tags, robots, canonical, hreflang, headings, structured data, links and images.

GET/v1/web/seo
x-api-keystringheader

API key (`sfk_...`)

Parameters
3
urlstringrequiredquery

Web page URL to audit, for example `https://www.socialfetch.dev/pricing`.

min 1 chars · max 2083 chars

proxystringoptionalquery

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

maxCreditsintegeroptionalup to maxCreditsquery

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

Response fields
130

Endpoint-specific response payload.

datalookupStatus
string

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

dataproxy
stringnullable

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

databudgetExceeded
boolean

Whether the page needed more than `maxCredits` allows. Loading stopped early, so content may be incomplete.

databytesTransferred
integernullable

Data the page loaded through the proxy, in bytes, across every tier tried. Null when not measured.

≥ 0

dataurl
string

URL that was requested.

datafinalUrl
stringnullable

URL that answered after redirects; null when not loaded.

datastatus
integernullable

HTTP status the final URL answered with; null when not loaded.

Redirect hops before the final URL, in order, at most 10.

dataredirects[]url
string

URL that answered with a redirect.

dataredirects[]status
integer

Redirect status, for example 301 or 302.

The audit when lookupStatus is found; otherwise null.

dataauditcontentType
stringnullable

Response `Content-Type` header, or null when absent.

dataaudithtmlBytes
integer

Size of the HTML read, in bytes (after decompression).

≥ 0

dataauditresponseTimeMs
integer

Time from the first request to the full response, redirects included, in milliseconds.

≥ 0

dataaudittitle
stringnullable

Page `<title>`, or null.

dataaudittitleLength
integer

Title length in characters.

≥ 0

dataauditmetaDescription
stringnullable

Meta description, or null.

dataauditmetaDescriptionLength
integer

Meta description length in characters.

≥ 0

dataauditmetaKeywords
stringnullable

Meta keywords, or null.

dataauditcanonical
stringnullable

Canonical URL (absolute), or null.

Robots directives from the page and its headers.

dataauditrobotsmeta
stringnullable

Content of the robots meta tag, or null.

dataauditrobotsxRobotsTag
stringnullable

`X-Robots-Tag` response header, or null.

dataauditrobotsnoindex
boolean

Whether either one says `noindex` (or `none`).

dataauditrobotsnofollow
boolean

Whether either one says `nofollow` (or `none`).

dataauditlang
stringnullable

`lang` attribute of `<html>`, for example `en-GB`, or null.

dataauditcharset
stringnullable

Declared charset, or null.

dataauditviewport
stringnullable

Viewport meta tag, or null.

dataauditmetaRefresh
stringnullable

Meta refresh content, or null.

dataauditfavicon
stringnullable

Favicon URL, or null.

dataauditampUrl
stringnullable

AMP version URL, or null.

hreflang alternates, at most 100.

dataaudithreflang[]lang
string

Language and region, for example `fr` or `x-default`.

dataaudithreflang[]url
string

Alternate URL (absolute).

dataaudithreflangCount
integer

Number of hreflang alternates on the page.

≥ 0

Heading texts by level, at most 50 per level.

`<h1>` texts, in page order.

dataauditheadingsh1[]
stringoptional

`<h2>` texts, in page order.

dataauditheadingsh2[]
stringoptional

`<h3>` texts, in page order.

dataauditheadingsh3[]
stringoptional

`<h4>` texts, in page order.

dataauditheadingsh4[]
stringoptional

`<h5>` texts, in page order.

dataauditheadingsh5[]
stringoptional

`<h6>` texts, in page order.

dataauditheadingsh6[]
stringoptional

Number of headings at each level.

dataauditheadingCountsh1
integer

Number of `<h1>` headings.

≥ 0

dataauditheadingCountsh2
integer

Number of `<h2>` headings.

≥ 0

dataauditheadingCountsh3
integer

Number of `<h3>` headings.

≥ 0

dataauditheadingCountsh4
integer

Number of `<h4>` headings.

≥ 0

dataauditheadingCountsh5
integer

Number of `<h5>` headings.

≥ 0

dataauditheadingCountsh6
integer

Number of `<h6>` headings.

≥ 0

dataauditopenGraph
object

Open Graph tags (`og:title`, `og:image` and so on).

dataaudittwitterCard
object

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.

dataauditstructuredDatajsonLd[]types[]
stringoptional
dataauditstructuredDatajsonLd[]valid
booleannullable

Whether the block is valid JSON; null when it was too large to read.

dataauditstructuredDatajsonLd[]data
nullableoptional

The parsed block, or null when invalid or over 20,000 characters.

dataauditstructuredDatajsonLd[]truncated
boolean

Whether the block was too large to return.

dataauditstructuredDatajsonLdCount
integer

Number of JSON-LD blocks on the page.

≥ 0

Distinct microdata `itemtype` values.

dataauditstructuredDatamicrodataTypes[]
stringoptional
dataauditstructuredDatamicrodataCount
integer

Number of elements with an `itemtype`.

≥ 0

Links on the page. Counts cover every link.

dataauditlinksinternalCount
integer

Links to the same site (`www.` ignored).

≥ 0

dataauditlinksexternalCount
integer

Links to other sites.

≥ 0

dataauditlinksnofollowCount
integer

Links with `nofollow`, `ugc` or `sponsored`.

≥ 0

http(s) links in page order, at most 300.

dataauditlinksitems[]url
string

Absolute link URL.

dataauditlinksitems[]text
stringnullable

Anchor text, or null when empty.

dataauditlinksitems[]internal
boolean

Whether the link stays on the same site.

dataauditlinksitems[]nofollow
boolean

Whether `rel` has `nofollow`, `ugc` or `sponsored`.

dataauditlinksitems[]rel
stringnullable

The link's `rel` values, or null.

Images on the page. Counts cover every image.

dataauditimagescount
integer

Number of `<img>` elements.

≥ 0

dataauditimagesmissingAltCount
integer

Images with no `alt` attribute.

≥ 0

dataauditimagesemptyAltCount
integer

Images with an empty `alt` (decorative).

≥ 0

Images in page order, at most 200.

dataauditimagesitems[]url
string

Absolute image URL.

dataauditimagesitems[]alt
stringnullable

Alt text, or null when absent.

dataauditimagesitems[]hasAlt
boolean

Whether the image has non-empty alt text.

dataauditwordCount
integer

Words of visible body text (scripts and styles excluded).

≥ 0

dataauditscriptsCount
integer

Number of `<script>` elements.

≥ 0

dataauditstylesheetsCount
integer

Number of linked stylesheets.

≥ 0

dataauditiframesCount
integer

Number of `<iframe>` elements.

≥ 0

Pass or fail checks. Each is true when the page has the property it names.

dataauditchecksisHtml
boolean

Whether the response is HTML (or has no content type).

dataauditchecksisHttps
boolean

Whether the final URL uses https.

dataauditchecksisRedirect
boolean

Whether the URL redirected before answering.

dataauditchecksis4xx
boolean

Whether the page answered 400 to 499.

dataauditchecksis5xx
boolean

Whether the page answered 500 or above.

dataauditcheckshasDoctype
boolean

Whether the HTML declares a doctype.

dataauditcheckshasTitle
boolean

Whether the page has a non-empty title.

dataauditcheckstitleTooShort
boolean

Whether the title is under 30 characters.

dataauditcheckstitleTooLong
boolean

Whether the title is over 60 characters.

dataauditchecksmultipleTitles
boolean

Whether the page has more than one `<title>`.

dataauditcheckshasMetaDescription
boolean

Whether the page has a meta description.

dataauditchecksmetaDescriptionTooShort
boolean

Whether the meta description is under 70 characters.

dataauditchecksmetaDescriptionTooLong
boolean

Whether the meta description is over 160 characters.

dataauditchecksmultipleMetaDescriptions
boolean

Whether the page has more than one meta description.

dataauditcheckshasH1
boolean

Whether the page has an `<h1>`.

dataauditchecksmultipleH1
boolean

Whether the page has more than one `<h1>`.

dataauditcheckshasCanonical
boolean

Whether the page declares `<link rel="canonical">`.

dataauditcheckscanonicalIsSelf
boolean

Whether the canonical URL is the page's own final URL.

dataauditchecksmultipleCanonicals
boolean

Whether the page declares different canonical URLs.

dataauditchecksnoindex
boolean

Whether the meta robots tag or `X-Robots-Tag` header says `noindex`.

dataauditchecksnofollow
boolean

Whether the meta robots tag or `X-Robots-Tag` header says `nofollow`.

dataauditcheckshasLang
boolean

Whether `<html>` declares a `lang` attribute.

dataauditcheckshasViewport
boolean

Whether the page has a viewport meta tag.

dataauditcheckshasCharset
boolean

Whether the page or its headers declare a character set.

dataauditcheckshasMetaRefresh
boolean

Whether the page redirects with a meta refresh.

dataauditcheckshasStructuredData
boolean

Whether the page has JSON-LD or microdata.

dataauditcheckshasOpenGraph
boolean

Whether the page has Open Graph (`og:`) tags.

dataauditchecksimagesMissingAlt
boolean

Whether any image has no `alt` attribute.

dataauditcheckslowWordCount
boolean

Whether the page body has fewer than 200 words.

dataauditchecksurlHasUnderscores
boolean

Whether the URL path contains underscores.

dataauditchecksurlTooLong
boolean

Whether the final URL is over 115 characters.

dataauditcheckshtmlTruncated
boolean

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.

metarequestId
string

Unique request identifier for tracing this API call.

min 1 chars

metacreditsCharged
integer

Credits charged for this request.

≥ 0

metaversion
string

Public API version that served the response.

one of: v1

metastale
booleanoptional

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

metafetchedAt
stringoptional

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.