Beatport

A ruby gem for accessing the Beatport API; currently incomplete and only supports the Catalog API, but under development.

oauth-api.beatport.com/docs/

Oauth

Beatport's api now requires authentication via Oauth. This means you now need to provide the gem your oauth credentials to make requests, for example in a rails initializer:

Beatport.consumer_key =        'consumer_key'
Beatport.consumer_secret =     'consumer_secret'
Beatport.access_token_key =    'access_token_key'
Beatport.access_token_secret = 'access_token_secret'

Your consumer key and secret are found in the API Keys section of your beatbort account, whereas the access token key and secret can be generated at the docs page.

Facets

Many queries to beatport support facets, but they aren't properly documentated on their site. These are the ones I've found so far:

Examples

require 'beatport'

  # Search using the query "Mord Fustang" on Beatport
  query = Beatport::Catalog::Search.query("Mord Fustang")

  query.class # => returns a Beatport::Collection object

  query[0].class # => first result is a Beatport::Catalog::Artist object
  query[0].id # => returns the Beatport id of the artist

  query[1].class # => second result is a Beatport.Catalog::Chart object
  query[1].publish_date # => returns the published date of the Chart

  # Note that search results change frequently, so first result may not necessarily be a Beatport::Catalog::Artist object

  # Find top downloads for a given genre
  genres = Beatport::Catalog::Genre.all # => list all genres
  # display each genre and its corresponding Beatport genre slug

  genres.each do |genre|
    puts "Genre: #{genre.name} slug: #{genre.slug}"
  end

  # find the top 10 downloads for the genre Electro House
  electro_house_genre = Beatport::Catalog::Genre.find('electro-house')
  # => create Electro House Genre object by searching by slug

  electro_house_top_10 = trance_genre.top_downloads
  # => list the top downloads for the Electro House genre

  electro_house_top_10[0].name
  # => find the name of the #1 downloaded Electro House track

  # An alternative for searching for genre by slug is searching by genre ID
  trance_genre = Beatport::Catalog::Genre.find(7) # => returns a Trance Genre object

Running specs

To run specs, you'll need to create a file with your oauth credentials in spec/config.rb, which will be loaded by spec/spec_helper.rb

Contributing to beatport

Copyright © 2011-present Mateo Murphy. See LICENSE.txt for further details.