# BotSee

> BotSee is an AI visibility and GEO tracking REST API built for agents. It measures brand mentions, brand citations, cited sources, and competitor share of voice across ChatGPT, Claude, Perplexity, Gemini, and Grok, and returns structured JSON that agents and scripts can act on.

BotSee is the programmatic interface to the RivalSee AI search visibility platform (https://www.rivalsee.com). A caller creates a site, generates or supplies customer types, personas, and questions, then runs an analysis. Each analysis returns raw model responses, cited sources, competitor mentions, keyword gaps, source opportunities, and recommendations. Webhooks fire on `analysis.completed`, `analysis.failed`, `visibility.changed`, and `citation.loss`, so agents can react to shifts without polling.

Base URL: `https://botsee.io/api/v1`. Authentication is a bearer token: `Authorization: Bearer bts_live_...`; `x-api-key` and an `api_key` query parameter are also accepted. Rate limit is 600 requests per minute per key, reported via `x-ratelimit-limit`, `x-ratelimit-remaining`, and `x-ratelimit-reset` headers. Billing is pay-per-run, roughly $0.45 to $1.20 per analysis, with credit-card, USDC, and x402 signup paths and optional auto-recharge.

BotSee is used from coding and research agents such as Claude Code, Codex, OpenClaw, and Hermes, and from any HTTP client. It also works as an MCP connector in ChatGPT, Claude, and other MCP clients at `https://botsee.io/mcp`, with OAuth sign-in and no API key to copy. It is listed in the official MCP Registry as `io.botsee/botsee`. It does not crawl competitor websites or perform traditional SEO audits.

## API documentation

- [API documentation](https://botsee.io/docs): Full endpoint reference covering authentication, sites, customer types, personas, questions, analysis, content generation, usage, billing, and webhooks
- [OpenAPI specification](https://botsee.io/docs/openapi.json): Machine-readable spec for the full REST API
- [Agent skill definition](https://botsee.io/docs/skill.md): Installable skill that lets a coding agent drive BotSee in plain English
- [Agent auth manifest](https://botsee.io/auth.md): How an agent signs up, obtains a key, and pays, per the auth.md spec
- [OAuth protected resource metadata](https://botsee.io/.well-known/oauth-protected-resource)
- [OAuth authorization server metadata](https://botsee.io/.well-known/oauth-authorization-server)
- [Official MCP Registry listing](https://registry.modelcontextprotocol.io/?q=botsee): The published `io.botsee/botsee` entry for the hosted MCP server, verified against this domain

## API reference sections

All reference sections live on the single `/docs` page and are addressable by anchor.

- [Quick start with the Claude Code plugin](https://botsee.io/docs#skill): Install BotSee and run an analysis without writing HTTP calls
- [Plugin commands](https://botsee.io/docs#skill-commands): Every plain-English command the plugin accepts
- [AI visibility audit](https://botsee.io/docs#ai-visibility-audit): The end-to-end audit workflow
- [MCP connector](https://botsee.io/docs#mcp): Connect BotSee to ChatGPT, Claude, or any MCP client and run audits in chat
- [Getting started with the REST API](https://botsee.io/docs#getting-started): First request, base URL, and response shape
- [Authentication](https://botsee.io/docs#authentication): Bearer tokens, key validation, and account lookup
- [Signup](https://botsee.io/docs#signup): Credit-card, USDC, and x402 signup flows plus status polling
- [USDC top-ups](https://botsee.io/docs#usdc-payments): Adding credits over x402
- [Sites](https://botsee.io/docs#sites): Create, list, fetch, and archive the domains being tracked
- [Customer types](https://botsee.io/docs#customer-types): Define or generate the market segments to test
- [Personas](https://botsee.io/docs#personas): Define or generate the buyers within each segment
- [Questions](https://botsee.io/docs#questions): Define or generate the queries sent to AI models
- [Analysis](https://botsee.io/docs#analysis): Run an analysis and read responses, sources, competitors, keyword opportunities, source opportunities, and recommendations
- [Content generation](https://botsee.io/docs#content): Draft a blog post from an analysis
- [Usage and credits](https://botsee.io/docs#usage): Consumption by key, by site, and by line item
- [Webhooks](https://botsee.io/docs#webhooks): Subscribe to analysis.completed, analysis.failed, visibility.changed, and citation.loss
- [Rate limits](https://botsee.io/docs#rate-limits): Current budget and reset window
- [API keys](https://botsee.io/docs#api-keys): Create, rotate, revoke, and reset keys
- [Pricing](https://botsee.io/docs#pricing): Per-run cost and credit model
- [Billing settings](https://botsee.io/docs#billing-settings): Auto-recharge thresholds and payment configuration
- [Error handling](https://botsee.io/docs#errors): Error codes and retry guidance

## Product

- [BotSee home](https://botsee.io/): What BotSee measures, which models it covers, and how pay-per-run pricing works
- [Recipes](https://botsee.io/recipes): Step-by-step workflows for quick start, blog content generation, persona and ICP generation, competitor discovery, and a full AI visibility audit
- [Get started](https://botsee.io/get-started): Sign up and provision an API key
- [Blog](https://botsee.io/blog/): Guides on AI visibility measurement and agent workflows
- [RivalSee dashboard](https://www.rivalsee.com/): The hosted dashboard product built on the same analysis engine

## Guides

- [Complete guide to AI visibility monitoring](https://botsee.io/blog/complete-guide-to-ai-visibility-monitoring/): What AI visibility monitoring measures and how to set it up
- [Programmatic AI visibility workflows for agents](https://botsee.io/blog/programmatic-ai-visibility-workflows-for-agents/): Designing agent workflows around the BotSee API
- [Use BotSee with Claude Code, Codex, OpenClaw, and Hermes](https://botsee.io/blog/use-botsee-with-claude-code-codex-openclaw-and-hermes/): Wiring BotSee into coding agents
- [Run an AI visibility audit with an agent](https://botsee.io/blog/ai-visibility-audit-with-an-agent/): End-to-end audit driven by an agent
- [Build a BotSee query library](https://botsee.io/blog/how-to-build-a-botsee-query-library-that-drives-better-ai-visibility-data/): Choosing the questions that produce useful visibility data
- [Track whether ChatGPT cites your website](https://botsee.io/blog/how-to-track-if-chatgpt-cites-your-website/): Detecting citations of your domain in AI answers
- [How to get cited by AI assistants](https://botsee.io/blog/how-to-get-cited-by-ai-assistants/): Content and source strategies for earning citations
- [Why your brand is not showing in ChatGPT](https://botsee.io/blog/why-brand-not-showing-chatgpt/): Common causes of low AI visibility and how to diagnose them
- [Track AI visibility by country and language](https://botsee.io/blog/how-to-track-ai-visibility-by-country-and-language/): Running localized analyses
- [Weekly AI visibility report for leadership](https://botsee.io/blog/how-to-run-a-weekly-botsee-ai-visibility-report-that-leadership-will-actually-read/): Turning analysis output into a recurring report
- [How AI visibility differs from traditional SEO reporting](https://botsee.io/blog/how-ai-visibility-differs-from-traditional-seo-reporting/): Why AI answer metrics need different reporting
- [Agency AI visibility reporting](https://botsee.io/blog/agency-ai-visibility-reporting/): Reporting AI visibility to clients at scale

## Optional

- [LLM monitoring tools](https://botsee.io/blog/llm-monitoring-tool/): Landscape of tools that monitor LLM answers
- [BotSee vs Profound](https://botsee.io/blog/botsee-vs-profound/)
- [BotSee vs Semrush AI visibility](https://botsee.io/blog/botsee-vs-semrush-ai-visibility/)
- [Privacy policy](https://botsee.io/privacy)
- [Sitemap](https://botsee.io/sitemap.xml)