Skip to main content
GET
/
v1
/
music
Search and filter music
curl --request GET \
  --url https://api.freepik.com/v1/music \
  --header 'x-freepik-api-key: <api-key>'
{ "count": 150, "results": [ { "favorites": 350, "file_url": "file_url", "cover_url": "cover_url", "is_active": true, "artist": { "name": "John Doe" }, "moods": [ { "name": "Happy" }, { "name": "Energetic" } ], "created_at": "2000-01-23T04:56:07.000Z", "in_playlists": 15, "title": "Summer Vibes", "seconds": 225, "is_premium": true, "downloads": 1200, "genres": [ { "name": "Electronic" }, { "name": "Ambient" } ], "preview_url": "preview_url", "popularity": 85, "download_url": "download_url", "id": 1, "time": "3:45" }, { "favorites": 350, "file_url": "file_url", "cover_url": "cover_url", "is_active": true, "artist": { "name": "John Doe" }, "moods": [ { "name": "Happy" }, { "name": "Energetic" } ], "created_at": "2000-01-23T04:56:07.000Z", "in_playlists": 15, "title": "Summer Vibes", "seconds": 225, "is_premium": true, "downloads": 1200, "genres": [ { "name": "Electronic" }, { "name": "Ambient" } ], "preview_url": "preview_url", "popularity": 85, "download_url": "download_url", "id": 1, "time": "3:45" } ] }
Use the Freepik Music API to search and filter music by genre, mood, artist, and more. See the Music API overview for authentication and usage guidance.

Authorizations

​
x-freepik-api-key
string
header
required

Your Freepik API key. Required for authentication. Learn how to obtain an API key

Query Parameters

​
q
string

Full-text search query for music titles, artists, and tags

​
genre
enum<string>[]

Filter by genre. Comma-separated for multiple values

Available options:
Acoustic,
Afrobeat,
Ambient,
Blues,
Children,
Cinematic,
Classical,
Corporate,
Country,
Disco,
Electronic,
Funk,
Hip Hop,
Jazz,
Latin,
Lofi,
Lounge,
Pop,
Reggae,
RnB,
Rock,
Soul,
Synthwave,
World
​
mood
enum<string>[]

Filter by mood. Comma-separated for multiple values

Available options:
Dark,
Dramatic,
Elegant,
Energetic,
Epic,
Exciting,
Groovy,
Happy,
Hopeful,
Laid Back,
Melancholic,
Peaceful,
Playful,
Sad,
Sentimental,
Soulful,
Tension,
Upbeat
​
include-premium
boolean
default:false

Include premium music in search results. When false, only free music is returned

​
time_range
enum<string>

Filter by creation date, relative to current date

Available options:
7d,
30d,
90d
​
order_by
enum<string>

Sort order for results. Prefix with "-" for descending. Defaults to "relevance" when a search query (q) is provided, otherwise defaults to "-popularity".

Available options:
relevance,
popularity,
-popularity,
created_at,
-created_at,
title,
-title,
seconds,
-seconds,
bpm,
-bpm
​
limit
integer
default:10

Number of results to return per page

Required range: 1 <= x <= 1000
​
offset
integer
default:0

Number of results to skip for pagination

Required range: x >= 0

Response

OK

​
count
integer
required

Total number of results matching the query

Example:

150

​
results
object[]
required