Music Recommendations for Videos and Reels

Updated:Jun 15, 2023

Get music recommendations for your videos and reels you post to Facebook and Instagram. Learn what music is performing well on Meta’s apps.

Before You Start

You will need:

A Page or User access token

Your app must have the following permissions:

pages_read_engagement

Limitations

Business Facebook Pages may see limited results returned

Music Recommendations

Music Popular on Facebook

To get a list of popular songs on Meta’s apps, send a GET request to the /audio/recommendations endpoint with the type parameter set to FACEBOOK_POPULAR_MUSIC .

Example Request

Formatted for readability.

 curl -i -X GET "https://graph.facebook.com/  v25.0 
 
/audio/recommendations
    ?type=FACEBOOK_POPULAR_MUSIC
    &access_token=ACCESS_TOKEN"

New Music on Facebook

To get a list of recent additions to Meta’s music library, send a GET request to the /audio/recommendations endpoint with the type parameter set to FACEBOOK_NEW_MUSIC .

Example Request

Formatted for readability.

 curl -i -X GET "https://graph.facebook.com/  v25.0 
 
/audio/recommendations
    ?type=FACEBOOK_NEW_MUSIC
    &access_token=ACCESS_TOKEN"

Music for You

To get personalized music recommendations for you, send a GET request to the /audio/recommendations endpoint with the type parameter set to FACEBOOK_FOR_YOU .

Example Request

Formatted for readability.

 curl -i -X GET "https://graph.facebook.com/  v25.0 
 
/audio/recommendations
    ?type=FACEBOOK_FOR_YOU
    &access_token=ACCESS_TOKEN"

You can also get popular music for a specific country or countries by adding the available_countries parameter with a comma separated list of two letter Alpha-2 ISO Country Code abbreviations.

Example API Response

On success, your app receives a JSON response with a list of objects that contain the title of a song, the artist, and a link to the album artwork that has been uploaded to Facebook.

  {
  "data": [
    {
      "title": "Song Title A",
      "artist": "Artist Name A",
      "display_image_uri": "urlToAlbumArtA.com"
    },
    {
      "title": "Song Title B",
      "artist": "Artist Name B",
      "display_image_uri": "urlToAlbumArtB.com"
    },
    {
      "title": "Song Title C",
      "artist": "Artist Name C",
      "display_image_uri": "urlToAlbumArtC.com"
    }
  ]
}

Error Codes

Code – Subcode	Description
100 – 4138001	Invalid country code, country code must be a valid alpha-2 ISO country code