A request to http://app.topspin.net/offer will return all public offers for artists that the authenticated user has access to. The offers can be filtered by supplying one of more of following parameters:
'artist_id' Return offers for the artist having the given Topspin ID.
'offer_type' Return offers of the given type. Valid types are: buy_button, email_for_media, bundle_widget (multi-track streaming player in the app) or single_track_player_widget
'product_type' Return offers for the given product type. Valid types: image, video, track, album, package, other_media, merchandise
'name' Partial match of campaign name.
'status' Include 'all', 'inactive' or 'active' offers. Default: active
'tags' Select spins by tag. Include multiple tags by separating them with a comma.
'updated_after' Select only spins that have been created, modified, or made inactive since the given timestamp.
Pagination and Sorting:
Offers are returned 25 at a time, sorted by their created date. This can be changed by using the following parameters:
'page' requested page number
'sortcol' Column to sort on. Valid Options: created_at, name, offer_type, artist_id,
product_type, plays, views, plays
'sortdir' Direction to sort the column. Valid Options: asc (ascending), desc (descending)
Responses contain paging information and a list containing offer descriptions.
Each offer description has the following keys:
'artist_id' Topspin ID for the artist
'artist_name' Artist name
'offer_type' Type of widget. Possible values - buy_button, email_for_media, bundle_widget, single_track_player_widget.
'product_type' Type of product offered. Possible values - image, video, track, album,
account_product_bundle, other_media, merchandise
'embed_code' html snippet to display the widget
image_small' small widget cover image
'image_medium' medium widget cover image
'image_large' large widget cover image
'price' Offer price
'currency' Currency of offer price
'plays' Number of plays
'views' Number of views
'offer_url' Landing page url for the offer (Buy Button offers only)
'mobile_url' Mobile device landing page url for the offer (Buy Button offers only)