# MentionBird.ai Visibility & LLM Tracker API > Track how a brand shows up in AI assistant answers. Read visibility metrics, share of voice, the domains AI platforms cite, per-prompt gaps, ranking advice and YouTube summaries — and add brands or prompts to track. Authentication is a bearer token on every request. Create a key in your MentionBird.ai workspace settings. ## Guides - [Quickstart](https://docs.mentionbird.ai/quickstart/): Go from an API key to your brand's visibility score in three calls. - [Authentication](https://docs.mentionbird.ai/authentication/): How to create a MentionBird.ai API key and send it on every request. - [Errors](https://docs.mentionbird.ai/errors/): The JSON error envelope, what each status code means, and when to retry. ## Discovery Find the brands, prompts, tags and AI platforms this workspace tracks. Start here — most other endpoints take a brand name or prompt ID returned by these. - [List Tracked Brands](https://docs.mentionbird.ai/reference/listTrackedBrands/): GET /brands/tracked — List every brand this workspace tracks. Call this first — other endpoints take the brand name exactly as returned here. - [List Tracked Prompts](https://docs.mentionbird.ai/reference/listQueries/): GET /queries — List the prompts tracked for a brand, with their search-volume and difficulty buckets and the prompt ID token other endpoints need. - [List Prompt Tags](https://docs.mentionbird.ai/reference/listQueryTags/): GET /queries/tags — List the tags this workspace has assigned to a brand's prompts. Pass a tag's slug as `query_tag` on other endpoints. - [List AI Platforms](https://docs.mentionbird.ai/reference/listLLMProviders/): GET /llm-providers — List the AI platforms available to this workspace (ChatGPT, Claude, Gemini, Perplexity, Grok) and the models behind them. ## Visibility How often the brand appears in AI answers, and who it shares those answers with. - [Get Brand Visibility](https://docs.mentionbird.ai/reference/getVisibility/): GET /visibility — How often the brand appears in AI answers, plus prominence score, average rank and sentiment. Group overall, by day, by platform or by tag. - [Get Share of Voice](https://docs.mentionbird.ai/reference/getTopMentionedBrands/): GET /brands/top-mentioned — The brands named most often across this brand's tracked prompts — who you are losing to, and by how much. ## Citations The pages and domains AI platforms cite when they answer, and how much of that is your own. - [Get Top Cited Domains](https://docs.mentionbird.ai/reference/getTopCitationDomains/): GET /citations/domains — The domains AI platforms cite most when answering this brand's prompts. - [List Citations](https://docs.mentionbird.ai/reference/listCitations/): GET /citations — Individual cited URLs with page metadata, for detailed source analysis. - [List Citation Taxonomy](https://docs.mentionbird.ai/reference/listCitationTags/): GET /citations/tags — The valid source_type and content_type values to pass to the citation endpoints. source_type describes the kind of site, content_type the kind of page. - [Get Owned vs Earned Share](https://docs.mentionbird.ai/reference/getOwnedSourceShare/): GET /sources/owned-share — How citations split between domains the brand owns, competitor-owned domains and earned third-party coverage. ## Searches The web searches the AI platforms actually ran while answering a prompt. - [Get Top Web Searches](https://docs.mentionbird.ai/reference/getTopWebSearches/): GET /searches — The searches AI models ran before answering this brand's prompts - the terms to rank for, as opposed to the pages already cited. ## Prompts Per-prompt standings and the advice agent's guidance on improving them. - [Get Prompt Leaderboard](https://docs.mentionbird.ai/reference/getPromptBrandLeaderboard/): GET /prompts/leaderboard — For ONE prompt: headline metrics plus every brand named on it, ranked. Requires brand_prompt_id from listQueries. - [List Prompts by Visibility](https://docs.mentionbird.ai/reference/listPromptsByVisibility/): GET /prompts/by-visibility — Prompts ordered by visibility: ascending finds the gaps where the brand loses, descending finds the wins. - [Get Ranking Advice for a Prompt](https://docs.mentionbird.ai/reference/getRankingAdvice/): GET /prompts/ranking-advice — Completed ranking-advice runs for ONE prompt — what to change to rank better. Read-only: this never starts a new run. Requires brand_prompt_id from listQueries. - [List Ranking Advice Runs](https://docs.mentionbird.ai/reference/listRankingAdvice/): GET /ranking-advice — Ranking-advice runs across ALL of a brand's prompts. Use this to find which prompts already have advice before calling getRankingAdvice. ## Answers The raw AI answers behind every metric, in full. - [List Sample AI Answers](https://docs.mentionbird.ai/reference/listQueryRuns/): GET /query-runs — Recent AI answers for the brand's prompts, each with a short preview of the answer. To read one answer in full, take its run_id from this list and call getQueryRun. - [Get One AI Answer in Full](https://docs.mentionbird.ai/reference/getQueryRun/): GET /query-runs/{run_id} — One run in full: the complete answer text, every brand mentioned, every source cited and every web search the AI ran. Use this after listQueryRuns when the preview isn't enough. ## Video Summaries of cited YouTube videos the brand has paid to analyze. - [List YouTube Summaries](https://docs.mentionbird.ai/reference/listYouTubeSummaries/): GET /youtube/summaries — Cited YouTube videos this brand has already paid to summarize. - [Get YouTube Summary](https://docs.mentionbird.ai/reference/getYouTubeSummary/): GET /youtube/summary — Summary, key points and optional transcript for one cited YouTube URL. ## Writes Add brands and prompts to track. These need a write-enabled API key. - [Add Tracked Brand](https://docs.mentionbird.ai/reference/addTrackedBrand/): POST /brands/tracked — Start tracking a new brand. Requires a write-enabled API key. - [Add Prompts to Track](https://docs.mentionbird.ai/reference/addPrompts/): POST /prompts — Add prompts to track for a brand across the chosen AI platforms and queue the first crawl. Requires a write-enabled API key. ## Full text - [Every endpoint in one file](https://docs.mentionbird.ai/llms-full.txt)