# Spotlight Docs

## Docs

- [List brands](https://docs.get-spotlight.com/api-reference/brands/list.md): Return all brands that belong to your organization.
- [Get latest content suggestions](https://docs.get-spotlight.com/api-reference/content-suggestions/get-latest-suggestions.md): Return content suggestions from the most recent run of a brand.
- [Get content suggestions](https://docs.get-spotlight.com/api-reference/content-suggestions/get-run-suggestions.md): Return AI-generated content ideas for a specific run.
- [Discovery](https://docs.get-spotlight.com/api-reference/discovery.md): Verify connectivity and enumerate available endpoints.
- [Get brand perception](https://docs.get-spotlight.com/api-reference/perception/get-brand-perception.md): Return perception prompts and scored responses for a brand.
- [Get perception prompts & responses (brand)](https://docs.get-spotlight.com/api-reference/perception/get-brand-perception-prompts-responses.md): Return all perception prompts and their scored responses for a brand, optionally scoped to a run.
- [Get latest perception](https://docs.get-spotlight.com/api-reference/perception/get-latest-perception.md): Return perception data from the most recent run of a brand.
- [Get latest perception sources](https://docs.get-spotlight.com/api-reference/perception/get-latest-perception-sources.md): Return perception sources from the most recent run of a brand.
- [Get run perception](https://docs.get-spotlight.com/api-reference/perception/get-run-perception.md): Return perception data for a specific run.
- [Get perception prompts & responses (run)](https://docs.get-spotlight.com/api-reference/perception/get-run-perception-prompts-responses.md): Return all perception prompts and their scored LLM responses for a specific run.
- [Get perception sources](https://docs.get-spotlight.com/api-reference/perception/get-run-perception-sources.md): Return URLs cited in perception responses for a specific run, grouped by domain.
- [Get latest results](https://docs.get-spotlight.com/api-reference/results/get-latest-results.md): Return per-prompt results for the most recent run of a brand.
- [Get run results](https://docs.get-spotlight.com/api-reference/results/get-run-results.md): Return per-prompt analysis results for a specific run.
- [List runs](https://docs.get-spotlight.com/api-reference/runs/list.md): List analysis runs for a brand with aggregate metrics.
- [Get run stats](https://docs.get-spotlight.com/api-reference/runs/stats.md): Return aggregate statistics for a specific run.
- [Get latest sources](https://docs.get-spotlight.com/api-reference/sources/get-latest-sources.md): Return sources from the most recent run of a brand.
- [Get run sources](https://docs.get-spotlight.com/api-reference/sources/get-run-sources.md): Return the URLs that LLMs cited during a specific run, grouped by domain.
- [Batch create topics & prompts](https://docs.get-spotlight.com/api-reference/topics-prompts/batch-create.md): Create multiple topics and prompts in a single request.
- [Create perception prompts](https://docs.get-spotlight.com/api-reference/topics-prompts/create-perception-prompts.md): Add perception prompts to a brand.
- [Create prompts](https://docs.get-spotlight.com/api-reference/topics-prompts/create-prompts.md): Add prompts to an existing topic.
- [Create topics](https://docs.get-spotlight.com/api-reference/topics-prompts/create-topics.md): Create one or more topics for a brand.
- [Delete prompt](https://docs.get-spotlight.com/api-reference/topics-prompts/delete-prompt.md): Delete a single prompt.
- [Delete topic](https://docs.get-spotlight.com/api-reference/topics-prompts/delete-topic.md): Delete a topic and all prompts inside it.
- [Authentication](https://docs.get-spotlight.com/authentication.md): How to authenticate with the Spotlight API.
- [Errors](https://docs.get-spotlight.com/errors.md): HTTP status codes and error response shapes.
- [Introduction](https://docs.get-spotlight.com/introduction.md): Pull Spotlight data into your own dashboards, scripts, and automations.
- [MCP best practices](https://docs.get-spotlight.com/mcp/best-practices.md): Recommended workflows for AI agents using Spotlight MCP.
- [Connect an MCP client](https://docs.get-spotlight.com/mcp/connect.md): Set up Cursor, Claude Desktop, and other MCP clients to talk to Spotlight.
- [MCP overview](https://docs.get-spotlight.com/mcp/index.md): Connect AI assistants to your Spotlight organization via the Model Context Protocol.
- [MCP tools reference](https://docs.get-spotlight.com/mcp/tools.md): Complete list of Spotlight MCP tools and their REST equivalents.
- [Step 2: Configure your competitors](https://docs.get-spotlight.com/onboarding/competitors.md): Clean up who you're measured against in the Spotlight dashboard
- [Step 3: Connect your content](https://docs.get-spotlight.com/onboarding/content.md): Import your existing content so Spotlight can track what's being cited by AI models
- [Step 4: Create your first article](https://docs.get-spotlight.com/onboarding/generate.md): Generate a GEO-optimised article and publish it to start getting cited
- [Getting started with Spotlight](https://docs.get-spotlight.com/onboarding/index.md): Set up your account and start tracking your AI presence in 4 steps
- [Step 1: Set up your prompts](https://docs.get-spotlight.com/onboarding/prompts.md): Review, clean, and configure the prompts Spotlight tracks every week
- [Pagination](https://docs.get-spotlight.com/pagination.md): How paging works across list endpoints.
- [Quickstart](https://docs.get-spotlight.com/quickstart.md): Make your first Spotlight API call in under 2 minutes.

## OpenAPI Specs

- [openapi](https://docs.get-spotlight.com/api-reference/openapi.json)