REST API reference

The Statshawk REST API is normalized across NBA, MLB, NFL, NHL, KBO, NCAA, and major soccer competitions. One key, source-agnostic ids, and one shape per concept: persons, teams, competitions, editions, contests, analysis, and assets.

Conventions

• Base URL: https://api.statshawk.ai
• Auth: X-API-Key: sk_live_... header — see Authentication
• Response envelope: every endpoint returns { "data": ..., "meta": { request_id, fetched_at, cache, version } }
• Errors: { "error": { "code": "...", "message": "..." } } — see Errors
• Quotas: unit-based, not per-second — see Quotas

Try it from the docs

Every endpoint page has a built-in playground. Sign in and your key prefix surfaces in a banner above the playground; paste the full key once and run requests directly from the docs.

Browse by tag

Use the sidebar to navigate by tag (Persons, Teams, Competitions, Contests, Analysis, Assets). Each tag groups the endpoints that share a resource shape.