MusicGraph API Documentation

Album API

API calls for getting data about albums.

The base URL path for album queries is: http://api.musicgraph.com/api/v2/album/

Album Endpoints

Resource URL Description
/search Return results based on search operations; described in more detail below
/suggest Return a list of albums based on a partial name passed
/{id} Return meta about an album
/{id}/tracks Return a list of an album's tracks
/{id}/artists Return a list of an album's artists/performers

Album Title and ID Lookup

The API provides auto-complete suggestions — or, “predictions” – for album titles. Auto-complete minimizes the number of false positives for album searches. You can search a list of suggested albums using a prefix; returning a list of potential album matches based upon a query string.

Parameter Required Description Example
api_key yes The developer API key api_key=c8303e90962e3a5ebd5a1f260a69b138
prefix yes Contains &prefix=hot
genre no Use to filter the suggest results. Values here &genre=rock
decade no Use to filter the suggest results. Values here &decade=2000s
limit no By default, the API will return 20 results. Use the limit query string parameter to return a custom number of results (max 100). &limit=20
offset no Use the offset query parameter to perform pagination on the results set. &offset=10

Example:

Album Search

You can perform simple to complex search operations using parameters and filters detailed below.

Parameter Required Description Example
api_key yes The developer API key api_key=c8303e90962e3a5ebd5a1f260a69b138
title no Return albums that match the name; exact, case insensitive &title=Houses+Of+The+Holy
artist_name no Find albums by the given artist; exact, case insensitive &artist_name=John+Lennon
similar_to no Find albums that are similar to another album &similar_to=Thriller
country
no Filter album search results by country &country=England
decade no Return albums that were released during a given decade; case insensitive. Values here &decade=1990s
genre no Return albums that are that are of the given genre; contains, case insensitive. Values here &genre=rock
limit no By default, the API will return 20 results. Use the limit query string parameter to return a custom number of results (max 100). &limit=20
offset no Use the offset query parameter to perform pagination on the results set. &offset=10

Additional Filters:

Apply these filters to narrow search results.

Parameter Required Description Example
top_rated no Return only top-rated albums; possible values are true and false search?similar_to=Thriller&top_rated=true

Examples:

You can search for albums by Adele.

You can search for top rated albums that are similar to Michael Jackson's Thriller.

You can search for jazz albums from the 2010s that are top rated.

Use the `limit` query string parameter to return a custom number of results (max 100).

Album Edges

Property Name Description
/{id} Returns the metadata of the album
/{id}/artists Returns the artist’s who performed on the album
/{id}/tracks Returns a list of the tracks on the album

Examples for the album Adele's album 21:

Property Name Example
Metadata /api/v2/album/8231d341-0065-d0a9-f62c-0d055ec6f3f2
Artists /api/v2/album/8231d341-0065-d0a9-f62c-0d055ec6f3f2/artists
Tracks /api/v2/album/8231d341-0065-d0a9-f62c-0d055ec6f3f2/tracks

Choosing Fields:

By default, all the fields are returned when you make a query. You can choose the fields you want returned with the "fields" query parameter. This is really useful for making your API calls more efficient and fast.

Try it out!