SEO Score API

SEO Score API

Quickstart 1. Get a free API key. 20 audits a month, no card. Sign up at [seoscoreapi.com](https://seoscoreapi.com/#signup) (enter your email, type the…

Developer tools#development

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

Quickstart

1. Get a free API key. 20 audits a month, no card. Sign up at seoscoreapi.com (enter your email, type the 6-digit code we send, and the key appears), or do the same over the API:

curl -s -X POST https://seoscoreapi.com/signup -H "Content-Type: application/json" -d '{"email": "you@example.com"}'
# {"status": "verification_required", "message": "Check your email for a 6-digit verification code."}

curl -s -X POST https://seoscoreapi.com/verify -H "Content-Type: application/json" -d '{"email": "you@example.com", "code": "123456"}'
# {"api_key": "ssa_…", "tier": "free", ...}     console.log(fix.severity, fix.plain_english));

No SDK? Any HTTP client works: every endpoint is plain JSON over HTTPS. To try a call here, click Authorize, paste your key, then Try it out on any operation.

3. Read the result. score (0-100) and grade, the per-category breakdown in audit, and priorities: the fixes, most important first, each with a jargon-free plain_english sentence and who_fixes_it. The full response is under GET /audit below, with an example.

Authentication

Every endpoint except /signup, /verify and /health needs your key in the X-API-Key header. Keys are per account; rotate one with POST /rotate-key (the old key stops working at once) or from your dashboard. A missing or wrong key is 401; repeated wrong keys from one address are refused with 429 for a while.

Base URL and format

https://seoscoreapi.com, HTTPS only. Requests and responses are JSON (Content-Type: application/json on bodies), except GET /audit/export (a file) and GET /llms-generator (plain text). Timestamps are UNIX seconds. Scores are 0-100 unless a field says otherwise.

Plans and limits

PlanPriceAudits / monthRequests / minADA audits / moGEO audits / moCompetitive / moAI citation checks / moHistory kept
Free$0/mo2020000none
Starter$5/mo2001050015030 days
Basic$15/mo1,00030201050090 days
Pro$39/mo5,000601005501,500365 days
Ultra$99/mo25,000120500102004,000unlimited
Scale$249/mo100,00030015002550010,000unlimited

Audits reset on the 1st of the month at 00:00 UTC. Paid plans add the full check detail and all priorities (free keys see 2 checks per category and the top 2 fixes), batch audits, SXO/AEO/AIO scores, history, monitoring and more; each operation below says which plan it needs and what it counts against. Pricing, annual billing (2 months free) and Enterprise: seoscoreapi.com/#pricing. GET /usage shows what you have left.

Errors

Errors are JSON with a human-readable detail string. When the page you asked us to audit is the problem, there is also a machine-readable reason:

{"detail": "Could not resolve hostname: no-such-host-for-docs.invalid", "reason": "dns"}
StatusMeaning
400Bad body or parameter. reason: invalid_url (not an http(s) URL) or blocked_url (a private or internal address) when we refuse the URL itself.
401Missing or invalid X-API-Key.
402No Deep Audit allowance or credit left (Deep Site Audit). detail says where to buy a credit pack and links a one-click upgrade.
403Your plan doesn't include this, or this month's allowance for the feature is used up. detail names the plan that includes it (or the next one up), its price, and your account's one-click upgrade link; on Scale, the top plan, it points at Enterprise.
404Unknown id, or one that belongs to another key.
413Body over the endpoint's size limit.
422The page couldn't be loaded. reason: dns, timeout, tls, unreachable, blocked (the site refused our server: see our bot page), not_found, http_error, non_html, unreadable, load_failed. Also FastAPI's validation shape (detail is a list) when a required parameter is missing.
429Rate or quota limit; see below.
502 / 504The failure was on our side, or the audit ran past 45 seconds. Retry.

Failed audits are not billed. A 422, 502 or 504 on an audit is removed from your usage, as is an audit your client hung up on.

Rate limits

  • Per plan: the requests per minute in the table above, across audit endpoints. Over it: 429 with detail.
  • Per month: the plan's audits. Out of them: 429 with detail saying when they reset and what the next plan costs.
  • Per endpoint: some endpoints have their own ceiling (for example POST /signup 5/minute, POST /quick-wins 20/minute, GET /audit/accessibility 20/minute and 2 at a time per key). These answer 429 with error (not detail) plus Retry-After…

Endpoints 50

Getting started

  • POSTStart signup (emails a 6-digit code)/signupPlan: None needed · Counts as: nothing Start signup: send a verification code to your email. Send JSON: {"email": "you@example.com"}
  • POSTFinish signup and get your API key/verifyPlan: None needed · Counts as: nothing Complete signup: verify your code and get your API key. Send JSON: {"email": "you@example.com", "code": "123456"}
  • GETUsage and limits for this key/usagePlan: Every plan · Counts as: nothing What this key has used and has left: audits today and this month, the plan's limits, the GEO, ADA and competitive…
  • POSTUpgrade to a paid plan (Stripe Checkout)/upgradePlan: None needed · Counts as: nothing Create a Stripe Checkout session to upgrade your plan. Send JSON: {"email": "...", "tier": "basic", "interval":…
  • POSTRotate your API key/rotate-keyPlan: Every plan · Counts as: nothing Rotate your API key. Send your CURRENT key as X-API-Key; the response carries the new one. The old key stops working…

Audits

  • GETAudit one URL/audit?url=https://www.northsideplumbing.com/Plan: Every plan (free keys get 2 checks per category and the top 2 fixes) · Counts as: 1 audit Run a comprehensive SEO audit on any URL. Returns an overall…
  • GETAudit one URL as a PDF, Markdown or CSV report/audit/export?url=https://www.northsideplumbing.com/&format=pdfPlan: Every plan; white-label options Pro, Ultra and Scale · Counts as: 1 audit Run an audit and download it as a PDF, Markdown or CSV report. Same audit,…
  • POSTCompare 2-5 URLs side by side/comparePlan: Basic and up · Counts as: 1 audit per URL Compare 2–5 URLs side by side with a structured diff. Returns each URL's score + category breakdown plus a…
  • POSTAudit up to 10 URLs in one call/audit/batchPlan: Starter and up · Counts as: 1 audit per URL Audits each URL in turn and returns one result per URL, in the order sent. Each result is the same report as…
  • POSTHead-to-head audit against a competitor for one keyword/audit/competitivePlan: Pro and up · Counts as: 1 competitive audit (Pro 50/month, Ultra 200/month, Scale 500/month) Head-to-head SEO comparison with keyword-relevance scoring.…

Page analysis

  • GETAI readability score for one URL/ai-readability?url=https://www.northsideplumbing.com/Plan: Every plan · Counts as: 1 audit Score how well a page can be consumed by AI/LLM systems. Requires an API key.
  • GETTrackers and pixels a page loads/trackers?url=https://www.northsideplumbing.com/Plan: Every plan · Counts as: 1 audit List the third-party trackers and pixels a page loads. Loads the page in a real browser, waits a few seconds, and…
  • GETConversion score for one page/conversion?url=https://www.northsideplumbing.com/Plan: Every plan (free keys get the first 2 fixes) · Counts as: 1 audit Score how well a page turns a visitor into a lead or a sale. Reads the page's HTML…
  • GETADA / WCAG 2.1 AA accessibility audit/audit/accessibility?url=https://www.northsideplumbing.com/Plan: Starter and up · Counts as: 1 ADA audit (own monthly allowance: Starter 5, Basic 20, Pro 100, Ultra 500, Scale 1,500) Run an ADA / WCAG 2.1 AA…

Site crawl

  • POSTStart a multi-page site crawl (async)/crawlPlan: Pro (25 pages, 20 crawls/month), Ultra (100 pages, 100/month) and Scale (100 pages, 250/month); other plans spend a Deep Audit credit · Counts as: 1…
  • GETPoll a site crawl/crawl/:job_idPlan: The key that started it · Counts as: nothing Poll a site crawl. status is queued, running, completed or failed. While running, pages_done counts up.…

Deep Site Audit

  • POSTStart a Deep Site Audit (async)/site-auditPlan: Pro (20/month), Ultra (100/month) and Scale (250/month); other plans spend a Deep Audit credit · Counts as: 1 Deep Site Audit Queue a Deep Site Audit of…
  • GETDeep Site Audit quota for this key/deep-audit/usagePlan: Every plan · Counts as: nothing Deep Site Audits used and remaining this calendar month (UTC) for this key. Separate from GET /usage, which reports the…
  • GETPoll a Deep Site Audit/site-audit/:job_idPlan: The key that started it · Counts as: nothing Status of a Deep Site Audit: queued (with queue_position and eta_seconds), running (with progress 0-100 and…

GEO / AI search

  • GETGenerate an llms.txt for a domain/llms-generator?domain=northsideplumbing.comPlan: No key needed; Basic and up get the curated version · Counts as: nothing Generate an llms.txt file for any domain. Free / no-key: basic version. Basic…
  • GETGEO audit: how visible a page is to AI assistants/geo/audit?url=https://www.northsideplumbing.com/Plan: Basic and up · Counts as: 1 GEO audit (Basic 1/month, Pro 5, Ultra 10, Scale 25) Run a GEO (Generative Engine Optimization) audit — 26 checks measuring…
  • POSTHow often AI models mention your brand/geo/brand-probePlan: Basic and up · Counts as: 1 GEO use (shares the GEO monthly allowance) Probe LLMs to measure how often your brand is mentioned in AI responses. Requires…
  • POSTCreate a GEO monitor/geo/monitorPlan: Basic and up · Counts as: nothing (runs use the GEO allowance) Create a GEO monitor for a URL. Requires Basic plan or higher. Send JSON: {"url":…
  • DELETERemove a GEO monitor/geo/monitorPlan: Basic and up · Counts as: nothing Stops the GEO monitor for a URL. Send JSON: {"url": "https://www.northsideplumbing.com/"}.
  • GETList GEO monitors/geo/monitorsPlan: Basic and up · Counts as: nothing Every active GEO monitor on this key: URL, frequency, alert threshold, webhook and the last score and check time.
  • GETScore history for a GEO monitor/geo/monitor/:monitor_id/historyPlan: Basic and up · Counts as: nothing The GEO scores a monitor has recorded, newest first, paginated with page and per_page (max 100).

AI Citations

  • GETList citation trackers and this month's checks/citations/trackersPlan: Every plan · Counts as: nothing List this key's citation trackers. usage reports the month and any top-up: checks_limit, checks_used and…
  • POSTCreate a citation tracker/citations/trackersPlan: Starter and up · Counts as: nothing until it runs Track a brand's visibility in AI answers. Requires Starter ($5/mo) or higher. Send JSON: {"brand":…
  • GETRead one tracker/citations/trackers/:tracker_idPlan: Every plan · Counts as: nothing One tracker's settings and its latest run summary: mention rate, citation rate, share of voice and average position,…
  • DELETEDelete a tracker/citations/trackers/:tracker_idPlan: Every plan · Counts as: nothing Stop tracking a brand. Run history is kept until its retention expires.
  • PATCHEdit a tracker/citations/trackers/:tracker_idPlan: Every plan · Counts as: nothing Change a tracker's prompts, engines, competitors, domains, samples, cadence or webhook. Send only the fields to change;…
  • POSTRun a tracker now/citations/trackers/:tracker_id/runPlan: Starter and up · Counts as: 1 citation check per prompt × engine × sample Run a tracker now. Every prompt × engine × sample counts as one check. A run…
  • GETRead a run and its results/citations/runs/:run_idPlan: Every plan · Counts as: nothing Run status plus every per-prompt, per-engine result.
  • GETTracker history over time/citations/trackers/:tracker_id/historyPlan: Every plan · Counts as: nothing One point per completed run in the last days (1-365, default 90): mention rate, citation rate, share of voice and…
  • POSTOne-off citation check (no tracker)/citations/checkPlan: Starter and up · Counts as: 1 citation check per engine × sample One-off check — no tracker, metered per check. Paid plans only (Starter and up). Send…
  • GETTop-up packs and balance/citations/topupsPlan: Every plan · Counts as: nothing Top-up packs for AI citation checks, and this account's balance. A top-up is a one-time purchase for when the month's…
  • POSTBuy a top-up pack (Stripe Checkout)/citations/topups/checkoutPlan: Starter and up · Counts as: nothing Start a one-time Stripe Checkout for top-up checks. Paid plans only. Send JSON: {"pack": "500"} (500 checks, $10) or…
  • GETAuto-reload setting (read-only)/citations/auto-reloadPlan: Every plan · Counts as: nothing Auto-reload setting for AI citation checks, and this month's use. Read-only. Auto-reload is off unless you turn it on,…
  • GETStarter prompts to track/citations/prompts/starter?topic=emergency plumber in SpringfieldPlan: Every plan · Counts as: nothing (not metered) A starter set of prompts to track, from your topic, brand, competitors and audience. Covers the six kinds…
  • GETSuggest prompts from a website/citations/prompts/suggest?domain=northsideplumbing.comPlan: Every plan · Counts as: nothing (not metered) Reads the site's home page (title, description, headings) and suggests prompts a buyer might ask an AI…

Monitoring & history

  • GETAudit history for one URL/history?url=https://www.northsideplumbing.com/Plan: Starter and up · Counts as: nothing Every audit this key has run on the URL (oldest first, up to limit), with a summary: first and latest score, the…
  • GETEvery domain this key has audited/history/domainsPlan: Starter and up · Counts as: nothing List every domain this key has audited with latest score and 30-day trend. Requires Starter plan ($5/mo) or higher.
  • GETList score monitors/monitorsPlan: Every plan (Free 1 monitor, Starter 5, Basic 10, Pro 25, Ultra 50, Scale 150) · Counts as: nothing Every active score monitor on this key: URL,…
  • POSTCreate a score monitor/monitorsPlan: Every plan (Free 1 monitor, Starter 5, Basic 10, Pro 25, Ultra 50, Scale 150) · Counts as: nothing Re-audits a URL daily or weekly and alerts you when…
  • DELETERemove a score monitor/monitorsPlan: Every plan (Free 1 monitor, Starter 5, Basic 10, Pro 25, Ultra 50, Scale 150) · Counts as: nothing Stops monitoring a URL. Send JSON: {"url":…
  • PUTOpt in to (or out of) the public scoreboard/scoreboard/opt-in?opt_in=truePlan: Every plan · Counts as: nothing Opt this key's audits in to the public SEO scoreboard, or back out. The scoreboard is opt-in: by default no audit lists…
  • PUTLegacy scoreboard switch/scoreboard/opt-out?opt_out=truePlan: Every plan · Counts as: nothing Legacy switch, kept for existing SDK and n8n calls; use PUT /scoreboard/opt-in. The scoreboard is opt-in, so audits are…

Search data

  • POSTPage-2 quick wins from your Search Console export/quick-winsPlan: Every plan · Counts as: 1 audit Find the page-2 quick wins in your Search Console data. Send your own Search Console rows and get back the queries…
  • GETObserved backlinks for a domain/backlinks?domain=northsideplumbing.comPlan: Basic and up · Counts as: nothing Return observed backlinks for a target domain. Audit-fed dataset: every audit run by SEO Score API customers…

Status

  • GETLiveness check/healthPlan: None needed · Counts as: nothing Returns ok and the server time while the API process is up. Full status and history: https://seoscoreapi.com/status

API details

Authentication
An API key in the X-API-Key header
Operations
50 operations on 44 pathsGET 27POST 17DELETE 3PUT 2PATCH 1
Main resources
AI Citations 14GEO / AI search 7Monitoring & history 7Audits 5Getting started 5Page analysis 4Deep Site Audit 3Search data 2Site crawl 2Status 1
Response formats
application/json application/pdf text/csv text/markdown
Description format
OpenAPI 3.1.0, API version 1.0.0

How to test the SEO Score API in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the SEO Score API collection, without the publisher's secrets.
  3. Add your credentialsThis API uses an API key in the X-API-Key header. Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Start signup (emails a 6-digit code)” (POST /signup), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the SEO Score API?

Quickstart 1. Get a free API key. 20 audits a month, no card. Sign up at [seoscoreapi.com](https://seoscoreapi.com/#signup) (enter your email, type the… It is listed under Developer tools and has 50 endpoints.

Who publishes the SEO Score API?

It is listed from SEO Score API's public API description (an OpenAPI document), not published by SEO Score API on Swastik Codes. Anyone who controls seoscoreapi.com can claim the profile by adding a DNS TXT record.

How do I authenticate with the SEO Score API?

With an API key in the X-API-Key header.

How many endpoints does the SEO Score API have?

50 operations on 44 paths (27 GET, 17 POST, 3 DELETE, 2 PUT, 1 PATCH). The largest groups are AI Citations, GEO / AI search, Monitoring & history, Audits.

Is forking the SEO Score API free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.