Page SEO

Fetches a public URL at request time and returns a structured on-page SEO audit. Use it to check a single page's title and description lengths, canonical, robots directives, social tags and link counts. This is a live fetch, not Common Crawl data, so it reflects the page as it is right now.

Request

Parameters

Example

curl "https://api.rankparse.com/v1/page-seo?url=https://stripe.com/about" \
  -H "X-API-Key: rp_your_key"

import requests

resp = requests.get(
    "https://api.rankparse.com/v1/page-seo",
    params={"url": "https://stripe.com/about"},
    headers={"X-API-Key": "rp_your_key"},
    timeout=30,
)
resp.raise_for_status()
audit = resp.json()["data"]
print(audit["title"]["text"], audit["title"]["optimal"])

const res = await fetch(
  "https://api.rankparse.com/v1/page-seo?" +
    new URLSearchParams({ url: "https://stripe.com/about" }),
  { headers: { "X-API-Key": process.env.RANKPARSE_API_KEY } }
);
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const { data } = await res.json();
console.log(data.title.text, data.title.optimal);

Response

{
  "url": "https://stripe.com/about",
  "data": {
    "url": "https://stripe.com/about",
    "final_url": "https://stripe.com/about",
    "status_code": 200,
    "response_time_ms": 312,
    "title": { "text": "About Us - Example", "length": 18, "optimal": false },
    "description": { "text": "Learn about Example Inc.", "length": 24, "optimal": false },
    "canonical": { "url": "https://stripe.com/about", "self_referential": true },
    "robots": { "index": true, "follow": true, "raw": "index,follow" },
    "viewport": "width=device-width, initial-scale=1",
    "language": { "primary": "en", "tag": "en-US", "source": "html_lang" },
    "hreflang": [
      { "lang": "en", "url": "https://stripe.com/about" },
      { "lang": "fr", "url": "https://fr.stripe.com/about" }
    ],
    "headings": {
      "h1": ["About Us"],
      "h2": ["Our Story", "Our Team"],
      "h3_count": 4
    },
    "og": {
      "title": "About Us - Example",
      "description": "Learn about Example Inc.",
      "image": "https://stripe.com/og-image.jpg",
      "type": "website",
      "url": "https://stripe.com/about"
    },
    "twitter": {
      "card": "summary_large_image",
      "title": "About Us - Example"
    },
    "json_ld": [{ "@type": "Organization", "name": "Example Inc." }],
    "images": { "total": 8, "missing_alt": 2 },
    "links": { "internal": 24, "external": 3 },
    "word_count": 412,
    "favicon": "https://stripe.com/favicon.ico"
  },
  "credits_used": 3,
  "credits_remaining": 997
}

Response fields

Behavior and limits

URL rules

• Only http and https are accepted. No credentials in the URL, no leading or trailing whitespace, and no fragment: any # in the URL is rejected with invalid_url.
• Hosts must be public. localhost, *.local, *.internal, *.home.arpa, private and reserved IPv4 or IPv6 ranges, and hosts without a dot are rejected with private_ip. Every redirect hop is re-validated, so a public URL cannot redirect you into a private address.
• Up to 5 redirects are followed.

Fetch limits

• Timeout is 8 seconds for the whole fetch.
• Only the first 2 MB of a response is accepted. Larger responses fail with response_too_large.
• The request is sent with the user agent Mozilla/5.0 (compatible; RankParse/1.0; +https://rankparse.com). Sites that block unknown bots may return an error page; the audit then describes that page.
• Pages are parsed from the raw HTML the server returns. Content rendered by client-side JavaScript is not seen.

Billing

• Costs 3 credits. If the call fails after being charged (any non-2xx response, such as 503 fetch_failed), the 3 credits are refunded automatically. Requests with a malformed or private URL are rejected before billing.
• Calls count against the standard 60 requests per minute limit. See Rate limiting.

Errors

Error bodies look like { "error": "Service Unavailable", "code": "fetch_failed" }. See Errors for the shared format.

Related

MCP tool: get_page_seo.