# Reel25 API

> Reel25 is a video analytics platform for tracking, analyzing, and discovering short-form video content across TikTok, Instagram, and YouTube.

## Base URL

https://api.reel25.com/api/v1

## Authentication

All endpoints require a Bearer API key in the Authorization header:
Authorization: Bearer reel25_sk_...

Get your API key at: https://app.reel25.com/settings/api-keys

## Rate Limits

60 requests per minute per API key.

## Endpoints

### Videos
- GET /api/v1/videos — List tracked videos (paginated, filterable by date/platform)
- GET /api/v1/videos/{id} — Get video details
- GET /api/v1/videos/{id}/history — Get video performance snapshots over time
- POST /api/v1/videos — Track a video by URL (TikTok, Instagram, YouTube)
- DELETE /api/v1/videos/{id} — Untrack a video
- POST /api/v1/videos/bulk-track — Track up to 25 videos at once (body: { urls: string[] })
- POST /api/v1/videos/bulk-untrack — Untrack up to 50 videos at once (body: { ids: string[] })

### Accounts
- GET /api/v1/accounts — List tracked creator accounts
- GET /api/v1/accounts/{id} — Get account details
- POST /api/v1/accounts — Track account by URL (body: { url: string, video_limit?: number })
- GET /api/v1/accounts/{id}/videos — List videos for a specific account
- GET /api/v1/accounts/{id}/metrics — Get detailed account metrics (views, likes, engagement)
- PATCH /api/v1/accounts/{id} — Update account settings (body: { video_limit?: number })
- DELETE /api/v1/accounts/{id} — Remove account from tracking

### Folders
- GET /api/v1/folders — List all folders
- POST /api/v1/folders — Create folder (body: { name: string })
- GET /api/v1/folders/{id} — Get folder details
- PATCH /api/v1/folders/{id} — Update folder (body: { name?: string })
- DELETE /api/v1/folders/{id} — Delete folder
- GET /api/v1/folders/{id}/videos — List videos in folder (sortable, filterable)
- POST /api/v1/folders/{id}/videos — Add videos to folder (body: { video_ids: string[] })
- DELETE /api/v1/folders/{id}/videos — Remove videos from folder (body: { video_ids: string[] })
- GET /api/v1/folders/{id}/accounts — List accounts in folder
- POST /api/v1/folders/{id}/accounts — Add accounts to folder (body: { account_ids: string[] })
- DELETE /api/v1/folders/{id}/accounts — Remove accounts from folder (body: { account_ids: string[] })
- GET /api/v1/folders/{id}/analytics — Get folder-level analytics

### Analytics
- GET /api/v1/analytics/videos/top — Get top performing videos (query: limit)
- GET /api/v1/analytics/growth — Get growth trends (query: period=7d|30d|90d|all)
- GET /api/v1/analytics/accounts/{id}/performance — Get account performance (query: period=7d|30d|90d)

### Content Radar
- POST /api/v1/radar/search — Create AI-powered content search (costs 100 credits, body: { query: string, platform?: string, depth?: string, minViews?: string, timeframe?: string, language?: string })
- GET /api/v1/radar/search/{id} — Get search results
- GET /api/v1/radar/history — Get search history
- GET /api/v1/radar/recurring — List recurring searches
- PATCH /api/v1/radar/recurring/{id} — Update recurring search
- DELETE /api/v1/radar/recurring/{id} — Delete recurring search

### Video Analysis
- GET /api/v1/video-analysis/{videoId} — Get AI analysis (hooks, virality, CTA, UGC, transcript)
- POST /api/v1/video-analysis/{videoId}/analyze — Trigger AI analysis (costs 5 credits)

### Credits
- GET /api/v1/credits — Get workspace credit balance

### Workspace
- GET /api/v1/workspace — Get workspace info (plan, credits, limits)

## Credit Costs

- Track video/account: Free
- Radar search: 100 credits
- Video analysis: 5 credits

## MCP Server

Install: npx -y reel25-mcp
26 tools available for AI agents (Claude, Cursor, VS Code).
Setup: set REEL25_API_KEY env variable, add to your AI client config.
npm: https://www.npmjs.com/package/reel25-mcp

## Supported Platforms

- TikTok: tiktok.com/@user/video/123
- Instagram: instagram.com/reel/ABC123/
- YouTube: youtube.com/watch?v=ID, youtu.be/ID, youtube.com/shorts/ID

## Documentation

Full API documentation: https://reel25.com/docs