> For the complete documentation index, see [llms.txt](https://help.rankability.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.rankability.com/changelog/2026-04.md). # April 2026 Rankability product updates originally published in April 2026. {% hint style="info" %} Historical entries describe Rankability at the time of release. Use the [Help Center](/rankability-help-center.md) for current product instructions and availability. {% endhint %} [Back to the latest product updates](/changelog/changelog.md) ## Releases ## API v1.4 - Researcher jobs refund credits on failure (and tell you about it) **Improved** When a Researcher job submitted through the Agent API fails, the credits charged at the start of the run are now refunded to your account automatically — and the API tells your integration exactly how much came back. **Automatic refund when a Researcher job fails** — `POST /api/agent/v1/researcher/jobs` charges credits up-front when it queues a research run. If the worker (or the inline fallback) ultimately fails, the full charge is reversed back into your balance. Mixed charges that straddle included-plan credits and purchased credits are returned to the right buckets so your balance stays accurate. **`credits_refunded` on the job-detail endpoint** — `GET /api/agent/v1/researcher/jobs/:job_id` now returns a `credits_refunded` field. For failed jobs it shows the exact number of credits that were returned (or 0 if the failure happened before the charge). Pending, processing, and completed jobs always return 0. No need to inspect transactions to confirm a refund landed. **Idempotent and safe to poll** — The refund is keyed off the job id, so even if your integration retries or reconciles repeatedly, credits only come back once. Cache hits and pre-charge failures correctly report 0 refunded. Generate or rotate a key in [Settings](https://app.rankability.com/settings) → API Keys, and see the new field documented at [docs/agent-api.md](https://help.rankability.com/api/api-site-auditor). ## Page Auditor v1.2 - Intent-aware Page Quality Score **Improved** The Page Quality Score now grades every page against a rubric tailored to that page's job — so a service-area landing page is judged on local trust signals, a how-to article is judged on instructional clarity, and a checkout page is judged on conversion fit. No more one-size-fits-all checks giving informational pages credit for missing pricing, or scoring local pages without considering NAP and hours. **Four intent-aware rubrics** — Page Quality now picks one of four rubrics depending on the page: informational, commercial, transactional, or local-service. Each rubric defines its own dimensions, weights, and scoring guides — so the dimension list and the weighting reflect what actually matters for that kind of page. **Auto-detection for local-service pages** — When a commercial or transactional page shows clear local-business signals (phone numbers, addresses, hours, service-area phrases, pricing), the local-service rubric is selected automatically. Local landing pages stop being graded as if they were generic product pages. **Per-rubric weighted scoring** — The section score weights each dimension by the rubric's per-dimension weight, and renormalises gracefully if a dimension is missing — so the final Page Quality Score reflects the rubric's priorities, not a flat average. **Backwards compatible with older audits** — Audits run before this change continue to render with the legacy 8-dimension view, so historical reports keep working. Open the [Page Auditor](https://app.rankability.com/audit/page) and run a fresh audit to see the new intent-aware grading in action. ## Page Auditor v1.1 - new Agentic Search Readiness category **New** Page Auditor now grades every page against the standards AI agents are starting to enforce — ChatGPT search, Perplexity, Claude, and the next wave of agentic crawlers. A dedicated **Agentic Search Readiness** section appears in every audit, worth **15% of the Page Quality Score**, with eight emerging-standard checks weighted equally. **AI bot rules in robots.txt** — Explicit allow or disallow rules for GPTBot, OAI-SearchBot, ClaudeBot, PerplexityBot, Google-Extended, and friends — so the agents that read your site know exactly what's on the table. **Content-Signal directives** — Declares how AI agents may use your content (search, train, cite) instead of letting them fall back to defaults. **Sitemap referenced from robots.txt** — The line agentic crawlers look for to find your full URL set. **Link headers (RFC 8288)** — Machine-readable canonical, alternate, and licence relations served at the HTTP layer, before the HTML even parses. **Markdown content negotiation** — Does your page return clean Markdown when an agent asks for `text/markdown`? The cleanest input format for LLMs, and the one most likely to be cited verbatim. **llms.txt published** — The AI-era equivalent of an XML sitemap, telling agents which content matters most and how to consume it. **Web Bot Auth directory** — The JWKS endpoint that lets agents prove who they are before you decide whether to serve them. **Agent Skills index** — A discovery file that exposes the actions an agent can take on your site. **Every check is auditable** — Expand any check to see the exact URL we fetched, the HTTP status, the request headers we sent, the response headers worth surfacing, the parsed evidence (which bots matched, which sitemaps probed, JWKS key counts), and a copy-pasteable fix snippet you can drop straight into your robots.txt, sitemap config, or ``. Each check links out to the relevant spec or RFC so you can verify the recommendation yourself. **Backwards compatible** — Audits run before this change show a single "Not yet checked — re-run the audit" placeholder for the new category. Re-running an old audit picks up all eight checks. Open the [Page Auditor](https://app.rankability.com/audit/page) and run a fresh audit to see your agentic search readiness score. ## Prospector v1.0 - Find net-new SEO clients without leaving the app **New** Prospector is now generally available to every account — no flag, no waitlist. Search any city, vertical, or competitor footprint to surface businesses that need your help, score them by the work you can actually win, and push the best ones into your pipeline. **Lead discovery, scored for the work you can win** — Search by location and vertical (or paste a competitor's domain) and Prospector returns ranked businesses with a fit score that reflects current SEO weaknesses, GBP gaps, AI search visibility, and review health. Sort by score, location, or review count to find the prospects most likely to convert. **Built-in mini audit on every result** — Click any prospect to see a summary audit on the spot — top opportunities, the highest-impact fixes, and a snapshot of where they're losing to competitors. Use it to write a personalized first-touch outreach in minutes instead of hours. **One-click promote to a client** — When a prospect is worth pursuing, promote them to a full client record with one click. Their domain, location, and discovered keywords carry over so you can drop them straight into the Tracker, Researcher, or Copywriter without re-entering anything. **Saved searches and lists** — Save any search to re-run later and group prospects into named lists (e.g. "Q2 outreach", "Plumbers - Dallas") so you can keep your pipeline organized as it grows. Open the [Prospector](https://app.rankability.com/prospector) on any client to start finding net-new business today. ## Tracker v5.10 - Run up to 10 benchmark reports in one click **New** Setting up a new project's baseline is now a single batch operation instead of ten separate runs. Pick up to ten keywords during project setup and Tracker benchmarks them all in one pass — same costs, same data, a fraction of the clicks. **Batch benchmark up to 10 keywords** — On the project setup screen, select up to ten keywords and click "Run N benchmarks" to kick off the whole batch at once. The button rolls into a single "Running benchmark…" state with a per-keyword progress list — "Benchmark: " — so you can see exactly which one is in flight. **Same per-keyword fidelity** — Each benchmark in the batch produces the same full report you'd get from a one-off run — SERP, AI platforms, citations, share of voice. Nothing is sampled or trimmed to keep batch costs down. **Pick up where the batch left off** — If you close the tab or the connection drops, finished benchmarks are saved as you go. When you come back, only the unfinished keywords need to re-run. Open the [Tracker](https://app.rankability.com/track/rank) and start a new project to run a batch benchmark. ## API v1.3 - Researcher endpoints for keyword jobs and saved projects **New** The Agent API now covers Researcher. Start keyword research jobs from your own tooling, poll for results, list past jobs, and read any saved Researcher project with its full keyword set — all with the same auth, rate limits, and audit logging as the rest of the API. **Start keyword research jobs** — `POST /api/agent/v1/researcher/jobs` kicks off a research run in any of the supported modes (discover, trending, reddit, youtube, ecommerce). Jobs run asynchronously and return a job id you can poll. Cache hits return synchronously and cost zero credits. **Poll status and list past jobs** — `GET /api/agent/v1/researcher/jobs/:job_id` returns live status and the result payload when the job finishes. `GET /api/agent/v1/researcher/jobs` lists every research job your account has run, with filters for status and mode. **Read saved Researcher projects** — `GET /api/agent/v1/researcher/projects` lists every saved keyword project on your account. `GET /api/agent/v1/researcher/projects/:id` returns a single project with its full keyword set, volumes, intent, and clusters — ready to drop into a brief, an outreach list, or your own scoring pipeline. **Two new scopes** — Issue keys with `researcher:run` to start jobs and `researcher:read` to read jobs and projects. Both scopes show up in the Settings → API Keys picker. **Up-front credit costs** — Discover mode costs 500 credits, trending/reddit/youtube/ecommerce cost 750. Charges happen at job start, mirroring the Optimize pattern. Generate a key in [Settings](https://app.rankability.com/settings) → API Keys and read the full reference at [docs/agent-api.md](https://help.rankability.com/api/api-site-auditor). ## Project lists - Status filters, bulk actions, and one-click status changes **Improved** Managing a long list of client projects is now far less clicking. Filter by status, change a project's status from the row's menu, or select many projects and update them all at once — across both the global /projects page and any client's project list. **Status filter on every project list** — Filter chips at the top of the list let you scope to All, Active, Completed, or Archived in one click. Each chip shows a live count so you can see at a glance how your pipeline is distributed. **One-click status changes from the row menu** — The kebab menu on any project row now includes Mark as active, Mark as completed, and Archive. Change a project's status without opening it, and the list updates in place. **Bulk status actions** — Select multiple projects with the row checkboxes and a contextual action bar appears. Mark the entire selection as active, completed, or archived in one move — works on both the global [Projects](https://app.rankability.com/projects) page and inside any client's project list. Open [Projects](https://app.rankability.com/projects) or any client's projects tab to use the new filters and bulk actions. ## Tracker - Topic Groups and individual keywords in one unified card **Improved** The Rank Tracker project list is now a single, coherent view. Topic Groups and individual keyword projects live inside one card with clear subsections, and the empty-state messaging finally tells you the truth about what's there. **One unified card** — Topic Groups and individual keyword projects share a single bordered card with internal dividers and clear subsection headers (Topic Groups and Individual Keywords). When both subsections coexist, the labels appear; with only one kind in play, the labels stay out of the way. **Honest empty states** — The big "No tracking projects yet" empty state with the Create CTA now only shows when you genuinely have no projects at all. If your keywords are all organized into topic groups, the individual keywords subsection just says "All keywords are organized into topic groups above" — instead of contradicting the groups you can clearly see. **Filter- and archive-aware messaging** — When a filter or the Archive view hides everything in the individual keywords subsection, you see an inline message and a Clear filters button rather than the global empty state. Open any client in the [Tracker](https://app.rankability.com/track/rank) to see the cleaner project list. ## Help center - Attach screenshots and a reference URL when you submit a request **Improved** The Help center support form now lets you give the team the context they need to help you faster — without follow-up emails asking "what page were you on?" or "can you send a screenshot?". **Attach a reference URL** — A new optional Reference URL field on the support form lets you paste the page (or external link) the request is about. The form validates the URL inline so you'll know right away if there's a typo. **Attach screenshots** — Upload up to five screenshots (PNG, JPG, GIF, or WebP, 10MB each) directly from the form. Thumbnails preview each one and a per-file remove button lets you swap any of them out before submitting. **Cleaner support tab** — The CEO direct-line card is gone, so the Submit a request card is now the primary content on the support tab and the new fields fit cleanly inside it. Open the [Help center](https://help.rankability.com) and switch to the Support tab to use the new fields. ## Auditor v1.6 - GBP suite expansion: shareable reports, review replies, and cross-location compare **New** The Google Business Profile auditor just got a major upgrade. You can now share live audit reports with clients without giving them a login, reply to Google reviews directly from the app, compare metrics across every location in a group at a glance, and pick the right listing when a public address has multiple GBP candidates. **Shareable live report links** — Open any GBP group, click Share, and toggle on a public live link. Set an optional password and expiration date, copy the URL, send it to your client. They see the same live report you do — keyword summaries, location performance, cannibalization alerts — branded with your agency name and logo. Rotate the token any time to revoke access. **Reply to Google reviews in-app** — On the Reviews tab of any GBP group, click Reply on any review and your response posts directly to Google through the connected account. The review is marked as responded in your tracking table so you can see at a glance which ones still need attention. **Review ratings on Rankings cards** — Each location card on the Rankings tab now shows the star rating, total review count, and a count of unanswered reviews. Spot the locations that need attention without leaving the dashboard. **Cross-location comparison table** — A new comparison table on the GBP Auditor lets you see every location in the group side-by-side: keyword visibility, average rank, review counts, and trend indicators. Sort by any column to find the standouts and the laggards in seconds. **Right-listing picker for public audits** — When the public GBP audit tool finds multiple candidate listings for an address, you now get a disambiguation step that lets you confirm the correct one before the audit runs. No more accidentally auditing the wrong location. Open any client's GBP group from the [Auditor](https://app.rankability.com/audit/gbp) to use the new tools. ## Tracker v5.9 - AI brand tracking, GA4 traffic donuts, and street-level Local Grid centering **New** Tracker now tells you where you stand in AI search at a brand level, breaks down your GA4 traffic mix in interactive donut charts, and lets you center the Local Grid on a precise street address. **AI search performance with brand tracking** — AI search reports now distinguish between branded and non-branded visibility across ChatGPT, Perplexity, Gemini, Claude, Grok, and Copilot. See how often your brand is mentioned by name versus surfaced for category queries, and where competitors are picking up the citations you should be getting. **GA4 traffic source donut charts** — The GA4 performance card now renders Sessions, Engaged Sessions, and Conversions as donut charts broken down by source category (Organic Search, AI Referral, Paid, Direct, Social, Referral, Email, Other). Hover any slice for the exact session count and percentage. Download any chart as a PNG to drop into client reports. **Center Local Grid on a street address** — When setting up a Local Grid, the address autocomplete now resolves to a precise street-level point instead of a city centroid. Your grid renders centered exactly where the storefront is, so the heat map reflects real proximity rankings rather than a rough city-center approximation. **GBP address finder + scan button refinements** — The Tracker setup screen has a faster GBP address finder and a more compact scan button row, so you can launch a fresh scan without the controls eating into the dashboard. Open any project in the [Tracker](https://app.rankability.com/track/rank) to see the new AI brand metrics, GA4 donuts, and Local Grid options. ## Copywriter v4.8 - Optimize sidebar polish and brand-source distinction **Improved** The Optimize keyword sidebar is faster to scan, easier to act on, and now tells you at a glance which keywords came from your brand profile versus your research. **Brand-sourced keywords are visually distinct** — Keywords pulled from your brand profile now render with a subtle brand badge in the Optimize KW checklist and contribute to scoring alongside research-sourced keywords. You can tell at a glance whether a missing keyword is something your brand explicitly cares about or a research suggestion. **Source filtering moved into the sort dropdown** — The chip row above the keyword list is gone. Filter by source (research, brand, or both) directly from the sort dropdown for a cleaner, denser sidebar that fits more keywords on screen. **Hover-to-copy on keyword rows** — Hover any keyword row and a compact copy icon appears. One click copies the term to your clipboard so you can paste it into your brief, your editor, or anywhere else without retyping. **Persistent selection highlight + compact processing pill** — Highlights you make in the editor stay visible while AI custom-instruction requests process in the background. The processing indicator is now a small pill instead of a full overlay, so you can keep editing while AI work runs. Open any project in the [Copywriter](https://app.rankability.com/copywriter) and switch to Optimize mode to see the changes. ## Certified Agency Kit v1.0 - Badges, embed snippet, and in-app profile editing **New** Certified Rankability Agencies now have a self-serve kit inside the app. Download official badges, grab an embed snippet for your site, and edit your public directory profile without filing a request. **Official badge artwork** — The new /account/certification page hosts the three official Certified Agency badges: Primary (Blue), Reverse (White), and Icon. Download SVG or PNG for any variant. Each badge links back to the canonical badge guidelines so you stay within usage rules. **Copy-paste embed snippet** — One click copies a ready-to-use anchor + image snippet that drops the blue badge on your site and links to your public profile on the Rankability directory. No manual HTML editing. **Edit your public profile in-app** — Org admins and owners can now update the editable parts of their certified agency profile (name, logo, website, description, location, industries, services, service area, public contact email, positioning) from inside the kit page. Saves sync to the public directory within a few minutes. **Status-aware experience** — The page adapts to your certification state. Pending applicants see a clear notice explaining what's available now versus after approval. Active members get the full kit with the public profile button and embed snippet. Inactive or revoked members see reinstatement guidance. Open the [Certified Agency Kit](https://app.rankability.com/account/certification) from your account settings. ## Researcher v1.9 - Conversational Keyword Agent **New** Researcher now includes a conversational keyword agent — a chat sidebar that selects keywords for you, refines selections turn by turn, and lets you undo any change with one click. It's the AI Select tool reimagined as a working partner, not a one-shot prompt. **Chat with your keyword list** — Open any keyword research project, click the AI Select button, and a sidebar opens. Describe what you want in plain English ("find the top 20 commercial-intent keywords I could realistically rank for in 6 months"), and the agent reads your keyword list — volumes, difficulty, CPC, intent, clusters — and checks the matching rows directly in the table. No copy-paste, no leaving the page. **Multi-turn refinement with checkpoints** — The agent remembers the conversation. Ask it to narrow the selection ("now drop anything with KD over 40"), broaden it ("add a few informational keywords for blog topics"), or pivot entirely ("forget those, find me location-based service keywords instead"). Every change creates a checkpoint, so if a turn moves you in the wrong direction you can restore the previous selection from the chat with one click — or just say "undo last change". **Quick-prompt chips** — Common follow-ups appear as one-tap chips beneath the input: Top high-volume only, Exclude branded terms, Keep transactional intent, Undo last change. Use them to iterate without retyping the same instructions. **Jump straight to a keyword** — When the agent references specific keywords in its reply, click them to scroll the table to that row. Easy way to verify why something was picked without losing your place in the conversation. **Responsive layout** — On wide screens (1280px and up) the sidebar pushes the table aside so both stay fully usable. On smaller laptops and tablets it opens as an overlay you can resize by dragging its left edge. On mobile it appears as a bottom sheet you can swipe down to dismiss. Press Escape to close on any device. **Streaming responses** — Replies stream as the agent thinks, so you see its reasoning unfold in real time instead of waiting for a finished answer. Open any project in the [Researcher](https://app.rankability.com/researcher), click AI Select in the Keyword Opportunities header, and start chatting. ## Auditor v1.5 - Export brand findings to your tools and your AI agent **New** Brand Consistency Auditor findings are now ready to act on the moment the audit finishes. Push them into Jira, Linear, or Asana as importable tasks, hand them to an AI agent as a structured brief, or copy a single finding straight into the tool of your choice. **Bulk export to your PM tool** — Click Export on the Findings tab and pick Jira, Linear, or Asana. You get a CSV pre-shaped for that tool's importer — severity becomes priority, category becomes a label, the recommended fix becomes the description, and the source URL is included as a reference. Drop the file into your PM tool's import flow and every finding becomes a ticket with the right metadata already attached. **Generic CSV, Markdown, and JSON too** — Need a different format? Export the same findings as a generic CSV for spreadsheets, a Markdown checklist for your docs, or raw JSON if you're piping it into your own tooling. **Agent brief export** — Pick "Agent brief (Markdown)" to get a numbered task list written for an AI coding agent. Each task includes the inconsistency, why it matters, the recommended fix, the replacement copy when available, and the source URL. Paste it into Claude, ChatGPT, Cursor, or Replit Agent and let your agent work through the list. **Per-finding actions menu** — Every finding card now has a three-dot menu. Copy that single finding as a Markdown task, as JSON, or as an agent prompt — useful when you want to hand off one specific issue without exporting the whole audit. The same menu opens the source page in a new tab so you can verify the issue in context. **Select what you want, export only that** — Check the box on any findings you want to focus on, then export. The download includes only the selected ones, with a "selected only" badge in the export menu so you know exactly what's going out. Without a selection, you get the full filtered list. **"How to act on these findings" panel** — A new panel at the top of the Findings tab walks you through the three workflows — push into a PM tool, hand off to an AI agent, or work it manually — with one-click buttons for the most common exports. Dismiss it once you know the flow; collapse it to keep it handy. Open any audit from [Audit](https://app.rankability.com/audit), go to the Findings tab, and use the Export button or the per-finding actions menu to get started. ## Tracker v5.8 - Keyword Topic Groups & AI Query Fan-Out **New** Rank Tracker now lets you organize keywords into topic groups and automatically generate AI query variants for each group — so you can track how you rank across an entire topic, not just one keyword at a time. **Group keywords by topic** — Click "Create group" on any project dashboard, give it a name (e.g. "Local SEO services" or "Pricing comparisons"), and the dashboard reorganizes into collapsible sections. Each group shows an aggregated Topic SPI badge that reflects how dominant you are across the entire topic, not just a single query. Ungrouped keywords keep working exactly as before — grouping is opt-in and per-project. **AI Query Fan-Out** — When you create a group, give it a seed keyword and Rankability generates 8–12 commercial-intent query variants automatically (comparisons, pricing questions, vetting and hiring queries, recommendation searches). The variants are the queries real buyers type when they're ready to act — not informational "what is" or "how does" queries. Pick which variants to track, and they're added to the group in one step. **Per-platform platform selection** — For each group, choose which platforms you want to track across: Traditional search, AI platforms (ChatGPT, Perplexity, Gemini, etc.), and Video. The dialog shows real platform logos so you can see exactly what you're enabling. Topic SPI is computed as a true weighted average — weighted by the number of platforms each keyword is actually tracked on — so the score reflects real coverage rather than averaging incomparable numbers. **Domain and location pre-filled** — The Create Group dialog now pre-fills the target domain from the client record and includes location autocomplete powered by Google Places. If you set a location, every generated variant is required to include it (e.g. "best CRM software Austin" instead of just "best CRM software") — so local intent is honored across the whole group. **Topic Visibility in Tracker** — Shared client reports now include a Topic Visibility section that surfaces each group's aggregated SPI alongside the keyword-level data your clients already see. Clients understand topic dominance better than individual keyword rankings — "we own 73% of the pricing-comparison topic" lands harder than a list of 12 keyword positions. **Move keywords between groups** — Every keyword in the dashboard now has a "Move to group" dropdown so you can re-organize without recreating projects. Grouped keywords are filtered out of the main flat list to avoid double-counting. Open any project in [Rank Tracker](https://app.rankability.com/track/rank), click Create group, give it a seed keyword, and let the AI fan-out propose your topic. ## Tracker v5.7 - Multi-location GBP management **New** Agencies managing brands with multiple Google Business Profile locations can now connect, audit, and monitor reviews across all locations from one place. **Connect multiple GBP locations per client** — In Client Settings, once your Google Business Profile is connected, a new "Connected GBP locations" card shows all locations linked to that Google account. Use the location picker to select as many locations as you need — each one is stored individually. You can add more at any time without disconnecting. **Primary location switcher** — One location is designated as Primary, which is what powers the GBP performance data you already see. Click "Set as primary" on any other connected location to switch it. If you remove the primary location and others remain, the next one is promoted automatically. **Existing clients migrated automatically** — If a client already had a GBP location connected, it has been carried over to the new system as the primary location with no action required. **Cross-location review feed** — In GBP Groups (inside Track), groups with two or more locations now show a Reviews tab alongside the existing Rankings tab. The feed aggregates recent reviews from all locations — reviewer name, star rating, location, date, and review text are all shown together in one list. Filter the feed by location, star rating, or response status to focus on what needs attention. Each review shows whether it has been responded to on Google (locked, cannot be overridden), manually marked as responded by your team (toggleable), or still awaiting a response. A "View on Google" link opens the review directly. Marking a review responded records it in Rankability without requiring you to leave the platform. **Multi-location audit** — The GBP auditor now supports running audits across all locations in a group and viewing results per location, so you can compare GBP health across a brand's full footprint. To use the review feed, go to [Track](https://app.rankability.com/reporter), open a client with a GBP group, click the group name on any project row, and select the Reviews tab. The tab only appears for groups with two or more locations. ## Copywriter v4.7 - Share briefs and drafts for review **New** You can now share any Copywriter project with clients, editors, or collaborators via a link — no login required. **Share with one click** — A new Share button appears on every Copywriter project. Click it to generate a shareable link and choose how much access the recipient gets. Share it directly with clients for feedback, pass it to an editor for changes, or hand it off to a copywriter working outside your account. **View-only or edit mode** — Choose whether the shared link opens in view-only mode (the recipient can read and comment but not change anything) or edit mode (they can make changes directly in the editor). Edit mode is useful when you want a collaborator to work on the draft. View mode is better for client approval — they can review the content without accidentally editing it. **Optional AI chat for shared viewers** — In edit mode, you can enable AI chat for the shared link so recipients can use the built-in AI assistant to refine sections, ask questions about the content, or suggest improvements — without needing a Rankability account. AI usage on shared links counts against your account's AI allowance. **Portal-password protected** — If the client associated with the project has a portal password set, the shared link requires that password before the content is visible. Your client's content stays private even with the link enabled. **Revoke anytime** — Disable sharing from the same Share dialog to immediately invalidate the link. Anyone who previously had access will see a "sharing disabled" message if they try to open it. Open any project in the [Copywriter](https://app.rankability.com/copywriter), click the Share button in the top toolbar, and generate your link. ## Copywriter v4.6 - Regenerate outline with intent control **New** The brief review page now lets you regenerate your outline with one click — and change the content intent before doing so. **Regenerate outline button** — A Regenerate outline button now sits alongside your brief. Click it, confirm in the dialog, and the Copywriter re-runs the brief generation using your current settings, knowledge base, and research data. Use it when the first brief doesn't quite match what you had in mind, when you've updated your knowledge base and want to reflect the changes, or when you want a fresh take on the structure. **Intent as a control, not a label** — The content intent (Educate, Discover, Compete, or Convert) is now shown as a segmented button group rather than a static badge. Switch between intents directly on the brief page without going back into the project setup. The change takes effect the next time you regenerate, so you can dial in the right intent before re-running. **Your intent choice is locked in** — Once you select an intent manually, the system respects it. Previously, the auto-detection that runs during brief generation could silently override your choice if it disagreed with the keyword signal. Now, a manually set intent is treated as authoritative — the auto-correction only applies if you haven't chosen one yourself. **No full draft regeneration required** — Regenerating the outline does not discard your draft. If you've already written or edited content, the new outline is applied to the brief only. You decide when and whether to regenerate the full draft from the updated brief. Open any project in the [Copywriter](https://app.rankability.com/copywriter) and go to the Brief tab to find the Regenerate outline button. ## Researcher v1.8 - Analyze any URL, subfolder, or subdomain **New** The Explore tab in Researcher now lets you analyze any URL, subfolder, or subdomain — not just root domains. Where you used to be limited to seeing what example.com ranks for, you can now drill into example.com/blog, a specific page like example.com/blog/seo-guide, or a subdomain like docs.example.com. **Choose what you're analyzing** — A new target type selector sits inline with the domain input. Pick from Root domain, Exact URL, Subfolder, or Subdomain before running your analysis. The input updates its label and placeholder to match — so if you select Exact URL, it prompts you for a full URL like example.com/blog/post rather than just a domain. **Why this matters for competitor research** — A competitor's root domain might rank for thousands of keywords, but their blog subfolder is what you actually compete with for content traffic. Analyzing example.com/blog directly shows you exactly which keywords drive their content section — without the noise of their homepage, product pages, or other sections. **Useful for your own site too** — Audit a specific section of your own site before publishing content. See what your /blog subfolder already ranks for before writing a new post. Identify gaps in a specific subdomain without wading through your full domain keyword list. **Works with search history** — Target type is saved with your search history, so reloading a past Explore search restores the correct type automatically. **Root domain behavior unchanged** — Selecting Root domain works exactly as before — no changes to existing workflows. Open the [Researcher](https://app.rankability.com/researcher), go to the Explore tab, and use the target type selector next to the input field. ## Tracker v5.6 - Historical timeline & manual annotations **New** Rank Tracker now lets you annotate your ranking charts with events that matter — so when rankings shift, you can see exactly what changed and why. **Mark events directly on your chart** — Click the Add Annotation button on any Rank Tracker project dashboard and log what happened: a content update, an algorithm change, a new backlink campaign, a technical fix, or a client event. Each annotation appears as a color-coded vertical marker on your historical ranking chart, pinned to the exact date. Hover over any marker to see the details, or click to edit. **Six built-in categories** — Every annotation is tagged with a category so your chart stays organized: Content change, Algorithm update, Link building, Technical fix, Client event, or Other. Each category has its own color and icon, making it easy to scan the timeline and spot patterns — like whether rankings improved after a batch of content updates, or dropped following an algorithm rollout. **Correlate rankings with actions** — The real value is context. When a client asks "why did our rankings jump in March?", you can point to the annotation showing you published 5 new pages that week. When rankings drop, you can check whether it lines up with an algorithm update you logged. Annotations turn a ranking chart from "what happened" into "why it happened." **Edit and delete anytime** — Made a typo or need to update the details? Click any annotation marker to edit its title, description, date, or category. Delete annotations you no longer need. Changes are reflected on the chart immediately. **Date-range aware** — Annotations automatically filter to match your selected time range. Looking at the last 30 days? You'll only see annotations from that period. Switch to 6 months or all time and the full history appears. **Saved per project** — Annotations are stored at the project level, so each Rank Tracker project has its own timeline. Your SEO team can maintain a running log of every meaningful change for each client. Open any [Rank Tracker](https://app.rankability.com/rank-tracker) project and click Add Annotation to start building your timeline. ## Tracker v5.5 - Owned assets in Search Domination **New** Search Domination now lets you flag owned assets — like your LinkedIn profile, YouTube channel, Crunchbase page, or any other property you control — so your true SERP dominance is reflected in the score. **Flag owned assets with one click** — In the traditional search results table, click the shield icon next to any domain you own beyond your primary website. That domain is instantly marked as an owned asset, and its ranking positions count toward your Search Domination score. Your LinkedIn company page ranking #4 for your brand name? That's your real estate — now it counts. **See your real SERP footprint** — Search Domination previously only counted your primary domain. But if you control 3 of the top 10 results through your website, YouTube channel, and LinkedIn profile, your actual dominance is much stronger than the primary domain alone suggests. Owned assets give you the complete picture. **Visual distinction** — Owned asset rows are highlighted in the results table with a blue accent and an "Owned" badge, so you can instantly see which spots are yours versus competitors'. Your primary domain and owned assets are visually grouped together. **Smarter competitor analysis** — Owned assets are automatically excluded from the Top Competitors sidebar, so your own properties don't show up as competition. The competitive landscape only shows domains you don't control. **Saved per client** — Owned domains are saved at the client level, so you only need to flag them once. They apply across all keyword projects for that client. **Included in exports** — CSV exports now include a Type column (Primary, Owned, or Competitor) so owned asset data carries through to your reports. Open any keyword project in [Tracker](https://app.rankability.com/reporter), switch to the traditional search tab, and click the shield icon next to any domain you own to start tracking your true Search Domination. ## Tracker v5.4 - Search Domination in traditional search **New** The traditional search tab in Tracker now features a Search Domination metric — a clear, at-a-glance measure of how much of the search results your domain controls. **See your SERP footprint instantly** — Search Domination shows how many of the top 30 ranking positions your domain occupies across your tracked keywords and search engines. Instead of scanning through individual keyword rankings, you get one number that tells you how dominant your presence is in the results. **Color-coded performance** — The score is color-coded so you can immediately tell whether your coverage is strong, moderate, or needs attention — without digging into the data. **Track dominance over time** — As you build content and improve rankings, watch your Search Domination percentage climb. It's a straightforward way to measure whether your overall traditional search presence is growing or shrinking across your entire keyword portfolio. **Included in exports** — The Search Domination score is included when you export your traditional search data, making it easy to add to client reports. Open any keyword project in [Tracker](https://app.rankability.com/reporter) and switch to the traditional search tab to see your Search Domination score. ## Researcher v1.7 - AI keyword selection **New** Researcher now includes an AI-powered keyword selection tool that lets you describe what you're looking for in plain English — and instantly selects the most relevant keywords from your list. **Describe it, don't scroll it** — Instead of manually reviewing hundreds or thousands of keywords, click the AI Select button in the Keyword Opportunities header and type what you need. For example: "Find location-based SEO consultant keywords with unique commercial intent" or "Select informational keywords about technical SEO that would work as blog topics." The AI reads your entire keyword list — including volume, difficulty, CPC, intent, and cluster data — and checks the keywords that match your criteria. **Intent-aware reasoning** — The AI doesn't just pattern-match on keyword text. It analyses each keyword's search intent, considers your business context, and prioritises keywords where the intent aligns with your goals. If you're a service provider, it deprioritises DIY and free-tool keywords. If you're looking for content ideas, it focuses on informational intent with topic diversity. **Works with your filters** — AI selection operates on your currently filtered list. Apply your volume, difficulty, or CPC filters first to narrow the scope, then let the AI make the final selection within those constraints. The AI respects whatever filters you've already set. **Batch processing for large lists** — Lists of up to 2,000 keywords are processed in intelligent batches, so even your largest research runs get full AI coverage. Each keyword is evaluated against your criteria with its complete metric profile. **One-click workflow** — Selected keywords are automatically checked in the table, ready for you to save to a list, export, or send to Copywriter. A summary badge shows how many keywords the AI selected and why, so you can review the reasoning before acting on it. **200 credits per run** — Each AI selection costs 200 credits regardless of list size. No credits are charged if the AI processing fails. Open any [Researcher](https://app.rankability.com/researcher) keyword research, look for the AI Select button in the Keyword Opportunities section, and try it with your own criteria. ## Page Auditor v1.0 - Score any page for a keyword **New** Introducing Page Auditor, a comprehensive page-level SEO analysis tool that scores any URL against a target keyword and tells you exactly what to fix. **100-point SEO Content Score** — Enter a URL, a keyword, and optionally a target location. Page Auditor crawls the page, scrapes competitors from the SERP, extracts entities, runs PageSpeed Insights, and produces a single 0–100 score broken down into five components: keyword placement (title, H1, meta description, first 100 words), entity coverage (how many competitor-mentioned topics your page covers), Core Web Vitals performance (LCP, CLS, FCP, TBT), page size efficiency, and schema markup presence. **Three-gate checkpoint** — Before scoring begins, the auditor verifies your page passes three gates: crawlable (not blocked by robots.txt), indexable (no noindex directive), and retrievable (meaningful content can be extracted — catches empty pages, thin content under 50 words, and soft 404s). If any gate fails, you see the exact reason and can fix it before worrying about content quality. **Entity gap analysis** — See which entities (brands, concepts, features, terms) top-ranking competitors cover that your page is missing. Each entity shows whether your page mentions it or not, so you know exactly which topics to add for better topical coverage. **Technical health checklist** — Beyond the score, Page Auditor runs 15+ pass/fail checks: SSL present, mobile-friendly, keyword in URL, heading structure, broken links, self-referencing canonical, content freshness, readability, interstitials, and ad placement. Trust and authority signals — about page, contact page, terms, privacy policy, author attribution, sources cited, and disclaimers — are filtered by search intent so you only see checks relevant to your page type. **AI quality analysis** — Intent-aware quality dimensions evaluated against Google's quality rater guidelines: intent satisfaction, helpfulness, originality, accuracy, safety, and effort — plus subject matter expertise for informational content or first-hand experience for commercial and transactional pages. Each dimension gets a pass/fail result with a specific reason. **Score history and trends** — Re-audit the same URL and keyword over time to track improvements. A trend chart shows how your score evolves across audits, so you can measure the impact of each optimization round. **Shareable reports** — Generate a share link for any completed audit. Shared reports display your agency branding (name, logo, accent color) from your subscription settings — perfect for client deliverables. The shared view includes the full score breakdown, all checks, and the trend chart. **Location-aware analysis** — Specify a target location (city, state, or country) and the auditor pulls SERP results for that geo, ensuring the entity extraction and competitor analysis reflects local search intent. Page Auditor is available in every client workspace under Audit. No credit cost per audit — it's included in your plan. [Run your first audit](https://app.rankability.com/audit/page). ## Tracker v5.3 - Microsoft Copilot integration **New** Tracker now tracks your brand's visibility across Microsoft Copilot — Bing's AI-powered search assistant — alongside ChatGPT, Perplexity, Gemini, Claude, and Grok. **Track Copilot citations and mentions** — When you add Copilot to a Rank Tracker project, Tracker checks whether Copilot's AI answers mention your brand, cite your website, and how you're positioned relative to competitors. Results appear on the same AI Answers dashboard alongside all other platforms. **CVS score integration** — Copilot results feed directly into your Citation Visibility Score (CVS) with a weight of 0.2, reflecting Microsoft's growing share of AI-powered search. Your overall CVS score now reflects visibility across 7 AI platforms. **SPI scoring** — Copilot is fully integrated into the Search Performance Index, contributing to your holistic search visibility score across both traditional and AI search. **Smart billing** — Each Copilot check costs 10 credits. If the platform doesn't respond or returns an empty result, you're not charged — the system automatically marks these as non-billable. **Agency plan feature** — Copilot tracking is available on Agency plans. Add it to any Rank Tracker project from the platform settings. Open any [Rank Tracker](https://app.rankability.com/rank-tracker) project and enable Copilot in the platform list to start tracking. ## Promoter v2.1 - Analyze any domain's backlink profile **New** Promoter now lets you study any domain's backlink profile — not just your own. Enter a competitor's domain directly from the Promoter page and see their full backlink data: referring domains, domain score, link velocity, top anchors, and referring domain breakdown. **Competitor backlink analysis** — Click the search icon next to the domain selector and type any domain (e.g. competitor.com). Promoter runs the same full backlink analysis it does for your own domain: total backlinks, referring domains, dofollow vs nofollow split, 30-day new and lost links, domain score with historical trend, and top referring domains with their authority scores. **Quick domain switching** — Switch between your workspace domain and any external domain instantly. When analyzing an external domain, a clear indicator shows you're viewing a competitor's data, and you can return to your own domain with one click. **Smart input handling** — Paste a full URL with protocol and path () and Promoter automatically extracts just the domain. Invalid inputs are caught with clear error messages before any API call is made. **Same data depth** — External domains get the exact same analysis depth as your own domain: backlink summary, domain score history, top anchors, and top referring domains. The only difference is the label telling you it's an external domain. Open the [Promoter](https://app.rankability.com/promoter) for any client and click the search icon to analyze a competitor's backlink profile. ## Researcher v1.6 - Organic keyword footprint **New** Explore Domain now shows a complete historical view of any domain's organic keyword footprint — how many keywords it ranks for, estimated traffic value, and position distribution over time. **Historical rank overview** — See how a domain's organic presence has changed month over month. The chart shows total ranked keywords, estimated organic traffic (ETV), and traffic cost value going back as far as data is available. Use the time range selector (1M, 6M, 1Y, 2Y, or All time) to zoom into the period you care about. **Position distribution breakdown** — Understand where a domain's keywords actually rank. The stacked area chart breaks down keywords by position range: Top 3, positions 4–10, 11–20, 21–50, and 51–100. Watch how a competitor's rankings shift across tiers over time — are they gaining top 3 positions, or are most of their keywords stuck on page 2? **GSC overlay** — If you have Google Search Console connected for the domain you're exploring, the chart overlays your actual GSC clicks, impressions, and CTR data alongside the third-party estimates. Toggle the GSC layer on or off to compare estimated vs actual performance. This lets you validate DataForSEO estimates against your real data. **Summary metrics** — At-a-glance stats show total ranked keywords, estimated monthly traffic, traffic cost value, and a position tier breakdown for the most recent data point. **Cached for efficiency** — Results are cached for 7 days so repeated lookups for the same domain don't consume additional credits. Each fresh lookup costs 400 credits. Open the [Researcher](https://app.rankability.com/researcher), search for any domain, and scroll to the Organic Keyword Footprint section to explore its historical performance. ## MCP v1.1 - Optimize tool **New** MCP now includes an `optimize_page` tool, letting your AI assistant score any public URL against its SERP competitors for a keyword — returning a full Rankability score, entity coverage analysis, and competitor benchmarks. **Score pages from your AI assistant** — Ask your AI assistant to analyze a page and it calls the Optimize tool directly. Send a URL and keyword, and get back a 0–100 Rankability score based on entity coverage and keyword placement, a complete list of extracted entities with importance rankings, and a summary of the competitor pages that were analyzed. **New scope required** — The tool requires the `optimize:run` scope on your API key. If you created your API key before this update, go to Settings → API Keys and add the `optimize:run` scope to enable the tool. **Same pipeline as the app** — The MCP tool runs the exact same analysis pipeline as the in-app Optimize mode: SERP and Brave competitor scraping, GPT entity extraction, source URL scoring. Results are identical whether you use the app, the API, or MCP. **1,200 credits per call** — Each optimize call costs 1,200 credits, consistent with Copywriter Quick mode pricing. Retry-safe with idempotency key support. Update your MCP configuration and add `optimize:run` to your API key scopes to get started. See the [MCP guide](https://help.rankability.com/api/mcp-getting-started) for setup instructions. ## API v1.2 - Public Optimize endpoint **New** The Rankability API now includes a public Optimize endpoint that scores any URL against its SERP competitors for a given keyword — returning a full Rankability score, entity coverage analysis, and competitor benchmarks in a single API call. **One call, full analysis** — Send a POST request with a URL and keyword to `POST /api/v1/optimize` and get back everything: a 0–100 Rankability score based on entity coverage (how many important entities from competitors your content includes) and keyword placement (whether your primary keyword appears in key spots like the title, H1, first paragraph, subheadings, and meta description), a complete list of extracted entities with importance rankings, and a summary of the competitor pages that were analyzed. **No project required** — Unlike the Copywriter API, the Optimize endpoint is completely stateless. It doesn't create a database project, doesn't require a client ID, and doesn't need polling. You send a request and get the full result in the response. This makes it ideal for batch scoring, content audits, and integration into external pipelines. **Entity extraction from competitors** — The endpoint scrapes up to 20 SERP competitors and extracts the entities (brands, concepts, features, terms) that top-ranking pages cover. Each entity includes an importance level based on how many competitors mention it: required (5+), recommended (2–4), or optional (1). Use this to identify exactly which topics and entities your content is missing. **Built-in security** — The endpoint blocks requests to private networks, localhost, cloud metadata endpoints, and internal hosts. URL validation ensures only public HTTP/HTTPS pages are analyzed. **Credit-efficient** — Each call costs 1,200 credits (same as Copywriter Quick mode). Repeated requests for the same URL and keyword combination within a billing cycle are not double-charged thanks to automatic idempotency. **Authentication** — The Optimize endpoint uses admin key authentication via the `X-Admin-Key` header. This is separate from the `rk_live_` Bearer token system used by other API endpoints. Full endpoint documentation is available in the [Help Center](https://help.rankability.com) under "Optimize API endpoint." ## Optimize mode - Higher quality entity extraction **Improved** Optimize mode now uses the same battle-tested entity extraction system as Brief mode — delivering significantly more relevant entities with less noise. **Shared entity system** — Previously, Optimize mode had its own separate entity extraction pipeline with simpler filtering. It now uses Brief mode's `findKeywordSourceExcerpts` for verification (checking entities against SERP results, AI Overview, Perplexity, Grok, and ChatGPT citations) and the shared `filterNoisyEntities` function for comprehensive noise removal. This means the same entity quality you get in a full Copywriter brief is now available in Optimize mode. **Better noise filtering** — The shared filtering system includes topic-aware filtering, business name pattern detection, city name filtering, UI noise removal, and platform name filtering. Junk entities like page headings, navigation labels, and review boilerplate that previously appeared in Optimize results are now caught and removed. **Stronger extraction prompt** — The entity extraction prompt now includes Brief mode's explicit rules: preserve original casing (only capitalize proper nouns), extract single concepts only (with positive and negative examples), and never extract headings, taglines, or multi-word verb phrases. **Result** — Internal testing showed 4.6x more entities extracted (19 → 87) with much higher relevance. Heading-style junk entities like "Compare user reviews on trusted platforms" are eliminated. ## Serena v4.2 - Smarter action guardrails **Improved** Serena now limits itself to one tracking recommendation and one content recommendation per response — picking the single highest-impact action instead of overwhelming you with a list of proposals. **One action per type** — Previously, Serena could propose multiple keyword tracking additions and multiple content projects in a single response. Now it proposes at most one of each: the single highest-impact keyword to track and the single highest-priority content gap to fill. This makes each response more focused and actionable. **Enforced at every level** — The guardrail is enforced in the tool definition (single-keyword limit), the system prompt (explicit "at most ONCE per response" instructions), and the response parser (only the first tool call of each type is accepted). Even if the underlying model tries to propose multiple actions, only the highest-priority one gets through. **Brand Audit integration** — When Brand Audit findings exist, Serena now references relevant inconsistencies, severity levels, and AI confusion risk in its recommendations — connecting brand consistency issues to their potential impact on AI search visibility. Open the [Serena](https://app.rankability.com/clients) to see the more focused recommendations in action. ## Serena v4.1 - Actionable proposals with site awareness **New** Serena now proposes concrete actions you can execute with one click — and checks your existing site pages before recommending new content, so you never get a suggestion to create a page you already have. **Action cards in every response** — When Serena identifies an opportunity, it doesn't just describe it — it proposes a specific action. Keyword tracking opportunities appear as "Track these keywords" cards. Content gaps appear as "Create content project" cards. Click to execute the action directly from the chat, no copy-pasting or switching tabs required. **Two action types** — Serena can propose adding keywords to your Tracker tracking (with specific keywords, platforms, and reasoning) and creating new Copywriter projects (with topic, content type, and strategic rationale). Each action card shows exactly what will happen before you approve it. **Existing page awareness** — Before suggesting new content, Serena now cross-references your full site inventory: up to 50 GSC pages (not just the top 10), all GA4 landing pages, every active Copywriter project, and all Builder pages with their URLs. If a page already covers the topic, Serena recommends optimizing the existing page instead of creating a duplicate. Every content proposal includes an explicit "existing page check" showing which pages were reviewed. **Smarter keyword proposals** — Serena checks your currently tracked keywords before proposing new ones. If you mention "ai seo tools" and you're already tracking it, Serena won't waste your time re-suggesting it. It focuses on gaps — keywords showing traction in GSC that you aren't monitoring yet. **Always strategic, now also tactical** — Previous Serena versions gave great strategic analysis but left execution to you. Now the analysis comes with built-in next steps. Ask "What's the highest ROI opportunity?" and you'll get the strategic reasoning plus actionable cards you can execute immediately. Open the [Serena](https://app.rankability.com/clients) on any client to try the new action proposals. ## Tracker v5.2 - Citation sentiment analysis, Search Domination upgrade **New** Tracker now analyzes the sentiment of every source cited in AI answers — so you know not just where your brand appears, but how it's being portrayed. Combined with a Search Domination upgrade on the traditional search tab, this release gives you deeper visibility across both AI and organic search. **Sentiment analysis in AI citations** — When AI platforms like ChatGPT, Perplexity, Gemini, or Claude cite sources in their answers about your tracked keywords, Tracker now reads the cited page content and classifies how each source portrays your brand: positive, negative, neutral, or mixed. Each classification includes a specific reason explaining the assessment — not just a label, but the why behind it. This surfaces brand perception risks you'd never catch manually: a competitor comparison article cited by ChatGPT that frames your product unfavorably, a review site with outdated information, or a forum thread with mixed sentiment that AI platforms treat as authoritative. **Why citation sentiment matters** — AI search engines don't just link to sources — they synthesize them into answers. A single negative citation can shape how an AI platform describes your brand to thousands of users. Knowing the sentiment of cited sources lets you prioritize outreach: engage with negative mentions, amplify positive ones, and monitor mixed signals before they become problems. **YouTube transcript analysis** — Citation analysis previously couldn't analyze YouTube URLs because video pages block standard web scraping. Now, when a citation links to a YouTube video, Tracker automatically fetches the video's transcript and runs the same brand mention detection and sentiment analysis. YouTube videos are among the most commonly cited sources in AI answers — they're no longer black boxes. **Search Domination score on traditional search** — The traditional search tab now features a prominent Search Domination display showing how many of the top 30 ranking positions your domain holds across selected search engines. A circular gauge shows your percentage with color-coded ratings (Dominant, Strong, Moderate, Low, Minimal), alongside a competitor breakdown showing which domains hold the remaining spots. Previously this score was only visible in the AI search view — now it's front and center for Google organic rankings too. **Cleaner AI search view** — The top-level AI sentiment overview block has been removed from the AI search tab. Sentiment data is now surfaced directly in the citation analysis detail view where it's more actionable — each citation shows its sentiment inline rather than as a disconnected summary card. These improvements are live for all Tracker projects. Open any project in the [Tracker](https://app.rankability.com/rank-tracker) and run a scan to see citation sentiment in action. ## Serena v4.0 - Full workspace awareness **New** Serena can now see and answer questions about every tool in your workspace — Copywriter projects, Site Audits, Promoter backlink profiles, Keyword Research, Builder sites, and Rank Tracker keywords. No more "I don't have access to that" responses when you ask about your own data. **Ask about your Copywriter projects** — "How many projects are in progress?" "Which ones are complete?" "What's my average Rankability score?" Serena sees every project by name, with the exact same status labels you see on the Copywriter page (In progress, Brief ready, Incomplete, Complete) — not confusing internal database values. It knows which projects have drafts, which are waiting on briefs, and which you've marked done. **Backlink profile at your fingertips** — Serena now pulls directly from your Promoter data. Ask about your backlink profile and get real numbers: total backlinks, referring domains, dofollow vs nofollow breakdown, 30-day link velocity, and your Domain Score (DS). It cross-references this with your brand positioning to identify where your link equity is helping — and where it's not. **Site Audit visibility** — Serena knows how many audit issues you have, broken down by severity (critical, warning, resolved vs unresolved). Ask "What's the state of our site audit?" and get a clear picture without opening the Auditor. **Keyword Research and Rank Tracking** — Serena sees your researched keywords from the Researcher and your actively tracked keywords from the Rank Tracker. It can connect the dots: "Am I tracking the keywords I've researched?" "Do I have content for the keywords I'm ranking for?" **Builder awareness** — If you've created sites in the Builder, Serena knows how many sites and pages exist. **Cross-tool strategic insight** — The real power is in the connections. Serena can now reason across your entire workspace: "I have 7 in-progress Copywriter projects but I'm only tracking 4 keywords — am I missing coverage?" or "My backlink profile shows 18,000 links but my domain score is 30 — what should I focus on?" Every answer is grounded in your actual data, not generic advice. Just open your [Serena](https://app.rankability.com/clients) and ask about any part of your workspace. ## Researcher v1.5 - Now available in 32 countries **New** The Researcher now supports keyword research in 32 countries, up from 8. You can run localized keyword research for any of these markets directly from the country selector when starting a new research project. **English-speaking markets** — United States, United Kingdom, Australia, New Zealand, Canada, Ireland, South Africa, Singapore. **Europe** — Germany, France, Spain, Italy, Netherlands, Belgium, Austria, Switzerland, Sweden, Norway, Denmark, Finland, Portugal, Poland. **Asia-Pacific** — India, Japan, South Korea, Hong Kong, Malaysia, Thailand, Philippines. **Latin America** — Brazil, Mexico. **Middle East** — United Arab Emirates. Each country targets the local Google domain (e.g. Google.de for Germany, Google.co.jp for Japan) so search volume, keyword difficulty, and SERP data reflect what users in that market actually see. If your clients operate internationally or you're building content strategies for non-US audiences, you can now get accurate local data without workarounds. Select a country from the dropdown when creating a new project in the [Researcher](https://app.rankability.com/researcher) to get started. ## Copywriter v4.5 - AI editing assistant **New** The Copywriter editor now has a built-in AI chat assistant that helps you refine, expand, and improve your content through natural conversation - right alongside your draft. **Edit by asking** - Instead of manually rewriting paragraphs or wrestling with prompts, just tell the AI what you want. "Make the intro more compelling," "Add a section about pricing," "Tighten up the conclusion" - describe the change in plain language and the AI applies it directly to your draft. You stay in the editor the whole time. **See exactly what changed** - Every edit the AI makes is highlighted in blue directly in your draft, so you can instantly see what was added or modified. Highlights fade after a few seconds, leaving you with a clean document. No guessing, no diffing - you always know what the AI touched. **Context-aware suggestions** - The assistant knows your topic, target keywords, entities, competitors, and search queries. When it makes edits or gives advice, it draws on the same research and SEO data that powers your brief - so suggestions are specific to your article, not generic writing tips. **Ask questions without editing** - Not ready to change anything yet? Use the chat to brainstorm angles, ask for feedback on a section, get ideas for a stronger hook, or check whether you've covered a topic thoroughly enough. The AI gives detailed, actionable guidance you can apply on your own terms. **Conversation that builds** - The chat remembers your conversation within the session. Ask a follow-up, refine a previous suggestion, or change direction - the AI keeps up without you having to repeat context. **Works in every mode** - The AI tab appears in both the standard article editor and YouTube Script mode, so you can use it regardless of what content type you're working on. Open any draft in the [Copywriter](https://app.rankability.com/copywriter) and click the AI tab in the sidebar to start a conversation with your content. ## Copywriter v4.4 - Smarter knowledge base grounding **New** We've significantly improved how the Copywriter uses your knowledge base when generating briefs, outlines, and drafts — giving you more control over which sources are used and making the grounding more accurate across different content types. **Priority sources** — You can now star any knowledge base source to guarantee it's included in every content generation run, regardless of topic relevance scoring. Use this for your most important brand materials — service pages, brand guidelines, case studies, product specs — so they always shape the output. Priority sources are guaranteed a slot, with remaining slots filled by the most relevant non-priority sources. **Smarter automatic source selection** — When you don't manually pick sources, the system now scores each source's keyword overlap with the current topic and selects the most relevant ones (up to 6). Previously, source selection was less targeted. Now the most relevant content rises to the top automatically, so your briefs reflect the right source material without you having to curate every time. **Intent-aware brand integration** — The grounding system now adapts based on the content's intent. Informational and discovery content (blog posts, guides) uses your brand voice for thought leadership without turning educational content into a sales pitch. Conversion content (landing pages, service pages) weaves in services, USPs, and calls to action where they belong — so the AI matches tone to purpose. **Better outline protection** — Outline regeneration now detects when the AI produces a generic fallback instead of a structured outline, and keeps your existing outline rather than replacing it with lower-quality content. Your work is preserved automatically. These improvements are active automatically. Open any [Copywriter](https://app.rankability.com/copywriter) project and regenerate a brief to see the difference. ## Serena v3.2 - Priority sources and smarter source selection **Improved** You now have direct control over which knowledge base sources the AI prioritizes when generating content — star your most important sources and they'll always be included. **Star to prioritize** — Click the star icon on any completed knowledge base source to mark it as a priority. Priority sources are always included when the Copywriter generates briefs, outlines, or drafts — regardless of how the automatic topic-relevance scoring ranks them. Use this for core brand materials you want reflected in every piece of content: your main service page, brand guidelines, key case studies, or product documentation. **Available everywhere you manage sources** — The star toggle appears on completed sources in both Serena page and the Knowledge Base sources panel in the Copywriter sidebar. Star a source from whichever view you're already working in. **Smart slot allocation** — The Copywriter uses up to 6 knowledge base sources per content generation run. Priority sources are guaranteed their slots first. Any remaining slots are filled by the most topic-relevant non-priority sources, scored by keyword overlap with the current topic. This means you get the best of both worlds: your essential brand materials are always present, and the system still finds the most relevant supplementary content automatically. **Why it matters** — Not all knowledge base sources are equally important. A detailed service page or brand voice document should inform every piece of content, while a blog post about a niche topic is only relevant sometimes. Priority sources let you make that distinction explicit instead of relying entirely on automatic selection. To mark priority sources, open your client's [Knowledge Base](https://app.rankability.com/clients) and click the star icon on any completed source. ## API v1.2 - Knowledge Base endpoint **New** The Rankability API now includes a Knowledge Base endpoint that gives you programmatic access to every help article and FAQ in the platform — so your AI agents, internal tools, and support systems can stay in sync with the latest Rankability documentation. **Full article access** — The new `GET /api/agent/v1/kb/articles` endpoint returns every published Knowledge Base article with its title, content, category, and metadata. Use it to feed Rankability documentation into your AI assistants, internal wikis, or client-facing help portals. **JSON and Markdown formats** — Request articles as structured JSON (default) for programmatic consumption, or set `Accept: text/markdown` to get a single Markdown document organized by category — ideal for feeding directly into LLMs or documentation generators. **Efficient caching** — The endpoint supports conditional requests with ETag and Last-Modified headers. Your integration can skip re-downloading content that hasn't changed, reducing bandwidth and API calls. Send `If-None-Match` or `If-Modified-Since` headers and receive a `304 Not Modified` when nothing has been updated. **FAQ included** — The response includes the full Rankability FAQ alongside the Knowledge Base articles, giving your tools a complete picture of platform capabilities, pricing, and common questions. **New scope** — Add the `kb:read` scope to your API key to access this endpoint. You can add it to an existing key or create a dedicated one from [Settings > API keys](https://app.rankability.com/settings). **Use cases** — Train an internal AI support agent on Rankability's full documentation. Sync help content into your agency's knowledge management system. Build a custom help widget that pulls live content from Rankability. Power an onboarding chatbot that answers new team members' questions about the platform. Full endpoint documentation is available in the [Help Center](https://help.rankability.com) under "Knowledge Base API endpoint." ## Auditor v1.4 - Import source of truth from Google Business Profile **New** The Brand Consistency Auditor can now pull your verified business information directly from Google Business Profile — eliminating manual data entry and ensuring your audit starts from the most authoritative source available. **One-click GBP import** — If your client has a Google Business Profile connected, you'll see an "Import from GBP" button when setting up a brand audit. Click it and the auditor instantly populates your source of truth with the business name, address, phone number, website, description, primary category, secondary categories, and business hours — all pulled live from the GBP API. **Start from your verified data** — Google Business Profile is often the most complete and up-to-date source of business information. By importing directly from GBP, your brand consistency audit starts from data you've already verified with Google rather than data scraped from your website, which may be incomplete or formatted differently. **Fills empty fields only** — The import is non-destructive. If you've already entered some information manually or via website auto-discovery, the GBP import only fills in fields that are still empty. It won't overwrite anything you've already set. **Works alongside auto-discovery** — Use GBP import and website auto-discovery together for the most complete source of truth. Let auto-discovery pull your brand messaging and meta descriptions from your website, then use GBP import to fill in NAP data, categories, and business hours that might not be on your site. **Post-import verification** — After importing, the auditor verifies the GBP connection is healthy and the data is current. If there's an issue with the GBP token or location, you'll see a clear error message instead of silently importing stale data. To use this feature, make sure your client has a Google Business Profile connected in their [client settings](https://app.rankability.com/clients). Then start a new Brand Consistency Audit from [Audit](https://app.rankability.com/audit) and click "Import from GBP" in the setup form. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.rankability.com/changelog/2026-04.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.