# Ranqo Docs

> Documentation for Ranqo, the complete AI search visibility suite. Ranqo tracks how ChatGPT, Gemini, Perplexity, Google AI Overviews, Claude, and Grok answer the questions buyers ask, audits pages for AI readability, ranks the fixes most likely to move visibility, and drafts content for the prompts a brand does not win.

Every number in these docs (plan limits, engine pools, thresholds) is rendered from the code that enforces it. Each page is also available as markdown at its URL with `.md` appended.

## Guides: Get started

- [Introduction](https://ranqo.ai/docs/guides.md): Guides for every page of the Ranqo dashboard, the method behind every number, and the integrations that bring your own traffic in.
- [How Ranqo works](https://ranqo.ai/docs/guides/how-ranqo-works.md): What Ranqo measures, how often it runs, and what each dashboard page in the Monitor, Analyze, Act and Create loop is for.
- [Quickstart: add your first brand](https://ranqo.ai/docs/guides/quickstart.md): Add a brand from its website, confirm the profile, market and keywords, pick themes and engines, and watch the first run land.
- [Your first week](https://ranqo.ai/docs/guides/first-week.md): What happens after your first run, when the next one is due, what Ranqo refreshes by itself, and what to look at in your first week.
- [Tour the dashboard](https://ranqo.ai/docs/guides/dashboard-tour.md): A walk through the Ranqo dashboard, covering the Home page band by band, the sidebar and brand switcher, the header, and the Help menu.
- [Plans and limits](https://ranqo.ai/docs/guides/plans-and-limits.md): Every Ranqo plan's limits in one table, from brands and prompts to AI engines, audits and posts, rendered straight from the billing config.
- [Glossary](https://ranqo.ai/docs/guides/glossary.md): Plain definitions of the terms the Ranqo dashboard uses, from prompts, runs and engines to Share of Voice, citations, noise bands and confirmed wins.

## Guides: Monitor

- [Visibility page](https://ranqo.ai/docs/guides/visibility.md): Read the Visibility page, from the four headline numbers and the trend chart to engine and category breakdowns, cited sources and filters.
- [Prompts](https://ranqo.ai/docs/guides/prompts.md): Add, generate, track and pause the questions Ranqo asks AI engines for your brand, and read each prompt's results on its own page.
- [Themes](https://ranqo.ai/docs/guides/themes.md): Group prompts into themes, take new topics from research on your category, generate prompts for a theme and delete a theme safely.
- [Competitors](https://ranqo.ai/docs/guides/competitors.md): See which brands AI names alongside you, compare yourself with them prompt by prompt, keep a watchlist and fix merged competitor names.
- [Sources](https://ranqo.ai/docs/guides/sources.md): See which websites and pages AI engines cite when they answer your prompts, what kind of sites they are, and export the list to Excel or CSV.
- [Traffic](https://ranqo.ai/docs/guides/traffic.md): See the people who reach your site from AI answers, search and social, and the AI crawlers reading it, from Site Tracking and Google Analytics.
- [Snapshots](https://ranqo.ai/docs/guides/snapshots.md): Snapshots lists every tracking run for a brand. Learn how weekly runs are scheduled, how to read one run, and what failed or partial runs mean.

## Guides: Analyze

- [Page Audit](https://ranqo.ai/docs/guides/page-audit.md): Audit any page on your site on the dimensions that decide whether AI can read and cite it, then work through the fixes each audit finds.
- [Site Access](https://ranqo.ai/docs/guides/site-access.md): Check whether AI crawlers and search engines can actually fetch your site, what your server tells each one, and what to fix when one is blocked.

## Guides: Act

- [Action Center](https://ranqo.ai/docs/guides/action-center.md): Work through prioritized recommendations built from your tracking data, then measure whether each one moved your visibility, counted in runs.
- [Outreach](https://ranqo.ai/docs/guides/outreach.md): Find the Reddit threads, communities and publications AI cites for your category, rank them, draft a reply or pitch, and track the work to done.

## Guides: Create

- [Blog Ideas](https://ranqo.ai/docs/guides/blog-ideas.md): Get article ideas written from the tracked prompts where AI does not name you, see the evidence behind each one, and send the best to Generate Blog.
- [Generate Blog](https://ranqo.ai/docs/guides/generate-blog.md): Write a full blog post from a title, in a Rich or Standard format and the length you choose, grounded in your brand profile and visibility data.
- [Content Optimizer](https://ranqo.ai/docs/guides/content-optimizer.md): Rewrite a page you already publish so AI engines can quote it, with before and after text for every change, a generated FAQ and schema markup.
- [Publishing to WordPress](https://ranqo.ai/docs/guides/publishing.md): Send a generated post to your WordPress site as a draft or live, update it later in place, and add its JSON-LD schema separately.
- [Exporting content](https://ranqo.ai/docs/guides/exporting-content.md): Download a generated post as HTML, Markdown or a ZIP bundle, or copy its HTML, Markdown or JSON-LD, and copy the changes from an optimization.

## Guides: Account and team

- [Brand settings](https://ranqo.ai/docs/guides/brand-settings.md): Edit a brand's name, description, aliases, market, language, keywords and engines, what each change affects, and how to pause, delete or restore a brand.
- [Team and seats](https://ranqo.ai/docs/guides/team.md): Invite teammates to your Ranqo account, how seats and pending invites are counted, what members can and cannot do, and how to remove or leave.
- [Billing and trials](https://ranqo.ai/docs/guides/billing.md): How the Ranqo free trial works, how to subscribe or cancel, what happens when a trial ends, how removed brands count, and where invoices live.
- [Reports and exports](https://ranqo.ai/docs/guides/reports-and-exports.md): Export the Visibility report as a PDF, a Page Audit as a concise or detailed PDF, and Sources data as Excel or CSV, and how shared report links work.
- [Tours, tutorials and AI assistants](https://ranqo.ai/docs/guides/tours-and-tutorials.md): Take a page tour, watch Learning Center tutorials, turn off tours that open by themselves, and read these docs with ChatGPT, Claude or any AI tool.

## Guides: Troubleshooting

- [Visibility is zero](https://ranqo.ai/docs/guides/troubleshooting/visibility-is-zero.md): Why the Visibility page shows 0% or --, how to tell the causes apart, and what to change: setup, filters, aliases or your prompts.
- [A score dropped](https://ranqo.ai/docs/guides/troubleshooting/score-dropped.md): How to read a drop in visibility or Share of Voice: noise between runs, changes to what you track, and how to find a real change.
- [No data for an engine](https://ranqo.ai/docs/guides/troubleshooting/no-data-for-an-engine.md): Why an AI engine shows no results or no citations: not in your plan or brand, set per prompt, no AI Overview shown, or queries that failed.
- [Site Tracking shows no events](https://ranqo.ai/docs/guides/troubleshooting/site-tracking-no-events.md): A checklist for when Site Tracking receives nothing: the test request, the site key, the environment, the middleware, skipped requests and caching.
- [Google Analytics is not syncing](https://ranqo.ai/docs/guides/troubleshooting/ga4-not-syncing.md): Fix a GA4 connection that shows no data: a first sync that never finishes, expired access, missing Viewer permission, the wrong property, history limits.
- [WordPress connection fails](https://ranqo.ai/docs/guides/troubleshooting/wordpress-connection-fails.md): Every message the WordPress connection test can show, what causes it, and how to fix it: site URL, credentials, application passwords, the REST API.

## Methodology: Metrics

- [How Ranqo measures](https://ranqo.ai/docs/methodology.md): How Ranqo asks your prompts on each AI engine every week, reads every answer, and turns those answers into the numbers on your dashboard.
- [Visibility](https://ranqo.ai/docs/methodology/visibility.md): How Ranqo calculates Visibility, the share of AI answers that name your brand, and why it is weighted by engine.
- [Share of Voice](https://ranqo.ai/docs/methodology/share-of-voice.md): How Ranqo calculates Share of Voice, which competitors count toward it, and how it differs from Visibility.
- [Average position](https://ranqo.ai/docs/methodology/average-position.md): How Ranqo finds your rank inside each AI answer, what the average position covers, and why a lower number is better.
- [Sentiment](https://ranqo.ai/docs/methodology/sentiment.md): How Ranqo labels each AI mention of your brand as positive, neutral or negative, and turns the labels into a 0 to 100 score where 50 is neutral.
- [Citations](https://ranqo.ai/docs/methodology/citations.md): What counts as a citation in Ranqo, how % Answers differs from % Citations, what one cited page is, and which sites count as your own.
- [Source and article types](https://ranqo.ai/docs/methodology/source-and-article-types.md): How Ranqo sorts every cited site by its relationship to you, from your own site to competitors, editorial and forums, and every cited page by format.
- [Difficulty and volume](https://ranqo.ai/docs/methodology/difficulty-and-volume.md): How Ranqo measures a prompt's difficulty from how many competitors AI names in its answers, and what the volume estimate means and does not mean.

## Methodology: Trends

- [One point per run](https://ranqo.ai/docs/methodology/one-point-per-run.md): Why Ranqo's trend charts plot one point for each tracking run, leave unmeasured days blank, and only show a change when there are two runs.
- [Carried values](https://ranqo.ai/docs/methodology/carried-values.md): When the date range you pick holds no tracking run, most pages show the last completed run with an As of date and no change. Here is why.
- [Time zones](https://ranqo.ai/docs/methodology/time-zones.md): Ranqo's date ranges start at midnight in your browser's time zone. What that means for chart dates, and when a colleague elsewhere sees other figures.

## Methodology: Measuring impact

- [Measurement windows](https://ranqo.ai/docs/methodology/measurement-windows.md): The Action Center measures each finished action over a set number of tracking runs, not days. What each countdown means and why runs are the unit.
- [Noise bands](https://ranqo.ai/docs/methodology/noise-bands.md): How much AI visibility moves between runs when nothing changed, how Ranqo measured it, and where a smaller lift reads No detectable change.
- [Confirmed wins](https://ranqo.ai/docs/methodology/confirmed-wins.md): How the Action Center counts the specific answers you won after acting, and why a mention must hold for two runs before it counts as a win.

## Methodology: Data

- [Competitor identity](https://ranqo.ai/docs/methodology/competitor-identity.md): How Ranqo groups the different spellings of one competitor under a single name, how separating one works, and how competitor websites and logos are found.
- [Why numbers change](https://ranqo.ai/docs/methodology/why-numbers-change.md): Every reason a Ranqo figure can move, even for a week that is over, from new runs and filters to prompt edits, competitor names and failed queries.
- [Crawlers](https://ranqo.ai/docs/methodology/crawlers.md): RanqoBot, Ranqo's own crawler, and how to allow or block it, plus the AI crawlers Site Access tests and the bots Site Tracking recognises.

## Integrations: Overview

- [Integrations](https://ranqo.ai/docs/integrations.md): Connect Google Analytics 4 for referral traffic, WordPress for publishing, and Site Tracking to see the AI crawlers that read your site.

## Integrations: Analytics

- [Google Analytics 4](https://ranqo.ai/docs/integrations/ga4.md): Connect a GA4 property with read-only access so the Traffic page shows sessions and conversions from AI assistants and search engines.

## Integrations: Publishing

- [WordPress](https://ranqo.ai/docs/integrations/wordpress.md): Connect a WordPress site with an application password so Ranqo can send your generated posts to it, as drafts or as live posts.

## Integrations: Site Tracking

- [Site Tracking](https://ranqo.ai/docs/integrations/site-tracking.md): Server-side capture of every page request to your site, including the AI crawlers that run no JavaScript, sorted into bots and human visits.
- [Site Tracking for Next.js](https://ranqo.ai/docs/integrations/site-tracking/nextjs.md): Send AI crawler visits and AI referrals from a Next.js site to Ranqo with one middleware file. Works on Next.js 15 and 16.
- [Site Tracking for Express](https://ranqo.ai/docs/integrations/site-tracking/express.md): Send AI crawler visits and AI referrals from an Express app to Ranqo with one middleware function, with notes for Fastify, Hono and Koa.
- [Site Tracking for Cloudflare Workers](https://ranqo.ai/docs/integrations/site-tracking/cloudflare-worker.md): Send AI crawler visits and AI referrals to Ranqo from a Cloudflare Worker in front of your site, whatever the site itself runs on.
- [Site Tracking for any backend](https://ranqo.ai/docs/integrations/site-tracking/any-backend.md): Add Site Tracking to any server that can make an HTTP request, from Python and Ruby to Go and PHP, with the rules every install must follow.
- [Verify your install](https://ranqo.ai/docs/integrations/site-tracking/verify.md): Check that Ranqo accepts your site key, confirm the first real visit on the install page, and find out why a report returns ok false.
- [Site keys](https://ranqo.ai/docs/integrations/site-tracking/keys.md): Where to find a brand's Site Tracking key, who can create one, how many your plan allows, how to keep it private, and what revoking it does.
- [Intake API](https://ranqo.ai/docs/integrations/site-tracking/intake-api.md): Reference for the public Site Tracking endpoint every install calls, with its parameters, response, rate limit and monthly allowances.
- [What Site Tracking sends and stores](https://ranqo.ai/docs/integrations/site-tracking/privacy.md): Exactly what your server sends to Ranqo for each page view, what Ranqo stores, how visitor IP addresses are handled, and what is never collected.

## API: Get started

- [Ranqo API](https://ranqo.ai/docs/api.md): Read your Ranqo data from your own tools with an API key. Brands, visibility, competitors, prompts, answers, audits and recommendations.
- [API quickstart](https://ranqo.ai/docs/api/quickstart.md): Create a Ranqo API key, check it with your first request, find your brand's id and read its visibility over the last 30 days.
- [API authentication](https://ranqo.ai/docs/api/authentication.md): How Ranqo API keys work, where to send them, which brands a key can read, and what happens when a key expires or is revoked.

## API: Using the API

- [API rate limits](https://ranqo.ai/docs/api/rate-limits.md): How many requests a Ranqo API key can make each minute on each plan, the headers that report it, and how to handle a rate-limited request.
- [API errors](https://ranqo.ai/docs/api/errors.md): Every error the Ranqo API returns, as problem details with a stable code, what each one means and what to do when you receive it.
- [API pagination](https://ranqo.ai/docs/api/pagination.md): How the Ranqo API pages through long lists with a cursor, the page sizes each list takes, and what to do when a cursor is refused.
- [Dates and time zones in the API](https://ranqo.ai/docs/api/dates-and-time-zones.md): How the Ranqo API sets a report window, where its days start and end, how a window with no run is read, and how timestamps are written.
- [API versioning](https://ranqo.ai/docs/api/versioning.md): How the Ranqo API is versioned, which changes happen within a version, and how to write a client that keeps working as the API grows.

## API: Account

- [Get the account](https://ranqo.ai/docs/api/reference/get-account.md): Read the account an API key belongs to: its plan, its rate limit, and the key's own name, expiry and brand access.

## API: Brands

- [List brands](https://ranqo.ai/docs/api/reference/list-brands.md): List the brands an API key can read, oldest first, each with the stored scores of its latest completed tracking run.
- [Get a brand](https://ranqo.ai/docs/api/reference/get-brand.md): Read one brand by id: its domain, market and language, with the stored scores of its latest completed tracking run.

## API: Visibility

- [Get visibility](https://ranqo.ai/docs/api/reference/get-visibility.md): Read a brand's visibility, share of voice, position and sentiment over a window, against the one before, by engine or category.

## API: Competitors

- [List competitors](https://ranqo.ai/docs/api/reference/list-competitors.md): Read the brands AI answers name alongside yours, ranked by visibility over a window, with each one's share of voice.

## API: Runs

- [List runs](https://ranqo.ai/docs/api/reference/list-runs.md): List a brand's tracking runs, newest first, with each completed run's stored visibility, position and answer counts.
- [Get a run](https://ranqo.ai/docs/api/reference/get-run.md): Read one tracking run by id: its state, the engines it asked, its counts, and its stored visibility once it completes.

## API: Prompts

- [List prompts](https://ranqo.ai/docs/api/reference/list-prompts.md): List a brand's prompts, oldest first, filtered by tracking state, category or theme, with volume and difficulty.
- [Get a prompt](https://ranqo.ai/docs/api/reference/get-prompt.md): Read one prompt by id: its text, category, theme and market, whether it is tracked, and its volume and difficulty.
- [List a prompt's answers](https://ranqo.ai/docs/api/reference/list-answers.md): List the AI answers a prompt got over a window, newest first, with the brands they named and the sources they cited.

## API: Site Access

- [Get site access](https://ranqo.ai/docs/api/reference/get-site-access.md): Read whether AI crawlers and search engines can fetch a brand's site: each crawler's verdict, the findings and history.

## API: Page audits

- [List page audits](https://ranqo.ai/docs/api/reference/list-page-audits.md): List a brand's page audits, newest first, with each page's score and its score on every dimension audited.
- [Get a page audit](https://ranqo.ai/docs/api/reference/get-page-audit.md): Read one page audit by id, with each dimension's score, summary, recommendations and the checks behind the score.

## API: Recommendations

- [List recommendations](https://ranqo.ai/docs/api/reference/list-recommendations.md): List a brand's Action Center recommendations, newest first, with each done one's measurement window and lift.
- [Get a recommendation](https://ranqo.ai/docs/api/reference/get-recommendation.md): Read one Action Center recommendation by id: its steps, its column, and what its measurement found once done.

## API: Outreach

- [List outreach targets](https://ranqo.ai/docs/api/reference/list-outreach-targets.md): List a brand's Outreach targets in the board's rank order: the subreddits, threads and pages AI answers cite.

## Optional

- [Full documentation in one file](https://ranqo.ai/docs/llms-full.txt): every page above, concatenated