SEO

13 endpoints for technical SEO: meta, schema, redirects, broken links, mixed content, plus crawlability.

For SEO consultants and in-house technical SEO leads.

Endpoints in this bundle

Each endpoint is independently callable. Bundle membership is for discovery only — you do not need to opt in.

Method	Path	Credits	Summary
POST	/v1/seo/meta-audit	1	Title, description, canonical, og, and twitter card audit.
POST	/v1/seo/schema-validate	1	JSON-LD schema.org validation.
POST	/v1/seo/readability	1	Six readability formulas (Flesch, FK grade, Gunning, ARI, SMOG, Coleman-Liau).
POST	/v1/seo/redirect-chain-map	1	Walk 301/302/308 chains and tag each hop.
POST	/v1/seo/broken-links-audit	1	Crawl and report 4xx/5xx links on a page.
POST	/v1/seo/anchor-text-audit	1	Anchor-text distribution and over-optimisation flags.
POST	/v1/seo/mixed-content	1	https-on-http resource detection.
POST	/v1/seo/snippet-candidates	1	Featured-snippet-eligible passages from the page.
POST	/v1/seo/keyword-extract	1	Keyword surfacing with TF and density bands.
POST	/v1/intel/sitemap	1	sitemap.xml parse with per-URL summary.
POST	/v1/intel/robots	1	robots.txt parse and rule evaluation.
POST	/v1/intel/redirects	1	Follow and tag a redirect chain from a starting URL.
POST	/v1/scrape/smart	1	Fetch with auto-escalation through the render cascade.

Recipe

Page-level technical audit

Pull the sitemap with /v1/intel/sitemap to get a URL inventory plus lastmod.
For each URL, call /v1/seo/meta-audit and /v1/seo/schema-validate in parallel to score on-page tags.
Run /v1/seo/broken-links-audit and /v1/seo/redirect-chain-map on high-traffic pages to catch dangling links and redirect loops.
Roll the per-URL JSON into a single client-facing report and store deltas between runs.

Sample code

Try a request

Pick a language. Click to expand the snippet.

curl

curl -X POST https://api.ollagraph.com/v1/seo/meta-audit \
  -H "Authorization: Bearer $OLLAGRAPH_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"url":"https://example.com/blog/seo-checklist"}'

python

import httpx, os

r = httpx.post(
    "https://api.ollagraph.com/v1/seo/meta-audit",
    headers={"Authorization": f"Bearer {os.environ['OLLAGRAPH_API_KEY']}"},
    json={"url": "https://example.com/blog/seo-checklist"},
    timeout=30.0,
)
print(r.json())

node

const res = await fetch("https://api.ollagraph.com/v1/seo/meta-audit", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.OLLAGRAPH_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ url: "https://example.com/blog/seo-checklist" }),
});
console.log(await res.json());

FAQ

SEO bundle FAQ

Does broken-links-audit follow off-site links?

Yes, but only HEAD-checks them. It will not crawl beyond the seed page.

What schema.org version does schema-validate target?

Latest schema.org core plus pending. We do not enforce Google's rich-results subset — use the report's `google_eligibility` flag.

Why does meta-audit sometimes report missing og tags on pages that render them client-side?

Server-rendered HTML is what counts for crawlers. If your og tags are injected by JS, escalate to /v1/scrape/smart so we get the rendered DOM, then re-run meta-audit on that HTML.

SEO

Endpoints in this bundle

Page-level technical audit

Try a request

SEO bundle FAQ

Ship with the SEO bundle.