# Citino

> How Citino measures your brand in AI answers, every screen explained, and the API and MCP server.

- [Citino docs](https://docs.citino.ai/index.md): How Citino measures your brand in AI answers, every screen explained, and the API and MCP server.
- [What Citino does](https://docs.citino.ai/guides/introduction.md): Citino records what AI engines tell your buyers, shows where you stand against your competitors, and helps you change it.
- [Quickstart](https://docs.citino.ai/guides/quickstart.md): Sign up, set up your first project in four steps, and see your first figures.
- [Invite your team](https://docs.citino.ai/guides/invite-your-team.md): Add colleagues to your workspace and choose what each of them can change.
- [Visibility](https://docs.citino.ai/guides/visibility.md): The share of AI answers that named your brand, and how to read it.
- [Share of voice](https://docs.citino.ai/guides/share-of-voice.md): How much of the brand talk in AI answers is about you, and how it differs from visibility.
- [Position when named](https://docs.citino.ai/guides/position.md): Where your brand appears in an AI answer when it is named, and how to read it.
- [Sentiment when named](https://docs.citino.ai/guides/sentiment.md): How favourably AI answers describe your brand when they name it.
- [The ± band and n](https://docs.citino.ai/guides/bands-and-sample-size.md): What the two small marks beside every number mean, and when a number is still early.
- [Within noise](https://docs.citino.ai/guides/within-noise.md): Why some changes are shown muted with no arrow, and why they never raise an alert.
- [Scope, segments and claimed segments](https://docs.citino.ai/guides/scope-and-segments.md): Which questions, days and engines your numbers are counted over, and how to change that.
- [Drift labels](https://docs.citino.ai/guides/drift-labels.md): What it means when a day is marked because an AI engine changed how it answers.
- [Glossary](https://docs.citino.ai/guides/glossary.md): Every term the app explains with its ? button, in the same words.
- [Overview](https://docs.citino.ai/guides/screens/overview.md): The daily check: what moved, where you stand against the brands the engines name, and where to go next.
- [Brands](https://docs.citino.ai/guides/screens/brands.md): Every brand the engines name in answers to your questions, ranked by visibility, and which of them you track.
- [Prompts](https://docs.citino.ai/guides/screens/prompts.md): Every question Citino asks for you, how each one is going, and how to add one of your own.
- [Answers](https://docs.citino.ai/guides/screens/answers.md): Every answer the AI engines gave to your questions, in full, searchable, with who was named and which pages were read.
- [Sources](https://docs.citino.ai/guides/screens/sources.md): Which websites the engines read while answering your questions, which of them you can do something about, and what the engines searched for.
- [Gaps](https://docs.citino.ai/guides/screens/gaps.md): The work queue: the questions you are losing, why, and the work most likely to get you named, from evidence through to a published change.
- [Experiments](https://docs.citino.ai/guides/screens/experiments.md): Did a change you published work, or did your competitors move? Every published change, measured against them.
- [Claims](https://docs.citino.ai/guides/screens/claims.md): The facts you state about your brand, what each engine says about them today, and since when.
- [Objections](https://docs.citino.ai/guides/screens/objections.md): What the AI engines argue against your brand when a buyer is deciding, how prominent each argument is, and which pages it comes from.
- [Crawlability](https://docs.citino.ai/guides/screens/crawlability.md): Which AI crawlers your site’s robots.txt lets in, which engines each one feeds, and what to change when one is blocked.
- [Crawler activity](https://docs.citino.ai/guides/screens/crawler-activity.md): Which AI crawlers fetched which of your pages, when, and with what result, from your own site’s logs.
- [Attribution](https://docs.citino.ai/guides/screens/attribution.md): Whether being named sent real visitors: AI-referred sessions from Google Analytics, matched back to your questions, with how much of the traffic could be matched.
- [Alerts](https://docs.citino.ai/guides/screens/alerts.md): Five rules that watch your project and record a finding when something moves by more than chance, with an opt-in daily email and Slack.
- [Project settings](https://docs.citino.ai/guides/screens/project-settings.md): Where a project’s scope is set: its brand and spellings, competitors, engines, segments, domains, objection questions, and archiving.
- [Clients](https://docs.citino.ai/guides/agencies/clients.md): Run each client brand as its own project: the first is set up for you at sign-up, and every later one is added from All projects.
- [Reports and share links](https://docs.citino.ai/guides/agencies/reports-and-share-links.md): Generate a client's month as a branded report, send its link, and turn the link off when you need to.
- [The client portal](https://docs.citino.ai/guides/agencies/client-portal.md): Give a client a sign-in that shows their own reports, branded as your agency, and nothing else in your workspace.
- [White label](https://docs.citino.ai/guides/agencies/white-label.md): Put your agency's name, colour, logo and contact on every client report and in your clients' portal.
- [Workspace settings and roles](https://docs.citino.ai/guides/account/workspace-settings.md): Your workspace's name, its members and their roles, API keys, the MCP address, connected apps and the audit log.
- [Plans and prompt limits](https://docs.citino.ai/guides/account/plans-and-limits.md): What each plan includes, how your prompts are counted across projects, and what happens when you reach the limit.
- [Engines and opt-ins](https://docs.citino.ai/guides/account/engines.md): Which AI engines every project is asked on, which ones you can switch on, and where the switch is.
- [Integrations](https://docs.citino.ai/guides/account/integrations.md): Connect Google Analytics 4, Slack, CMS publishing to your WordPress or Webflow site, and your AI crawler logs to a project.
- [How answers are collected](https://docs.citino.ai/guides/methodology/collection.md): How Citino asks each question, what it stores from every answer, what it reads out of it, and how the questions themselves are built.
- [Cadence](https://docs.citino.ai/guides/methodology/cadence.md): When each question is asked: once a day on every engine, a first collection the moment a project is created, and further tries when an engine fails.
- [How bands are computed](https://docs.citino.ai/guides/methodology/bands.md): How the ± range beside a number is worked out, why it is built across questions, and why a number sometimes has none.
- [Drift](https://docs.citino.ai/guides/methodology/drift.md): How Citino spots the days an engine changed how it answers, how those days are labelled, and why no answer is ever dropped because of them.
- [What we do not measure](https://docs.citino.ai/guides/methodology/what-we-do-not-measure.md): The answers, engines, markets and signals outside Citino's sample, stated plainly so you can read every number for what it is.
- [FAQ](https://docs.citino.ai/guides/help/faq.md): Short answers to the questions people ask most about Citino's numbers, engines, plans and data.
- [Troubleshooting](https://docs.citino.ai/guides/help/troubleshooting.md): What it means, and what to do, when a number, a connection, a key or a link does not look the way you expected.
- [Contact](https://docs.citino.ai/guides/help/contact.md): How to reach us, what to put in your message so we can help quickly, and what never to send.
- [Citino API](https://docs.citino.ai/api/introduction.md): Read every number the dashboard shows, pull report rows into your own tools, and change your prompts and competitors from code.
- [API quickstart](https://docs.citino.ai/api/quickstart.md): Make a key, list your projects, read your headline figures and pull a day of report rows.
- [Authentication and scopes](https://docs.citino.ai/api/authentication.md): Every request carries a workspace API key as a Bearer token, and the key's scopes decide what it may read and change.
- [Base URL and versioning](https://docs.citino.ai/api/versioning.md): Every route lives under https://api.citino.ai/v1, the version is in the path, and changes inside v1 only ever add.
- [Rate limits](https://docs.citino.ai/api/rate-limits.md): Each key and each workspace has a budget of requests a minute, a report page counts as several requests, and every response tells you how much is left.
- [Pagination](https://docs.citino.ai/api/pagination.md): Lists come a page at a time: pass each page's next_cursor back as cursor until has_more is false.
- [Errors](https://docs.citino.ai/api/errors.md): Every error has the same shape: a machine-readable code to branch on, a sentence for a person, and sometimes the field or the detail that caused it.
- [Metric objects](https://docs.citino.ai/api/metric-objects.md): Every number the API returns is an object carrying its value, its ± band, how many answers it rests on, and whether a change is within noise.
- [Reports: dimensions, budgets and paging](https://docs.citino.ai/api/reports.md): Report rows for brands, domains and URLs, broken down by date, engine, segment and prompt, with every figure's band and sample size.
- [CSV output](https://docs.citino.ai/api/csv.md): Add format=csv to a list or report route and the page comes back as a CSV file, with every figure's band and sample size in their own columns.
- [Writes and idempotency](https://docs.citino.ai/api/writes.md): Add, re-word and archive prompts, and change competitors, aliases, segments and engines from a script, acting as the person who made the key.
- [Pulling data nightly](https://docs.citino.ai/api/nightly-pull.md): The pattern for a daily warehouse job: ask for yesterday only, with date as a dimension, and follow the cursor to the end.
- [Remove an alias](https://docs.citino.ai/api-reference/brand-and-competitors/remove-an-alias.md)
- [Stop tracking a competitor](https://docs.citino.ai/api-reference/brand-and-competitors/stop-tracking-a-competitor.md)
- [Add an alias](https://docs.citino.ai/api-reference/brand-and-competitors/add-an-alias.md): Another name answers use for the project's brand. Stored answers are re-scanned for it.
- [Track a competitor](https://docs.citino.ai/api-reference/brand-and-competitors/track-a-competitor.md): Tracks a brand already in Citino's registry, by id (any brand a report has returned). 201 when added, 200 when already tracked.
- [Get the metric definitions](https://docs.citino.ai/api-reference/definitions/get-the-metric-definitions.md): The definitions shown beside each number in the app, word for word. term finds one by key or name.
- [List the engines](https://docs.citino.ai/api-reference/engines/list-the-engines.md): Every AI engine Citino can sample, and how a project gets it: on by default, an opt-in a plan carries, or Enterprise only.
- [List your projects](https://docs.citino.ai/api-reference/projects/list-your-projects.md): Every project the key can read, oldest first. A key limited to some projects lists only those.
- [Get a project](https://docs.citino.ai/api-reference/projects/get-a-project.md): The project's configuration: brand, aliases, tracked competitors, market, engines and segments (only claimed segments count towards scores).
- [List the alerts](https://docs.citino.ai/api-reference/alerts/list-the-alerts.md): Findings that fired for the project, newest first.
- [Get AI traffic attribution](https://docs.citino.ai/api-reference/attribution/get-ai-traffic-attribution.md): Google Analytics sessions from AI referrers, matched to the prompts whose answers cited your pages. An estimate: coverage always travels with it, and money is in integer cents.
- [List the claims](https://docs.citino.ai/api-reference/claims/list-the-claims.md): The statements about your brand you track, and what each engine says about them in the window.
- [Crawlability](https://docs.citino.ai/api-reference/crawlability/crawlability.md): Whether each tracked domain's robots.txt lets the AI crawlers in.
- [Crawler activity](https://docs.citino.ai/api-reference/crawler-activity/crawler-activity.md): AI crawler visits to the project's own site, from the logs it sends. Verified and claimed visits are kept apart.
- [Get what moved](https://docs.citino.ai/api-reference/metrics/get-what-moved.md): Your figures that moved outside their band since the previous window of the same length.
- [Get visibility by engine](https://docs.citino.ai/api-reference/metrics/get-visibility-by-engine.md): Your visibility on each engine sampled, the brand leading there, and your overall rank.
- [Get the league table](https://docs.citino.ai/api-reference/metrics/get-the-league-table.md): Every brand named in the window with the same four figures. Your brand is the first row.
- [Get the headline figures](https://docs.citino.ai/api-reference/metrics/get-the-headline-figures.md): Visibility, share of voice, position and sentiment for your brand over the window, each with its band and sample size. metrics is null when your brand has no row.
- [Get visibility by segment](https://docs.citino.ai/api-reference/metrics/get-visibility-by-segment.md): Your visibility and the leader in every segment, and in every facet with prompts in scope. facets null means not computed; an empty list means none in scope.
- [Get the daily trend](https://docs.citino.ai/api-reference/metrics/get-the-daily-trend.md): Daily visibility for your brand, the leader and the two brands just above you, with markers on the days something changed.
- [Set engines](https://docs.citino.ai/api-reference/settings/set-engines.md): Replaces the engines the project samples from now on. Turning one off removes nothing measured; an opt-in the plan does not carry is a 402.
- [Set claimed segments](https://docs.citino.ai/api-reference/settings/set-claimed-segments.md): Replaces the segments the project claims. Scores are recomputed over stored history on the next read; nothing is collected. An id the project does not have is 400 naming it, and changes nothing; an id sent twice is claimed once.
- [List the experiments](https://docs.citino.ai/api-reference/experiments/list-the-experiments.md): Every change you published and measured: your visibility before and after, against the market's.
- [Get one experiment](https://docs.citino.ai/api-reference/experiments/get-one-experiment.md): One experiment with its windows, per-engine figures and the market-wide moves inside them.
- [List the prompts you are losing](https://docs.citino.ai/api-reference/prompts/list-the-prompts-you-are-losing.md): The questions your brand is furthest behind the winner on, largest gap first.
- [List the prompts](https://docs.citino.ai/api-reference/prompts/list-the-prompts.md): index is the unbranded questions behind the headline figures; custom is the branded and comparison ones. Two separate lists, never blended.
- [Add a prompt](https://docs.citino.ai/api-reference/prompts/add-a-prompt.md): Adds a question to the project's set, collected from the next scheduled day. Counts against the plan's prompt limit (402 at the limit); the same text twice is a 409 carrying the existing prompt's id.
- [Get one prompt](https://docs.citino.ai/api-reference/prompts/get-one-prompt.md): One question: your figures on it, per engine, every brand named, the sources read, and its replacement if it was reworded.
- [Archive a prompt](https://docs.citino.ai/api-reference/prompts/archive-a-prompt.md)
- [Re-word a prompt](https://docs.citino.ai/api-reference/prompts/re-word-a-prompt.md): Prompt text never changes, so a re-wording is a new prompt that replaces the old one, which is retired. Wording the project already has (archived and replaced prompts included) is 409 with detail.existing_prompt_id.
- [List objections](https://docs.citino.ai/api-reference/objections/list-objections.md): The objections AI engines raise against the project's brand, grouped and scored 0 to 100 by prominence. Only grouped objections are listed.
- [Get an objection](https://docs.citino.ai/api-reference/objections/get-an-objection.md): One grouped objection and the sources behind it.
- [List the monthly reports](https://docs.citino.ai/api-reference/monthly-reports/list-the-monthly-reports.md): The project's frozen monthly reports, newest first. Agency plans only.
- [Get one monthly report](https://docs.citino.ai/api-reference/monthly-reports/get-one-monthly-report.md): One month's figures as they stood when it was frozen: the headline figures, engines, what moved, the trend, losing prompts and the league.
- [Brands report](https://docs.citino.ai/api-reference/reports/brands-report.md): Visibility, share of voice, position and sentiment for every brand named in the project's unbranded questions, broken down by any of date, engine, segment and prompt. With prompt as a dimension the band is null. Without date as a dimension the window is limited by the project's size, in prompt-engin…
- [Domains report](https://docs.citino.ai/api-reference/reports/domains-report.md): How many answers retrieved and cited each domain, with the retrieval rate over answers whose engine reports what it read and the citation rate over every answer. Rates carry no band. Without date as a dimension the window is limited by the project's size, in prompt-engine-days; with date it may span…
- [URLs report](https://docs.citino.ai/api-reference/reports/urls-report.md): As the domains report, one row per URL, with no prompt dimension. A domain filter narrows the rows, not the window: Without date as a dimension the window is limited by the project's size, in prompt-engine-days; with date it may span 366 days and each page covers whole days. A page weighs 10 against…
- [List the runs](https://docs.citino.ai/api-reference/runs/list-the-runs.md): Every answer collected in the window, newest first, without the answer text. from and to are required and may span at most 366 days.
- [Get one run](https://docs.citino.ai/api-reference/runs/get-one-run.md): One collected answer and the question it answered. The answer text only with include=answer.
- [List engine searches](https://docs.citino.ai/api-reference/searches/list-engine-searches.md): The web searches AI engines ran before answering the project's questions, or with view=terms the words in them.
- [List the sources](https://docs.citino.ai/api-reference/sources/list-the-sources.md): The domains engines read and cited, grouped by what you can act on, competitor-owned and yours. Retrieved and cited each have their own denominator.
- [Get one source](https://docs.citino.ai/api-reference/sources/get-one-source.md): One domain: its shares, the prompts it was read for, and the brands named in answers that read it.
- [List the work items](https://docs.citino.ai/api-reference/work-items/list-the-work-items.md): The fixes queued for the project, highest estimated impact first. counts is the whole queue, not the page.
- [The Citino MCP server](https://docs.citino.ai/mcp/overview.md): Ask about your workspace in plain language from Claude, ChatGPT, Claude Code or Cursor. Read-only: numbers, names and dates.
- [Connect Claude](https://docs.citino.ai/mcp/claude.md): Add Citino to claude.ai or Claude Desktop as a custom connector and sign in. No API key needed.
- [Connect ChatGPT](https://docs.citino.ai/mcp/chatgpt.md): Add Citino to ChatGPT as a custom connector and sign in. No API key needed.
- [Claude Code](https://docs.citino.ai/mcp/claude-code.md): Add Citino to Claude Code with one command, then sign in, or use an API key on a machine nobody signs in on.
- [Cursor](https://docs.citino.ai/mcp/cursor.md): Connect Cursor to Citino's MCP server with an API key in your global Cursor configuration.
- [Tools](https://docs.citino.ai/mcp/tools.md): Every tool the Citino MCP server offers, the scope it needs, and the REST route it mirrors.
- [How data is handled](https://docs.citino.ai/mcp/data-handling.md): The MCP server only reads, returns numbers, names and dates, and never passes an engine's answer text to your assistant.
- [Changelog](https://docs.citino.ai/api/changelog.md): What the API and the MCP server gained, and when. Inside v1 every change adds; nothing is removed or renamed.

## OpenAPI Specs

- [openapi](/api-reference/openapi.json)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.