Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.get-spotlight.com/llms.txt

Use this file to discover all available pages before exploring further.

What is the Spotlight API?

The Spotlight API gives you programmatic access to the same brand intelligence data that powers the Spotlight app. Use it to integrate AI-visibility metrics, analysis runs, content suggestions, and perception scores into your own tooling.

Quickstart

Make your first API call in under 2 minutes.

Authentication

Learn how to authenticate with API keys.

API Reference

Full reference for all endpoints.

MCP

Connect AI assistants via the Model Context Protocol.

Pagination

Understand paging and limits.

Base URL

Every request starts with your organization’s API base URL, found in Settings → API inside the app:
https://app.get-spotlight.com/api

What you can do

CategoryWhat you get
BrandsList all brands tracked in your organization
RunsBrowse the history of analysis runs with aggregate metrics
ResultsPer-prompt presence, sentiment, rank, and (optionally) raw LLM responses
Content suggestionsAI-generated content ideas derived from each run
SourcesDomains and URLs that LLMs cited when analyzing your brand
PerceptionScored perception properties (trust, clarity, etc.) with LLM explanations
Topics & promptsAdd, organize, and delete the prompts that drive your analysis