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