/v2/search

GET

Parameter Options
q Search query. Typically keywords.
token Your access token. Restricts results to your portal.
verbose Can be "true" or "false". When true, the response will include additional fields such as genre_image, similar_artsits, etc.
bpm Beats Per Minute. Accepts ranges (eg: "100-150")
duration Media duration, in seconds. Accepts ranges (eg: "60-90")
title Title of the track.
artist_names Artist name.
album_title Album name.
genre Primary genre.
rumblefish_genre Normalized Genre
catalog_id Catalog ID.
catalog_name Catalog name (eg: CDBaby AllMedia).
catalog_provider_id Catalog provider ID.
catalog_provider_name Catalog provider name (eg: Indaba).
explicit true, false Whether the media contains explicit content.
instrumental true, false Whether the media is instrumental (non-vocal).
grid Global Release Identifier
isrc International Standard Recording Code
iswc International Standard Work Code
upc Universal Product Code
facets Any of the above fields. (see below)
start Returns results starting at this location in the set.
sort title, genre, bpm, explicit, duration, picked_at, artist_names Sorts results by the provided field.
direction asc, desc Determines the sort direction.
per_page 0...75 Determins how manny rows are returned. Default: 25
note: default max return is 75, please contact Rumblefish Inc if you wish to up this limmit.

Usage

Search currently returns media records.

Search will by default return 25 results, but will provide a total_media value that shows how many total results were found for your search. Use the start parameter to control pagination.

If you also include a token, your results will be constrained by the data available to the portal you have authenticated for.

Any of the field parameters (eg: title, album, catalog_id, etc.) may be passed as an array. For example: GET /v2/search?artist_name[]=dozer&artist_name[]=wienland will query for artists by the name of "dozer" or "wienland."

Facets

Adding a facets parameter to your search returns extra metadata about the distribution of results within that facet. For example:

GET /v2/search?q=trucks&facets=genre

... adds a facets object to the JSON results that looks like this:

'facets' : {
  'genre' : {
    'electronica' : 10,
    'country' : 4892832,
    'rock' : 529,
    'pop' : 130
  }
}

... and as you can see, you have a lot of interest in "trucks" within the "country" genre.

You're welcome to request multiple facets counts, by comma delimiting them. For example:

GET /v2/search?q=trucks&facets=genre,duration

Try It!