Build apps with artist metadata, media and offers
Topspin ArtistLink is a REST API that provides access to artist metadata, media and offers from Topspin GoDirect artists. Artists use the GoDirect interface to update their profile, bio, images, songs, videos, products and offers... and developers then use ArtistLink to build great apps for fans around content that comes directly from artists.
Here's how it works:
- Email us via the form at right and we'll send you a key
- Build something awesome, making sure you include a link to GoDirect so artists know how to update content in your app
- Send us feedback and updates, so we can make the API better and promote your app to artists
Navigation through the docs is accessible on the left side of the page.
Get access to ArtistLink:loading...
U The Account Object
The Account object contains data about a single artist within GoDirect.
You can query the API to retrieve information about a particular artist or list all artists.
state will be blank if the country is not "United States"
Z Example Code
Retrieving an Account
Retrieves information about a specific Account.
Requires the Account's id.
The unique identifier of the Account
Returns an Account object if a valid id argument has been supplied. Otherwise, returns error json.
SUBMIT FAN EMAIL FOR ACCOUNT
curl --data "firstname.lastname@example.org&account_id=1&
Returns the account object where the email was submitted:
List All Accounts
Lists Accounts in order of their creation date.
Return artist accounts falling within a specified genre.
The number of Accounts to be returned. Can range between 1 and 100 Accounts.
The offset to the array of Accounts to be returned. The Accounts requested will be returned starting at this number.
Filters accounts by name.
An array containing up to count Accounts, starting at the offset index. Each entry in the array will be an Account object. If no more Accounts are available, the resulting array will be empty. This request should never return an error.
b The Product Object
The Product object contains data about a particular track, video, or image, denoted by its "type" attribute.
Currently you may only retreive information about a particular Product or list all Products.
unique id of the Product
id of the Account the Product belongs to
designates the type of Product.
Will be one of the following: "track","video", or "image"
Hash containing different widget configurations in the form of iframe html that can be embedded into html pages. player : string or null download_button : string or null standard string : string or null
Hash containing Product's metadata.
string or null
string or null
Hash containing uris to the Product's images
URI of the Product. Use this to retrieve data for a specific Product
Z Example Code
Retrieving a Product
Retrieves a specific Product's data. Requires the id of the Product.
The unique identifier of the Product
Returns Product json if a valid id argument has been supplied. Otherwise, returns error json.
List all Products
Lists Products in order of their creation date.
Filter by Product type. Available product types are 'track', 'album', 'video', 'image'
The number of Products to be returned. Can range between 1 and 100.
The offset to the array of Products to be returned. The Products requested will be returned starting at this number.
Lists all Products belonging to a specific Account id
Filter by Products belonging to an account with the name attribute matching this argument. Case sensitive.
An array containing up to count Products, starting at the offset index, with any further passed in arguments/filters applied. Each entry in the array will be a Product object. If no more Products are available, the resulting array will be empty. This request should never return an error.