Overview
Narrative Sports is an AI-powered platform that automatically detects and extracts highlights from sports video content. Whether you’re processing recorded game footage or live streams, our API identifies key moments and generates broadcast-ready clips.Supported Sports
- Soccer — goals, penalties, cards, VAR reviews, and more. See Soccer event types.
- MMA — knockouts, TKOs, submissions, decisions, significant strikes, takedowns, walkouts, and full multi-fight card support with per-fight round tracking.
- Baseball — hits, outs, strikeouts, defense, and game-ending moments.
- American football — every live play plus scores, turnovers, fourth downs, and game-changing moments.
- Squash — match/game balls, rallies, winners, retrievals, comebacks, and referee decisions.
Key Features
- Automatic Highlight Detection - AI identifies goals, saves, penalties, KOs, submissions, and other key moments
- Live Stream Processing - Real-time analysis from an SRT listener or an HLS pull source
- Multi-Fight Card Support - For MMA, automatically delineate a full event’s fights and tag every highlight with
fight_number,round_number, andfight_name - Flexible Output - Get rendered video clips and OTIO timelines with portrait crop effects
- Multiple Aspect Ratios - Generate landscape (16:9) and portrait (9:16) clips simultaneously, plus an optional 1:1 square variant for MMA
How It Works
Use Cases
Base URL
All API requests should be made to:Getting Started
Quickstart
Stream a video and see rendered highlights in the dashboard — the fastest way to try Narrative Sports
API Reference
Explore the full API documentation
Authentication
Learn how to authenticate requests
Need Help?
- Email us at [email protected]
- Check out the API Reference for detailed endpoint documentation