SEO Score API

Run an ADA / WCAG 2.1 AA accessibility audit (axe-core). Paid plans only. Returns the compliance score and grade, lawsuit risk (high/medium/low/minimal), category breakdowns, violations (WCAG 2.1 AA failures with affected elements and a plain-English fix), best_practices (not WCAG requirements; they never lower the score), needs_review and priorities. ADA audits have their own monthly allowance, separate from the audit quota (the usage tool reports ada_remaining). Each key may run 2 at a time; a 429 is not counted.

Create a GEO monitor for a URL. Requires Basic plan or higher (the Basic plan runs weekly).

Add a URL to score monitoring: it is re-audited on a schedule (daily or weekly) and the account owner is emailed when the score drops. Each plan allows a set number of monitors; the error says when the limit is reached.

Score how easily AI assistants and LLM search (ChatGPT, Perplexity, Google AI Overviews) can read, quote and cite a page: structure, answer-first content, entities and machine-readable data, with recommendations. Counts as one audit.

Run a full SEO audit on a URL. Returns score (0-100), letter grade, category breakdowns (meta, technical, social, performance, accessibility), AI readability score, SXO/AEO/AIO scores (paid plans), and a prioritized list of fixes. Usually returns in seconds. Free tier: 20 audits a month. Core Web Vitals (LCP, INP, CLS) are not measured unless include_core_web_vitals is true.

Look up observed backlinks for a domain. SEO Score API maintains an audit-fed backlink graph: every audit contributes the external links found on the audited page. The dataset is a sample (NOT a comprehensive backlink index like Ahrefs) and the response always includes a data_caveat. Coverage grows over time. Requires Basic plan ($15/mo) or higher.

Audit multiple URLs in one call. Requires Starter plan ($5/mo) or higher. Returns one audit object per URL.

Read the auto-reload setting for AI citation checks and this month's reloads and charges. Read-only: auto-reload is off unless the account owner turns it on, and it can only be turned on or changed from the dashboard (signed in), never through the API or this server, because turning it on authorizes charges.

One-off AI citation check for a brand and one prompt: no tracker, metered per check (one check per engine per sample). Paid plans only (Starter and up).

Build a starter set of prompts to track for AI citations, from a topic plus optional brand, competitors and audience. Fixed templates, not a model: no AI check is spent. Works on every plan and is not metered. Returns prompts, ready to pass to create_citation_tracker.

Suggest AI-citation prompts to track, read off what a site says it does (fetches the site's pages). Use the result with create_citation_tracker.

Create a one-time Stripe Checkout link for a pack of top-up citation checks and return its URL. Paid plans only. This charges nothing: the user must open the link and pay by card, and the checks are added when the payment completes. Get the pack keys and prices from citation_topups first.

Top-up packs for AI citation checks (packs is the live list with prices) and this account's balance. Top-up checks are spent only after the plan's monthly allowance, do not reset on the 1st, and expire 12 months after purchase. can_buy is false on the free tier.

Timeseries of mention rate, citation rate, share of voice and average position for a citation tracker.

Compare 2-5 URLs side by side with a structured diff: each URL's score and category breakdown plus who is ahead and by how much, per category and per URL pair. Requires Basic plan ($15/mo) or higher.

Head-to-head SEO comparison of your page against a competitor's page with keyword-relevance scoring. Requires Pro plan ($39/mo) or higher.

Score how well a page turns a visitor into a lead or a sale: headline, call to action, trust, forms and objections, each 0-100, with a prioritized fix list. It does not measure the actual conversion rate. Counts as one audit. Free keys get the scores and the first two priorities; paid plans get the full list.

Crawl one site and wait for the result: follows same-site links plus the sitemap and reports broken pages, redirects, duplicate titles and headings, pages missing a title or heading, orphan pages and slow pages. Pro: 25 pages per crawl, 20 crawls a month. Ultra: 100 pages, 100 crawls a month. Any other plan: one Deep Audit credit covers a 25-page crawl. A failed crawl is not counted. For long waits use start_crawl + get_crawl.

Track a brand's visibility in AI answers (ChatGPT, Gemini, Perplexity, Claude): mention rate, citation rate, share of voice and position over time. Requires Starter ($5/mo) or higher. Monthly allowance (checks / tracked prompts): Starter 150 / 15, Basic 500 / 30, Pro 1,500 / 75, Ultra 4,000 / 200. A check is one prompt on one engine, sampled once. With no prompts, pass starter and a starter set is generated to fit the plan.

Run a Deep Audit — a thorough, AI-assisted SEO audit that scores a URL across 9 dimensions (technical, crawlability, content/entity, Core Web Vitals, technical SEO, structured data, security, media, off-site): thousands of catalog checks plus up to 150 AI checks. Runs asynchronously server-side; this tool waits for the result (about 90 seconds once it starts, longer if queued). Included on Pro ($39/mo, 20/month) and Ultra ($99/mo, 100/month); other keys spend a purchased Deep Audit credit. For long waits use start_deep_audit + get_deep_audit instead.

Deep Audits used and remaining this calendar month for the API key in use.

Stop tracking a brand. Run history is kept until its retention expires.

Run a GEO (Generative Engine Optimization) audit: 26 checks measuring how visible a page is to LLMs. Requires Basic plan ($15/mo) or higher; uses the plan's monthly GEO allowance.

Probe LLMs to measure how often a brand is mentioned in AI responses. Requires Basic plan ($15/mo) or higher; uses the plan's monthly GEO allowance. Can take a while.

Score history for one GEO monitor, newest first, paginated.

A citation run's status plus every per-prompt, per-engine result (mentioned, cited, position, snippet).

Read one citation tracker: brand, domains, prompts, engines, competitors, cadence and webhook.

Get a site crawl's status: queued, running (pages_done counts up), completed (result: summary, issues, pages, links) or failed (error). Only the key that started a crawl can read it.

Get a Deep Audit job's status: queued (queue_position, eta_seconds), running (progress 0-100, stage), completed (result) or failed (error). Poll every 5-10 seconds.

Fetch the audit-score history for a URL. Returns a time-series of past scores so you can see trends. Requires Starter plan ($5/mo) or higher.

List every domain audited by this API key with the latest score and 30-day trend. Starter+.

List the key's citation trackers plus usage: the month's checks (limit, used, remaining), the top-up balance and checks_available (what a run can spend now).

List the active GEO monitors for the API key in use.

List all URLs currently under score monitoring for the active API key.

Generate an llms.txt file for a domain and return its text, ready to save at /llms.txt. Basic plan ($15/mo) and higher get the curated version with per-page descriptions; other keys (or no key) get the basic version.

Find the page-2 quick wins in the user's own Google Search Console data: queries ranking 11-20 worth working on first, each with an opportunity score and an estimate of the extra clicks from moving onto page 1. The API does not connect to Search Console: pass the exported rows or the CSV export text. Nothing is stored. The click numbers are estimates. Works on every plan; counts as one audit. Up to 1 MB per request.

Stop a GEO monitor by its URL. Past history is kept.

Stop score monitoring for a URL. Its past history is kept.

Return the public, shareable HTML report URL for a domain (https://seoscoreapi.com/report/{domain}). Useful for sending results to a client without exposing an API key. Makes no request and uses no quota.

Run a citation tracker now. Every prompt x engine x sample counts as one check. A run needs all of its checks up front (the month's remaining allowance plus any top-up balance); if that is short the run is refused and nothing is spent. A check whose engine returned an error is not counted. A run that takes over 45 seconds returns {run_id, status: "running", poll} instead of the summary; it keeps running, so call get_citation_run with that run_id until status is completed.

Start a site crawl and return immediately with a job_id and a shareable site_map link. Poll it with get_crawl. Same plans as crawl_site.

Queue a Deep Audit and return immediately with a job_id. Poll it with get_deep_audit. Same plans as deep_audit.

List the third-party trackers and pixels a page loads (analytics, advertising, session replay, chat, marketing automation, A/B testing, monitoring), including pixels a tag manager injects. Loads the page in a real browser with no interaction; it does not determine whether a tracker waited for consent, and it is not legal advice. Counts as one audit; a page that can't be loaded is not counted.

Edit a citation tracker's prompts, engines, competitors, samples, cadence or webhook. Only the fields passed change.

Get the current plan, monthly usage, and remaining quota for the API key in use.