# API introduction

> REST conventions for ReelsRadar. Machine-readable schema at /openapi.json.

# API introduction

Base URL: `https://reelsradar.io/api`

OpenAPI 3.1 schema: [https://reelsradar.io/openapi.json](https://reelsradar.io/openapi.json)

## Conventions

- JSON request and response bodies
- Session cookie auth for dashboard routes (same origin)
- Public routes: signup, lead capture, founding stats
- Machine routes: Stripe webhook, Apify webhook, cron (secret bearer)

## Capability groups

- **track** — paste URLs, start scrapes
- **videos** — list / filter tracked videos
- **accounts** — list / update / analytics
- **collections** — group items
- **overview** — KPI aggregates
- **export** — CSV download
- **billing** — Stripe checkout / portal
- **alerts** — viral threshold rules

## Agent surfaces

- [llms.txt](https://reelsradar.io/llms.txt) — compact agent index
- [llms-full.txt](https://reelsradar.io/llms-full.txt) — expanded docs
- [MCP introduction](https://reelsradar.io/docs/mcp-introduction)
- [CLI introduction](https://reelsradar.io/docs/cli-introduction)