Artist Search API Follow

Overview

The Topspin Artist Search API returns a JSON-formatted description of artists 
URL: http://app.topspin.net/api/v1/artist

Authentication:

You will need to use HTTP authentication to access the API. To get an API key please make a request here:https://app.topspin.net/account/artisthelp

Use your Topspin email login as your username and the API key as your password.

Requests

A request to http://app.topspin.net/api/v1/artist will return all artists that the authenticated user has access to. The artists can be filtered by supplying one of more of following parameters:

  • 'name' Return artists having the given partial name match
  • 'has_website' Return artists that have a valid configured website in the topspin system

Pagination and Sorting

Artists are returned 25 at a time, default sorted by name. This can be changed by using the following parameters:

  • 'page' requested page number
  • 'per_page' The number of artists to return per page
  • 'column' Column to sort on. Valid Options: name, description, website
  • 'order' Direction to sort the column. Valid Options: asc (ascending), desc (descending)

Response

Responses contain paging information and a list containing artist descriptions.

Each offer description has the following keys:

  • 'name' Artist name
  • 'description' Artist description
  • 'url' URL to json details for the given artist
  • 'website' Website for the given artist
  • 'avatar_image' URL to the artist's avatar image, which is a timestamped image with a default 15 minute lifetime.

Example

Request: curl -u 'kris@asdf.com:XXXXXX' 'http://app.topspin.net/api/v1/artist'

Response:

{
  "total_pages": 1, 
  "current_page": 1, 
  "total_entries": 2, 
  "artists": [
    {
      "name": "Kris Test", 
      "avatar_image": "http://app.topspin.net/images/avatar_default.jpg", 
      "url": "http://app.topspin.net/api/v1/artist/1586", 
      "description": null, 
      "website": "",
                        "spin_tags": [ "memphis-jan-2011" ],
    }, 
    {
      "name": "72 musicians", 
      "avatar_image": "http://cdn.topspin.net/secure/media/serve_by_sku/224709/stream/72musicians.com%20Header.jpg?e=1265764102&authkey=1265764102_4890129915b210da59a15bd91c522506", 
      "url": "http://app.topspin.net/api/v1/artist/825", 
      "description": null, 
      "website": "72musicians.com",
                        "spin_tags": []
    }
  ], 
  "per_page": 25
}
Have more questions? Submit a request and our team will be able to help get you sorted.
Powered by Zendesk