What you can do
- Search music with full-text queries across titles and tags
- Filter by genre, mood, premium status, and creation date
- Sort results by relevance, popularity, creation date, duration, or tempo
- Get detailed music metadata including artist biography, download stats, and playlist count
- Download music audio files via CDN-hosted URLs
Authentication
All requests require an API key via thex-freepik-api-key header. See the Quickstart and Authentication.
Endpoints
Parameters overview
The search endpoint supports the following filters:| Parameter | Type | Description |
|---|---|---|
q | string | Full-text search across titles and tags |
genre | string | Filter by genre name, comma-separated (e.g., "Electronic,Ambient") |
mood | string | Filter by mood tag, comma-separated (e.g., "Happy,Energetic") |
include-premium | boolean | Include premium content (default: false) |
time_range | string | Filter by creation date: "7d", "30d", or "90d" |
order_by | string | Sort order: "relevance", "popularity", "-popularity", "created_at", "-created_at", "title", "-title", "seconds", "-seconds", "bpm", "-bpm". Defaults to "relevance" when q is provided, "-popularity" otherwise |
limit | integer | Results per page: 1-1000 (default: 10) |
offset | integer | Pagination offset (default: 0) |
Use cases
- Build a music browser or audio picker into your app or CMS
- Search music by genre and mood for video or podcast background music
- Programmatically download royalty-free music during content production pipelines
- Create curated playlists filtered by popularity, tempo, or release date
FAQ
Is there a rate limit?
Yes. See Rate limits.What license applies to the music?
Refer to the License agreement.What audio format is the music available in?
Music is delivered as audio files via CDN-hosted download URLs.Can I filter for only free music?
Yes. Setinclude-premium to false (the default) to return only free music.