Music Recommendations for Videos and Reels

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

curl -i -X GET "https://graph.facebook.com/   v19.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

curl -i -X GET "https://graph.facebook.com/   v19.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

curl -i -X GET "https://graph.facebook.com/   v19.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