SEO Dashboard API

Run a heuristic WCAG/ADA audit against a page's HTML and report scored, weighted checks.

Fetch the top 50 backlinks for a target domain or URL.

Fetch the top 50 organic keywords a target domain or URL ranks for.

Fetch domain-level overview metrics (DR, traffic, organic keywords) from the configured SEO provider.

Fetch a page and ask the LLM for three optimized title and three optimized description alternatives.

Recent dropout alerts: prompt × engine combinations where the brand was previously cited and has gone absent for a streak of runs. Lookback window in days.

Per-prompt breakdown for a single engine plus the top competitors gaining mentions there. Use this to find specific prompts where the brand is absent or losing ground on a given engine.

Compare current vs prior rolling window (default 28 days) per engine. Returns score deltas, share-of-voice band shifts, and per-(prompt × engine) dropouts where the brand fell from primary/mentioned to passing/absent. Use this for any 'why did our share-of-voice drop?' question.

Per-engine run history for a single prompt, including position outcome and cost. Use to inspect a specific prompt's trajectory after the period-compare or dropouts tools surface it as a problem area.

Site-wide AI Visibility roll-up: per-engine visibility score + score band (subject-only, not competitor-relative share of voice), prompt counts, and last run timestamps. Use this first to get the lay of the land before drilling into a specific engine. For competitor-relative share of voice, use ai_visibility_period_compare.

Toggle an alert (enabled flag) or update its threshold by alert_type.

List alert settings and the most recent 50 alert log entries.

Fetch the daily-stats time series (visitors/pageviews/bounce/duration) for a site over a range.

Fetch the pageview time series from the configured analytics provider, bucketed by day or hour.

Fetch current-visitor / current-pageview metrics from the analytics provider. Uncached.

List all sites/properties known to the configured analytics provider.

Fetch summary stats (visitors, pageviews, bounce rate) from the configured analytics provider.

Classify <a> anchor texts on a page (Branded, Exact Match, Generic, Naked URL, etc.) and return a distribution.

Site-wide anchor-text analysis from the latest crawl: top anchors, over-optimization candidates, empty/naked anchors, rel distribution.

Discover pages via sitemap, scan their links, and report broken/redirected/unreachable URLs. Streams progress.

HEAD-probe up to 50 URLs in parallel and return per-URL status + a histogram summary.

Verify canonical tags and detect chain issues.

Wipe the API response cache. Forces the next call from any cached endpoint to fetch fresh.

Pull the top-10 SERP for a keyword, analyze each page, cross-reference user's GSC position, and ask the LLM for competitive analysis.

Compute readability + keyword density on a URL or pasted text, with optional LLM-suggested improvements.

Generate a structured SEO content brief for a keyword (titles, meta, heading outline, topics, questions). Can also write the article from the brief.

Compare two sites' sitemaps + sample pages and ask the LLM for verified content gaps the target site is genuinely missing.

Generate 10 new content ideas the site doesn't already cover, grounded in GSC queries + the crawl inventory.

Create a scheduled agent run. Either recipients[] or channel+channel_identifier is required for delivery.

Remove a scheduled agent run by id.

Run intent-qualified SERP queries, summarize each candidate page, and ask the LLM to score outreach prospects.

Resolve every DNS record type for a domain and surface email-security and infrastructure gaps.

Fetch a domain's Ahrefs Domain Rating (DR, 0-100). Free, no API key required; works for any domain including competitors. Returns null when DR is unavailable.

Fetch a prospect URL and write a personalized cold outreach email that quotes concrete details from the article.

List pages on the site that have no internal inbound links (orphan pages).

Find pages on the site that are semantically similar to a given seed page (uses embeddings).

Pull GSC keywords in striking-distance positions, score opportunity, and ask the LLM for per-keyword optimization recommendations.

Hydrated topical cluster: queries, pages, gap topics, and the pillar page for the cluster.

Cross-source consensus on (subject, predicate). With predicate=null, returns consensus for every predicate on the subject.

Value history for one (subject, predicate) pair. Useful for 'how has X changed over time' questions.

Per-source fact counts and last-observed timestamps for the site's fact ledger.

Site-wide link distribution: top outbound/inbound pages and orphan count from the latest crawl.

Open internal-linking suggestions for the site, optionally scoped to a single source page URL.

Get full page detail (title, h1, meta, status, etc.) for a specific URL. Pass includeBody=true to get the page text.

Inbound internal links pointing at a page. Useful to understand a page's authority within the site.

Outbound links (internal + external) from a page.

List the site's currently-indexed pages from the latest crawl, with optional filter (noindex / errors / slow).

Summary of a topical map's clusters (name, authority, query/page counts).

Measure HTTP response time from up to 20 worldwide nodes via check-host.net and report per-region stats.

Query SerpAPI's Google Trends engine; BYOK keys skip metering, platform keys are gated by tenant SERP allocation.

Check heading structure (H1-H6) of any page and find issues.

Fetch a URL and report every response header plus security-header coverage.

Analyze internal vs. external links on a page, including nofollow/sponsored/ugc, generic anchors, and density.

Ask the LLM for 25 keyword suggestions, 3-5 clusters, 8-10 PAA questions, and 8-10 long-tail variants for a seed keyword.

List contradictions in the fact ledger. Filter by status (open/noise/meaningful/fixed/all) and predicate.

List scheduled agent runs, optionally filtered by status and siteId.

List the topical maps generated for a site, including cluster count and gap count per map.

Model Context Protocol (Streamable HTTP transport). JSON-RPC requests; the same Bearer key + per-key scopes + per-key rate limit as /api/v1. See https://spec.modelcontextprotocol.io for the message format.

List every callable tool in the registry.

Fetch a URL and extract its meta tags (title, description, canonical, OpenGraph, Twitter, JSON-LD, hreflang, word count).

Inspect Open Graph + Twitter card tags and verify the og:image is reachable.

Run Google PageSpeed Insights v5 against a URL and return Lighthouse scores, Core Web Vitals, and per-category audits.

Add a keyword to the position tracker for a site. Keyword is lowercased and trimmed; duplicates are rejected.

Stop tracking a keyword. Cascades to position_history.

List the keywords tracked for a site, with the latest known position and a 30-point history.

Read current valid facts about a subject from the bi-temporal ledger. Omit subject for the recent-activity feed.

Record a user-asserted fact about a subject. Source is always agent_msg with the optional conversationId tracking provenance. Triggers contradiction detection.

Walk a URL's redirect chain hop-by-hop with per-hop SSRF validation, surfacing 301/302 mix issues, long chains, and timing.

Regenerate a topical map for a site: fetches GSC queries, clusters them with the LLM into 4-8 pillars, and surfaces 5-8 gap topics.

Mark a contradiction as noise (auto-flapping), meaningful (real conflict), or fixed (the underlying data has been corrected).

Fetch and parse robots.txt, validate every Sitemap URL, surface common issues, and optionally test if a URL is blocked.

Fetch country-bucketed clicks/impressions rows from Search Console.

Fetch the daily clicks/impressions time series from Search Console.

Fetch device-bucketed clicks/impressions rows from Search Console (mobile/desktop/tablet).

Fetch Search Console overview metrics (total clicks, impressions, avg position, avg CTR) for a site over a date range.

Fetch top-page rows from Search Console for a site over a date range.

Fetch top-query rows from Search Console for a site over a date range.

Keyword search (FTS5) over the site's crawled title/h1/body. Use this for 'what's on my site about X' questions; works without embeddings.

Embedding-based search over the site's crawled content. Falls back to a hint when the site isn't embedded yet.

Crawl up to 1000 pages, extract per-page SEO data, score the site, and ask the LLM for prioritized recommendations. Streams progress.

List stored SEO briefings for a site (most recent first).

Fetch the live SERP for a keyword and have the LLM extract what top-ranking pages share (content type, headings, key topics, intent, difficulty).

Add a new site to the dashboard. Triggers onboarding checks + favicon fetch + analytics auto-link in the background.

Soft-delete a site (sets deleted_at). Pass restore=true to undo a prior soft delete.

Fetch a sitemap (or sitemap-index), parse every URL, follow sub-sitemaps, surface freshness/dup/size issues, and HEAD-probe a sample.

List all sites the tenant has added to the dashboard, with crawl config and analytics linkage.

Streaming variant of broken_links. Crawls the site's sitemap, then HEAD-probes every link, emitting per-page-progress and per-link-progress chunks before the final result.

Streaming variant of seo_audit. Discovers URLs, crawls in batches, aggregates metrics, scores, and emits SSE events for each phase.

Extract and parse JSON-LD structured-data blocks from a page.

Cluster the site's GSC queries into topical pillars, rate each cluster's authority (strong/moderate/weak), and surface 5-8 gap topics with target keywords.

Patch any field on a scheduled agent run by id.

Hit a URL three times sequentially and report status + per-request timing + min/avg/max + first-response headers.

Last N uptime checks for a monitor (descending by checked_at).

Create an uptime monitor for a URL. Validates the URL for SSRF, picks a sane interval (1/5/15/30/60 min).

Soft-delete an uptime monitor. Pass restore=true to undo.

Update an uptime monitor: toggle active, change interval, rename, change URL, update notify channels.

List uptime monitors with rolling 24-hour up-stats.