July 19, 2026
JSON-API v1 · Devs
JSON API v1 for devs — Rankmio data from Claude Code, Cursor and CI
The JSON export now has an HTTP twin. Three endpoints under <code>/api/v1/</code> give AI coding agents (Claude Code, Cursor, Aider) and CI pipelines access to the same SEO and GEO data as the browser download — with a bearer token, no CSRF, no cookie. Discovery endpoints are free, the export costs the same 2 credits as in the browser. Managed in the profile.
Three endpoints, one bearer
GET /api/v1/projects — lists all projects the key can see (id, domain, name, created_at). Discovery for agents that do not know your project layout yet. 0 credits.GET /api/v1/projects/{id} — meta and available blocks per project: which of the 12 blocks have data, count of records and estimated bytes per block. Lets an agent decide the export scope before it costs anything. 0 credits.GET /api/v1/projects/{id}/export?blocks=… — the actual snapshot in the exact same shape as the browser JSON download. 2 credits per call, price is dynamic from CreditService.
Auth, limits and abuse protection
- API keys under
Profile → API keys: create, rotate, revoke. The plaintext key (rmk_…) is shown once and stored only as a SHA-256 hash — industry standard (GitHub, Stripe, OpenAI). Prefix plus last four characters remain visible for identification.
- Rate limit 60 requests per minute + 1000 per day per key. On top a daily charge cap (default 200 credits per key per day) — a leaked key cannot drain your balance. Response headers
X-RateLimit-Remaining-* and X-Charge-Used-Cr tell every pipeline where it stands.
- Error responses follow HTTP conventions:
401 unauthorized, 402 insufficient credits, 403 forbidden (IP/project scope), 404 project not accessible, 429 rate or charge limit hit. Every call is logged in api_key_usage — including failures, for auditing.
- Full workflow in the insights piece „Why Claude Code only reaches its full potential with SEO and GEO context" — including curl examples and a Claude Code slash command.
- Typical use cases: CI pipeline pulls a snapshot before deploy and asserts no GEO regression; Claude Code slash command loads the export and opens PRs per finding; cron job diffs weekly snapshots for a Slack digest.
- MCP server (Model Context Protocol) is on the roadmap but not shipped yet — the JSON API covers 90 % of the agent use cases already.
July 14, 2026
GEO · Actions · Bulk-Workflow
AI Champions, Traffic Recovery, Actions master list and a new Bing Copilot tracker mode
Four new panels that together show where Rankmio has impact: <strong>/geo/ki-champions</strong> finds pages AI systems cite while Google does not rank them — your most profitable backlink targets. <strong>/traffic-recovery</strong> splits GSC keywords with impressions but no clicks into three action buckets by position range. <strong>/actions</strong> becomes the consolidated todo master list across all data sources (GEO, GSC, Bing, Backlinks, Competitors, AI Champions) — with URL filter in the Dashboard style. Plus, the citation tracker gets a third mode that mirrors real Bing Copilot queries into the watchlist.
AI Champions — a new Rankmio USP
- New route
/geo/ki-champions — cross-source detector: URLs on your domain that Bing Copilot has cited at least 3 times in real user queries, while Google either does not rank them or ranks them poorly. Combines bwt_ai_performance with gsc_keyword_data.
- Three categories: Hidden (Bing cites, Google has no impressions), Page 5+ (Pos 30+ — highest ROI for backlink outreach), Page 2-3 (Pos 20-29 — often 1-2 backlinks away from Top 10). Champion score combines citation strength (log-scaled) with position penalty.
- Why this matters: content the AI has already validated has proven quality signals. Investing in classic SEO (backlinks, internal linking, snippet) on these exact pages pays back fastest — much better than promoting random pages without validation.
Traffic Recovery — 3 buckets by position
- New route
/traffic-recovery replaces the vague „CTR emergency" concept. Splits GSC keywords with impressions but few clicks into three actionable buckets based on Google position.
- Position 1-10 — snippet tuning: keywords already in the Top-10 but with CTR below the position baseline (Advanced Web Ranking 2024). Shows baseline vs. actual CTR and the potential click gain if the baseline were reached.
- Position 11-30 — rankings push: close to Top-10, hitting the ranking sweet spot. Action: backlinks, internal linking, content refresh. Position 31+ — rewrite or deprioritize: too far to fix with snippet or link work. Either content rewrite or drop the keyword.
Actions — the consolidated todo master list
- New route
/actions merges the ~400 on-the-fly Dashboard-Todos (competitor, battle, GEO audit, sitemap, broken links, site audit) with the auto-generated feeder todos (Bing coverage, GEO, GSC traffic, backlinks, AI champions, cannibalization, sweet spot). One list, one place — the Dashboard timeline and Site-Audit chart remain untouched.
- Filters: status (open/completed/dismissed/all), priority (high/medium/low), type chips (GEO, GSC, Bing, Backlinks, Sitemap, Site-Audit, Competitors, AI Plan, AI Champion, Local), URL filter with search-as-you-type (identical to the Dashboard picker), full-text search across title and detail. All filters are bookmarkable via query params.
- Complete + Dismiss: „Complete" writes into
todo_completions — the Dashboard timeline picks it up automatically. „Dismiss" hides a feeder todo from the Open list; the next sync respects the user intent and does not recreate it.
- Two new detectors: Cannibalization flags URLs with ≥20 keywords stuck on Pos 30+ (Google cannot decide which keyword to prioritize — fix via targeted internal linking). Sweet Spot Top-10 flags URLs whose primary keyword ranks Pos 4-10 — a single backlink or meta refresh could push them into Top-3.
Citation Tracker: Bing Copilot mode
- Third source-mode next to „GSC Top-N" and „Manual watchlist": Bing Copilot Queries. Automatically mirrors the real user queries from the Bing Copilot report (via CSV upload) into the 5-engine probe watchlist.
- Why: the classic GSC-Top-N watchlist probes queries you rank for on Google — not necessarily the questions AI systems actually ground with. The Bing-Copilot mode probes the exact queries with a proven citation history. Cite rate is significantly higher than the GSC-based watchlist.
- Setup: In the Citation Tracker, pick the third mode tab („Real Bing Copilot queries") → Configuration → Save. Requires at least one CSV upload in
/geo/bing-ai.
Visibility index: adaptive Bing blend
- The citation sub-score now adapts to the data situation. Default blend stays at 90 % Rankmio tracker / 10 % Bing Copilot — but if the Rankmio cite rate is under 5 % AND Bing Copilot shows strong signals, the weight shifts to 40/60 in favor of Bing. Reason: an under-reporting Rankmio watchlist should not water down real Copilot citations.
- Diagnostic transparency: the visibility export shows
weights_used, adaptive_weight_applied and adaptive_reason — no hidden math.
- Monday morning digest email per project: „What did you complete last week", top-5 high-prio todos, Bing Copilot 7-day delta with arrow, top-3 AI Champions, snippet wins with click potential. Deep links to
/actions, /geo/ki-champions, /traffic-recovery. Beta phase: only for the account owner.
July 11, 2026
Bing WMT · Deep Integration
Bing coverage, IndexNow quota, 30-day chart and 10 % Bing share in the visibility index
Bing gets its own place in the entire Rankmio workflow. Instead of a URL input field for IndexNow, the Sitemap Hub now delivers a full coverage report: for every URL from your latest sitemap crawl you see the Bing status („indexed / known-but-not-indexed / unknown / check pending") — plus one-click submit and bulk selection. The live daily and monthly quota from Bing’s <code>GetUrlSubmissionQuota</code> is prominently shown and disables the submit buttons the moment the quota is exhausted. On top: a 30-day crawl-stats chart, six new Bing tools for the chat agent, and a 10 % Bing share in three sub-scores of the visibility index.
- New coverage view under
/bing-search/{pid}/coverage: table of up to 500 sitemap URLs × Bing indexation status. Five status filters, five KPI tiles with mouseover hints on how to act, bulk-select „all unknowns", per-row submit button.
- Status heuristic: DocumentSize > 0 and LastCrawledDate present → „indexed", any Bing signal (AnchorCount > 0 or LastCrawledDate) but DocumentSize = 0 → „known, not indexed", nothing → „Bing unknown". Cache TTL 24 h per URL — button „Bing-Status aktualisieren" runs up to 40
GetUrlInfo calls per click.
- Sitemap Hub: the old URL input field is gone. In its place a compact CTA card „Open Bing coverage" that jumps straight to the new report.
Live IndexNow quota + auto-lock
- Live quota card at the top of the coverage view: red when daily quota is 0, amber below 20, blue otherwise. Shows daily + monthly balance from Bing’s
GetUrlSubmissionQuota plus how many URLs Rankmio has submitted today.
- Buttons lock automatically when the daily quota hits zero. The bulk submit and every row-level „Submit" turn into a grey „Kontingent leer" chip with a mouseover explaining that Bing resets around midnight UTC. This prevents a stream of HTTP-400 „InvalidApiKey" responses (Bing’s misleading error text for quota-exhausted).
- Solo fallback when the batch endpoint rejects a bulk submit: Rankmio retries each URL individually (Bing sometimes rejects batches with HTTP 400 even though the same URLs go through as solo calls). Response indicates
mode: per_url_fallback or partial so users see what happened.
- Toast feedback — the earlier scroll-dependent banner is replaced by a fixed toast top-right (green success, red error, six-second auto-hide) so results stay visible no matter how far the user has scrolled.
- Line chart in the Sitemap Hub Bing card with three series: Bing crawls (blue, filled), In-Index (green), inbound links (amber). Toggle „Errors" switches to a bar chart of
code_4xx + code_5xx + blocked_by_robots per day. Data grows daily through the health-sync cron.
Visibility index: 10 % Bing share
- Traffic sub-score: 90 % Google clicks (GSC) + 10 % Bing clicks (Bing Search Performance CSV, normalised to a 30-day monthly proxy). Log scale, so 10 Bing clicks don’t swing the total.
- SERP sub-score: Google top-10 ratio blended 90/10 with the impression-weighted Bing top-10 ratio from the Bing top-queries CSV. Count-score (breadth) stays Google-only because the Bing keyword sample is usually much smaller.
- Citations sub-score: 90 % Rankmio citation tracker (ChatGPT/Claude/Gemini/Perplexity/Google AIO) + 10 % Bing Copilot first-party citations (BwtAiPerformance, log-scaled to 500 monthly citations = 100 points). URLs that were literally cited by Copilot users finally count.
- Fallback semantics: no Bing site linked → 100 % Google (external domains unchanged). Only Bing AI Performance available but no Rankmio citation tracker → score reflects only the Copilot view, with a diagnostic note.
Chat agent gets 6 Bing tools
- get_bing_search_performance / get_bing_top_queries / get_bing_top_pages — direct answers to „how is my Bing visibility?", „which queries drive Bing traffic?", „which of my URLs perform best on Bing?"
- get_bing_coverage — Bing indexation status across the current sitemap crawl, with the top-20 unknown URLs when requested.
- get_bing_indexnow_quota — live daily and monthly balance, submissions today, exhausted flag with reset hint.
- get_bing_backlinks — top referring domains and anchors from the Bing WMT backlink CSV, ready for cross-check with the DataForSEO view.
- Auto-preload: as soon as the user’s question contains „bing", „microsoft-suche", „copilot-citation" or „indexnow", the top three tools fire in parallel and land in the LLM context. Answer includes real numbers on the first shot — no extra tool round.
- bing_url_index_sync (04:00) — auto-fills the coverage cache: for every project with a Bing site and a done sitemap crawl, up to 40 URLs are checked via
GetUrlInfo. Cache TTL 24 h, oldest/unchecked URLs first. Result: the coverage view fills up over days without a single user click.
- bing_backlinks_sync (03:30) — the deep-sweep Bing-backlinks script existed but was not scheduled. Now registered daily. Pulls
GetLinkCounts plus GetUrlLinks for the top-20 pages, feeds bing_backlink_snapshots. Skipped when the last sync is younger than 20 h.
- Cron registry updated: the admin cron overview finally lists all three Bing jobs (health-sync, backlinks-sync, url-index-sync) — two were missing.
Bing CSV parser: German headers + DD.MM.YYYY dates
- Bing Webmaster Tools export column headers in the property’s language. The Search Performance CSV parser now recognises German headers (Datum, Klicks, Aufrufe, Durchschn. CTR, Suchanfrage, Seite, Anker …) alongside the English ones and normalises DD.MM.YYYY dates explicitly (strtotime interprets „.” unreliably by locale).
July 8, 2026
AI Visibility · Cross-Engine
Bing Copilot as 6th engine in the Citation Tracker — with multi-engine stars
The Citation Tracker now unifies two data streams in one view: Rankmio probes against ChatGPT/Claude/Gemini/Perplexity/Google AIO (actively measured) and Microsoft first-party citations from Bing Webmaster Tools (passively observed). The new load-bearing signal: URLs cited in <strong>both</strong> worlds get a yellow star — and the Bing card shows „X / Y multi-engine URLs" as its own KPI. No forced aggregate score because the metrics are not directly comparable — instead an honest side-by-side view with clear provenance badges.
What is new in the Overview tab
- New blue Bing-Copilot card between the probe hero and the phrase performance: „🎯 Observed · First-Party" badge, 4 KPIs (30-day citations with delta, cited URLs, grounding queries, multi-engine count) and a deep-link to the full Bing AI dashboard.
- Multi-Engine star on URLs that appear in both data sources — yellow star icon and yellow bar in the URL performance list. That is the trustworthy signal: a URL cited in real Copilot answers AND probed engines is no random hit.
- Context note below the Bing card that clearly separates the two data logics: „probes = we ask engines" vs. „first-party = Microsoft reports what real Copilot users saw". Prevents naive addition of the numbers.
- Empty state (no Bing CSV yet) links directly to the upload — the Citation Tracker becomes the natural entry point for both engines.
- Rankmio probes measure „in X of Y sample queries the domain was cited" (percentage of a controlled sample). Bing first-party measures „N real Copilot citations across all real users" (absolute count of live events). Dividing or averaging them would suggest a precision that is not there.
- Instead: side by side with clear badges („🎯 Observed" vs. „🔍 Probed") and the multi-engine star as the reliable cross-source signal. This stays honest and still delivers the „one place for AI visibility" experience.
July 8, 2026
Backlinks · Bing WMT
Bing WMT cross-check: CSV upload flow now smoother and clearer
The Backlinks Hub gets a UX polish around the Bing Webmaster Tools CSV uploads. Uploading a referring-domains or anchor CSV now keeps you on the active tab, shows a success banner with row and backlink counts, and the blue info bar tells you at a glance when the last upload happened. The Bing view also stands on its own — no DataForSEO snapshot required.
- Tab stays put. After uploading an anchor CSV in the Anchors tab, you land back in the Anchors tab — same for Referring Domains. Before the fix the redirect fell back to „Overview".
- Success banner with counts. Green banner above the tab bar reports „Bing-CSV imported: file.csv: Anchors (6 rows, 248 backlinks)" — so you know immediately what landed in the snapshot.
- Upload date in the blue bar. When Bing data exists, the blue banner above the upload button shows the last upload timestamp plus counts („Letzter Anchors-Upload: 08.07.2026, 15:31 · 6 Anker · 248 Backlinks — neue CSV ueberschreibt die Werte."). Empty state keeps the familiar call-to-action.
Bing-only view without DataForSEO
- The cross-check merge is now built the moment a Bing site is linked — no DataForSEO snapshot required first. Rows that only exist in the Bing CSV are marked
source=bing and rendered like any other row.
- Filter chips (All / Both / Only DFS / Only Bing) work independently of DataForSEO. Uploading Bing anchors alone gives you a complete Bing-only anchor table right away.
July 2, 2026
GEO · Bing AI
Bing AI Performance — import first-party Copilot citations
Bing Webmaster Tools has been shipping an AI Performance report since February 2026 — Copilot citations with grounding queries, intents and topics. Microsoft is the first search platform with first-party AI citation reporting. Since there is no official API yet, Rankmio imports the CSV export from BWT and renders the data in the new dashboard at <code>/geo/bing-ai</code>. The parser handles overview + detail reports and German + English headers.
- Trend chart — Citations and cited pages per day over the last 90 days.
- Top URLs & queries — which of your pages get cited, and which grounding queries Copilot generates to find them.
- Intents & topics — search-intent grouping and topic clusters from the June 2026 BWT update.
- KPI card in GEO Hub — quick view of total citations, 7-day delta and URL count with deep-link to the full dashboard.
- Open Bing Webmaster Tools and switch to the „AI Performance" section.
- Export the report as CSV (both overview and cited-queries formats are supported).
- Upload the CSV under
/geo/bing-ai/upload — parser auto-detects delimiter (comma / semicolon / tab).
- Repeat monthly (or whenever you want fresh data). Old uploads stay accessible in the upload history.
June 30, 2026
UX · Sidebar
GEO as a dedicated main section in the sidebar
GEO is now its own top bucket in the sidebar — placed right after Analyze. All GEO tools live in one spot, ordered as diagnosis → answer simulation → tracking → competition. Previously GEO was hidden as a sub-subgroup inside „Analyze", the Citation Tracker sat under „Monitor", and Battle was filed under „Competitors". URLs are unchanged — only the bucket position in the sidebar has been consolidated.
New GEO bucket — 5 tools, one place
- 1. GEO Audit (
/geo) — full-site GEO scan with topic coverage, AI readiness, schema check.
- 2. Citability Check (
/seiten-analyse) — single-page deep dive on citation readiness (was hidden under „Own Site" before).
- 3. Answer Simulation (
/answer-simulation) — preview how AI engines answer real user questions about your topic.
- 4. Citation Tracker (
/citation-tracker) — continuous citation monitoring across ChatGPT, Gemini, Perplexity, Claude, Google AIO (moved out of „Monitor").
- 5. GEO Battle (
/competitors?mode=battle) — AI-citation showdown against pinned competitors (moved out of „Competitors", URL kept for bookmarks).
- USP visible from the sidebar. Rankmio is no longer „yet another SEO tool" — the GEO + Citation differentiator is now a top-level bucket on first login.
- Workflow clarity. Anyone doing GEO no longer clicks across three different buckets. All five tools sit in one place, in workflow order.
- „Monitor" stays „Monitor". Position Tracker and Sitemap Monitor are the only items left — clean focus on passive monitoring instead of mixing in active GEO tools.
June 30, 2026
Feature · Dev
JSON data export for AI coding agents (Claude Code, Cursor, Aider)
The full SEO+GEO state of a project can now be downloaded as a structured JSON export — 11 data blocks (audit, PageSpeed, visibility, GEO, citation, backlinks, competitors, keywords, sitemap, actions, project meta), directly consumable by AI coding agents. Plus: new insights article "Why Claude Code only reaches its full potential with SEO & GEO context" with slash-command example and MCP outlook. Plus: 6 new glossary entries (Claude Code, Cursor, GitHub Copilot, Aider, Lovable, Vibe Coding) for the developer audience.
JSON export: 11 data blocks, selectable per download
- New "JSON-Export" button in the project header (dashboard and analysis pages). Modal lets you pick which blocks to include — see record counts and estimated kilobytes per block, plus running total.
- 11 blocks available: project meta, on-page audit + crawler, PageSpeed mobile + desktop, visibility index, full GEO audit (pages + scores + schema + link suggestions), citation tracker (scans + results across 5 LLM engines), backlinks (summary + top + anchors + ref-domains + gaps), competitors (tracked + battles), keywords (GSC + opportunity scores + project keywords), sitemap (crawl + URL list), priorized actions.
- Cost: 2 credits per download. Eigene Permission json_export (Pro/Admin/Credits enabled, Visitor/Basis demo-only). CSRF-protected POST, no caching — always returns latest data.
Insights article + 6 new glossary entries
- New insights piece /insights/seo-fuer-ai-agenten with Claude-Code slash-command example, vibe-coding workflow walkthrough, SEO-report vs. Website-Context comparison table, 6 dev FAQs and MCP outlook. Hero image showing the rankmio + Claude Code symbiosis.
- Six new glossary entries for the developer audience: Claude Code, Cursor, GitHub Copilot, Aider, Lovable, Vibe Coding — each with definition, sections, example, and FAQ block.
- Landing page gets a dedicated "for-devs" section with the hero image and CTA to the new article.
June 28, 2026
Feature · Fix
New "Antithesis" brief slot + library self-domain fix
A new "Antithesis" template-element type with three hard prompt rules forces the LLM into a real counter-thesis instead of middle-of-the-road platitudes. Plus: rankmio.de-owned URLs can now be loaded as library sources into the Content Studio (self-domain block lifted in three layers).
Content Studio: new "Antithesis" brief slot
- New template element of category "Hook & Start" with three hard prompt rules: no hedging words (no "often", "can", "tends to"), explicit naming of the opposing camp (e.g. Yoast users, Ahrefs buyers, old-school SEOs), no "but of course" retreat. Renders as an orange highlight box at the top of the article.
- Auto-attached to the standard "Argumentation essay" template (position 2, after the main thesis). Existing briefs using this template inherit the slot without further action.
- New element appears automatically under "Hook & Start" in the template editor — no UI changes required, the catalog is loaded dynamically.
Content Studio Library: rankmio.de URLs now allowed
- Loading your own rankmio.de pages (glossary, insights, features) as library RAG sources is now possible. The SSRF self-domain block had to be lifted in three layers (uploadUrl, importUrl, DocumentProcessorService::fetchWithSsrfGuard).
June 15, 2026
v1.0 · Official launch
Rankmio v1.0 — all essential SEO + GEO features delivered
With today's release Rankmio officially reaches v1.0. All pillars are delivered and hardened: SEO analysis, Keyword Hub, Competitor Data Package, Backlinks Hub including Gap analysis, Bulk-First Position Tracker, Citation Tracker for ChatGPT/Gemini/Perplexity/AIO/Claude, Content Studio with voice dictation, Chat Agent with live access to all trackers. Shipped today: the Backlink Gap tab with anti-spam filter and score formula, 12-month trend chart, 9 new chat-agent tools and a sidebar cleanup.
- Find domains that link to your pinned competitors but not to you — your outreach pipeline at a glance.
- Spam and off-market domains are filtered out automatically so the list stays usable. One click brings them back if you want to see the full set.
Backlinks: 12-month trend chart
- New mini chart shows how backlinks and referring domains develop over the year — at a glance, next to the existing table.
Chat agent: 9 new tracker tools
- Position Tracker: overview (SoS, distribution, quick-wins), combined movers (Position-Tracker + GSC with source tag), competitor gap.
- Citation Tracker: rates per engine, 0%-phrases (highest-value action triggers), top competitor domains in AI answers.
- Backlinks: health score, top gap domains (spam filter on by default), anchor distribution with brand/exact/generic estimate.
- „AI Visibility" sidebar link removed (was a 301 redirect to the Citation Tracker — pure duplicate).
- „Rank Alerts" direct link removed — the tab inside the Keyword Hub still works, GSC-based email alerts unchanged.
June 11, 2026
Major Release
SERP, competitor depth & Backlinks Hub
Six new modules on top: full SERP data in the SEO analysis, competitor data packages with up to 1,000 keywords per domain, a dedicated Backlinks Hub, bulk-first Position Tracker, AI Visibility Monitor and competitor keywords straight inside the Content Studio brief.
- Dedicated hub for your backlink profile with health score, anchor distribution, referring domains and toxic check.
- Six tabs at a glance — overview, backlinks, anchors, referring domains, toxic and gap.
New: Competitor data package
- One click pulls up to 1,000 ranking keywords per competitor — with position, search volume and URL.
- In the detail view your own position and GSC data appear side by side with the competitor ranking.
- Multi-sortable columns, checkbox selection, direct transfer into your project keywords.
New: Position Tracker (bulk-first)
- Tracks your keyword rankings over time. Bulk-first architecture: up to 1,000 keywords per domain in a single call instead of one-by-one — faster and significantly cheaper.
New: AI Visibility Monitor
- Watchlist for your visibility in ChatGPT, Gemini, Perplexity and Google AIO.
- Per phrase: engine status, competitor mentions, answer excerpt — connected to a Brief action.
New: Rankings tab in the SEO analysis
- Fresh SERP data and GSC data combined in one table with multi-sort.
New: Project competitor register
- Central competitor list per project — auto-populated from your Easy and Deep SEO runs.
- Pin your top 1–3 rivals — Briefs, the chat agent and data packages all consume them automatically.
Content Studio: competitor keywords in the brief
- When creating a brief you can pull keywords directly from your pinned competitors into the target keywords — no detour via the Keyword Hub.
Chat agent reads competitor data packages
- Three new tools: pinned competitors, their ranking keywords, overlap/gap analysis.
- Model upgrade to GPT-4.1-mini for faster, more concrete answers.
- 4-bucket sidebar: Analyze · Optimize · Content Studio · Monitor — plus Tech and Manage. Same content, clearer workflow.