Artists


Available Methods

Artists can be retrieved via search or by supplying a direct URL to a single artist. Artists are read-only and only support GET requests.


Searching Artists

Artists can be searched using the URI

http://api.guitarparty.com/v2/artists/

When making the request, a single parameter named query must be supplied for the search to have any effect. If this parameter is not present the server will return a 400 Bad Request status.

Example:

curl -H 'Guitarparty-Api-Key: {API_KEY}' \
    http://api.guitarparty.com/v2/artists/?query=Dolly+Parton

{
    "objects": [
        {
            "bio": "Dolly Rebecca Parton (born January 19, 1946) ...", 
            "name": "Dolly Parton", 
            "slug": "dolly-parton", 
            "uri": "/v2/artists/1/"
        }
    ],
    "objects_count": 1
}

Single Artist

Various parts of the API return artists or references to artists. These references generally include a uri attribute which allows you to retrieve more information about the artist. To retrieve a single artist, simply use this uri parameter as your URL via a GET request.

Note: The uri parameter is always relative to the API host (i.e. http://api.guitarparty.com)

Example:

curl -H 'Guitarparty-Api-Key: {API_KEY}' \
    http://api.guitarparty.com/v2/artists/1/

{
    "bio": "Dolly Rebecca Parton (born January 19, 1946) ...", 
    "name": "Dolly Parton", 
    "slug": "dolly-parton", 
    "uri": "/v2/artists/1/"
}