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"
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://docs.freepik.com/llms.txt

Use this file to discover all available pages before exploring further.

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