# Free Music API

> Real music, cleared for code. A free REST API for searching, streaming, and downloading royalty-free music. Built for developers building apps, games, videos, and AI projects.

## Quick Start

Base URL: https://api.freemusicapi.com
Auth: Bearer token via `Authorization: Bearer YOUR_API_KEY`
Get a free key: https://freemusicapi.com/signup
Format: JSON

## Links

- [Documentation](https://freemusicapi.com/docs)
- [API Reference](https://freemusicapi.com/docs/reference)
- [OpenAPI 3.1 Spec](https://api.freemusicapi.com/v1/openapi.json)
- [Get API Key](https://freemusicapi.com/signup)
- [License & Usage Terms](https://freemusicapi.com/license)
- [Integrations & Code Examples](https://freemusicapi.com/docs/integrations)
- [Full LLM Reference](https://api.freemusicapi.com/llms-full.txt)

## Key Endpoints

- GET /v1/tracks — Search and browse tracks (supports q, genre, mood, bpm, energy, key, tags, instruments, vocal, sort, limit, offset)
- GET /v1/tracks/{id} — Get full track metadata
- GET /v1/tracks/{id}/similar — Find similar tracks (scored by genre, mood, BPM, energy)
- GET /v1/tracks/{id}/my-stats — Get your play/download/API call counts for a track
- POST /v1/tracks/{id}/stream — Get a streaming URL (returns time-limited signed URL)
- POST /v1/tracks/{id}/download — Get a download URL (MP3 or WAV)
- GET /v1/tracks/{id}/beats — Get beat positions, sections, BPM, and bar structure (for Remotion, visualizers, music-reactive apps; supports ?fps=30)
- GET /v1/genres — List all genres
- GET /v1/moods — List all moods
- GET /v1/tags — List all tags
- GET /v1/instruments — List all instruments
- GET /v1/keys — List all musical keys
- GET /v1/labels — List all labels
- GET /v1/playlists — List curated playlists
- GET /v1/playlists/{id} — Get playlist with tracks
- POST /v1/plays — Report a play event
- GET /v1/me/usage — Check API usage and limits

## Example

```bash
# Search for chill lo-fi tracks
curl -H "Authorization: Bearer YOUR_API_KEY" \
  "https://api.freemusicapi.com/v1/tracks?genre=Lo-Fi&mood=Chill&limit=5"
```

## Rate Limits

- Free tier: 100 requests/hour, 500 plays/month
- Pro tier: 1,000 requests/hour, 10,000 plays/month
- Business tier: 10,000 requests/hour, unlimited plays

## License

All music is royalty-free. Free tier for personal/non-commercial use. Pro/Business for commercial use. Attribution required on free tier. No AI model training permitted.