-
Notifications
You must be signed in to change notification settings - Fork 18
Artist API Methods
Tim Case edited this page Sep 1, 2013
·
37 revisions
Get a list of artist biographies.
Echowrap.artist_biographies(:id => 'ARH6W4X1187B99274F', :results => 3) =>
[<Echowrap::Biography:0x007ffea32c20c8
@attrs={:text=>"It's usually safe as milk to assume that bands who ...",
:site=>"trouserpress", :url=>"http://trouserpress.com/entry.php?a=radiohead",
:license=>{:type=>"unknown", :attribution=>"trouserpress",
:"attribution-url"=>"http://trouserpress.com/entry.php?a=radiohead",
:url=>"n/a", :version=>"n/a"}, :truncated=>true}>,
<Echowrap::Biography:0x007ffea32c2078
@attrs={:text=>"Radiohead was one of the few alternative bands of the ...",
:site=>"mtvmusic", :url=>"http://www.mtvmusic.com/radiohead",
:license=>{:type=>"unknown", :attribution=>"n/a",
:"attribution-url"=>"http://www.mtvmusic.com/radiohead", :url=>"n/a", :version=>"n/a"},
:truncated=>true}>, <Echowrap::Biography:0x007ffea32c2050
@attrs={:text=>"Radiohead were one of the few alternative bands of the ...",
:site=>"aol", :url=>"http://music.aol.com/artist/radiohead/biography",
:license=>{:type=>"unknown", :attribution=>"aol",
:"attribution-url"=>"http://music.aol.com/artist/radiohead/biography",
:url=>"n/a", :version=>"n/a"},
:truncated=>true}>]
Echowrap.artist_biographies(:name => 'daft punk', :results => 1) =>
[<Echowrap::Biography:0x007fd621222b40
@attrs={:text=>"In similar company with new-school French progressive dance artists such ...",
:site=>"aol", :url=>"http://music.aol.com/artist/daft-punk/biography",
:license=>{:type=>"unknown", :attribution=>"aol",
:"attribution-url"=>"http://music.aol.com/artist/daft-punk/biography",
:url=>"n/a", :version=>"n/a"}, :truncated=>true}>]Methods on Echowrap::Biography
Get a list of blog articles related to an artist.
Echowrap.artist_blogs(:id => 'ARH6W4X1187B99274F') =>
[<Echowrap::Blog:0x007fb79a22e5f8
@attrs={:name=>"[ms] member mix Andrew Slattery - Back to Mine part 2",
:url=>"http://www.mercuryserver.com/forums/showthread.php?135178-Andrew-Slattery-
Back-to-Mine-part-2&goto=newpost",
:date_posted=>"2013-08-10T04:19:00", :date_found=>"2013-08-10T00:00:00",
:summary=>"Global communication - Gamma Phase 5) Trentemoller ft. Massive attack -
Miss You (Teardrop Mix) 6) Feyorz - Pillowtalk 7) Dido -
No Freedom (Dave Okumu Remix) 8) Eric clapton & sting - It´s
probably me (rayko edit) 9) David A. Stewart & Candy Dulfer -
LILY WAS HERE (rayko balearic edit) 10) Kyson - Drifting On By 11)
<span>Radiohead</span> - Reckoner (Leftside Wobble Off-World Excursion)
12) Motorbass - Fabulous 13) Global Communication - Beta Phase 14) Lamb -
Goreki 15) Leftfield - Melt 16) Underworld - To Heal 17) Dario G - Voices
(featuring Vanessa Quinones) [ms] member mix Andrew Slattery - Back to Mine part 2",
:id=>"99b262447b7996519a62df86052a6b55"}>,
#<Echowrap::Blog:0x007fb79a22e580
@attrs={:name=>"NEW: The Ramona Flowers – Brighter",
:url=>"http://inthejunkyardmusic.co.uk/2013/08/09/new-the-ramona-flowers-brighter/",
:date_posted=>"2013-08-09T18:16:20", :date_found=>"2013-08-09T00:00:00",
:summary=>"that's been said a thousand times before, but The Ramona Flowers
new single 'Brighter' is horribly anthemic. It managed to capture my imagination
(which is quite rare) and has one of those chorus that's destined to end up on some
shitty TV-advertisement (looking in your direction Vodafone) Comparisons are hard
to shift and with The Ramona Flowers being constantly compared to <span>Radiohead
</span> (even U2) I've gave them a wide-berth for quite a while now...
But in the end I was wrong. The Ramona Flowers new single 'Brighter' is
released September 2 through Distiller Records NEW: The Ramona Flowers –
Brighter",
:id=>"16c97a82fa91420b55deb039d19a3f3c"}>,
<Echowrap::Blog:0x007fb79a22e530
@attrs={:name=>"Is Nostalgia Suffocating Our Festivals?",
:url=>"http://www.danceyrselfclean.com/features/articles/is-nostalgia-suffocating-our-festivals",
:date_posted=>"2013-08-09T17:41:03",
:date_found=>"2013-08-09T00:00:00",
:summary=>"been headlined by David Bowie, Rod Stewart, REM, Moby, Paul McCartney,
The Who, The Verve, Neil Young, Bruce Springsteen, a reunited Blur, U2, Stevie Wonder
AND the arc de triomphe in The Rolling Stones.
That is a hell of a lot of acts dripping
in nostalgia. Heck, if you add Oasis, <span>Radiohead</span>, Coldplay and Muse (who
had been around for longer than a decade once they headlined) and the point becomes
magnified. Obviously, it is churlish to suggest that festivals should rid themselves
of these acts. How many people would have been tempted to attend this year's Glastonbury
without The Rolling Stones? Glastonbury", :id=>"08ba8ab97ec6aaee446c7bc3d8de5aa9"}>]
Echowrap.artist_blogs(:name => 'daft punk', :results => 1) =>
[<Echowrap::Blog:0x007ff22124ec10
@attrs={
:name=>"College Students Shoot Half-Naked Video For ‘Get Lucky’ [VIDEO]",
:url=>"http://giantlife.com/997969/
college-students-shoot-half-naked-video-for-get-lucky-video/",
:date_posted=>"2013-08-10T18:30:46",
:date_found=>"2013-08-10T00:00:00",
:summary=>"If <span>Daft Punk</span> has a mega-hit song
in \"Get Lucky\"...
where the hell is the video? There's a video teaser that's been
up for a few
months now and the song's audio video has over 100 million views.
Some guy even
took the teaser and made a full music video out of it. But we don't have anything
official yet. Grrrr.So this guy at Chapman University grabbed a camera and filmed
one during the school's Undie Run. What better place to make a video for a song
called 'Get Lucky' than a place where all the youth are naked and jiggling everywhere?
You know those student loans you're paying off? You wish you were paying them",
:id=>"a068053615f6c9abe9f17377ee416696"}>]Extract artist names from text.
Echowrap.artist_extract(:text => 'This is a story about Macklemore') =>
[<Echowrap::Artist:0x007f83621c5150 @attrs={:name=>"a", :id=>"ARRUBBY11EB3016A09"}>,
<Echowrap::Artist:0x007f83621c5128 @attrs={:name=>"Macklemore", :id=>"AR2XDHU1187B9B484F"}>]Get our numerical estimation of how familiar an artist currently is to the world.
Echowrap.artist_familiarity(:id => 'ARH6W4X1187B99274F') =>
<Echowrap::Familiarity:0x007f8ab122dd80 @attrs={:familiarity=>0.864905,
:id=>"ARH6W4X1187B99274F", :name=>"Radiohead"}>
Echowrap.artist_familiarity(:name => 'daft punk') =>
<Echowrap::Familiarity:0x007f82b1a3c9c0 @attrs={:familiarity=>0.867852,
:id=>"ARF8HTQ1187B9AE693", :name=>"Daft Punk"}>Methods on Echowrap::Familiarity
Returns numerical description of how hottt an artist currently is.
Echowrap.artist_hotttnesss(:id => 'ARH6W4X1187B99274F') =>
<Echowrap::Hotttnesss:0x007fcb12a398e8 @attrs={:hotttnesss=>0.827647, :id=>"ARH6W4X1187B99274F",
:name=>"Radiohead"}>
Echowrap.artist_hotttnesss(:name => 'Elvis Presley') =>
<Echowrap::Hotttnesss:0x007f8eb29b4a18 @attrs={:hotttnesss=>0.754424, :id=>"ARULZ741187B9AD2EF",
:name=>"Elvis Presley"}>Methods on Echowrap::Hotttnesss
Get a list of artist images.
Echowrap.artist_images(:id => 'ARH6W4X1187B99274F') =>
[#<Echowrap::Image:0x007f9fa316fc70 @attrs={
:url=>"http://userserve-ak.last.fm/serve/_/102639.jpg",
:license=>{:type=>"unknown", :attribution=>"last.fm",
:url=>"http://userserve-ak.last.fm/serve/_/102639.jpg"}}>,
<Echowrap::Image:0x007f9fa316fc48
@attrs={:url=>"http://userserve-ak.last.fm/serve/_/174456.jpg",
:license=>{
:type=>"unknown", :attribution=>"last.fm",
:url=>"http://userserve-ak.last.fm/serve/_/174456.jpg"}}>,
<Echowrap::Image:0x007f9fa316fc20
@attrs={:url=>"http://userserve-ak.last.fm/serve/_/2153194.jpg",
:license=>{:type=>"unknown", :attribution=>"last.fm",
:url=>"http://userserve-ak.last.fm/serve/_/2153194.jpg"}}>]
Echowrap.artist_images(:name => 'daft punk', :results => 1) =>
[<Echowrap::Image:0x007fb08122edc0 @attrs={
:url=>"http://userserve-ak.last.fm/serve/500/4183432/Daft+Punk+daftpunk_1.jpg",
:license=>{:type=>"cc-by-sa", :attribution=>"grig_m",
:url=>"www.last.fm/user/grig_m"}}>]Get a list of the available genres for use with search and playlisting. This method returns a list of genres suitable for use in the artist/search call when searching by description and for the creation of genre-radio playlists. The returned list of genres is inclusive of all supported genres.
Echowrap.artist_list_genres =>
[<Echowrap::Genre:0x007fd423152698 @attrs={:name=>"a cappella"}>,
<Echowrap::Genre:0x007fd423152670 @attrs={:name=>"abstract hip hop"}>,
<Echowrap::Genre:0x007fd423152648 @attrs={:name=>"acid house"}>,
<Echowrap::Genre:0x007fd423152620 @attrs={:name=>"acid jazz"}>,
<Echowrap::Genre:0x007fd4231525f8 @attrs={:name=>"acousmatic"}>] (Actual results truncated)Get a list of the best typed descriptive terms for use with search. This method returns a list of descriptive terms suitable for use in the artist/search call when searching by description. The returned list of terms is not necessarily inclusive of all supported terms, but does include terms that are known to return high quality results.
Echowrap.artist_list_terms(:type => 'mood') =>
[<Echowrap::Term:0x007fa06a300f18 @attrs={:name=>"aggressive"}>,
<Echowrap::Term:0x007fa06a300ef0 @attrs={:name=>"ambient"}>,
<Echowrap::Term:0x007fa06a300ec8 @attrs={:name=>"angry"}>,
<Echowrap::Term:0x007fa06a300ea0 @attrs={:name=>"angst-ridden"}>,
<Echowrap::Term:0x007fa06a300e50 @attrs={:name=>"bouncy"}>,
<Echowrap::Term:0x007fa06a300e28 @attrs={:name=>"calming"}>,
<Echowrap::Term:0x007fa06a300e00 @attrs={:name=>"carefree"}>,
<Echowrap::Term:0x007fa06a30c1b0 @attrs={:name=>"cheerful"}>,
<Echowrap::Term:0x007fa06a30c188 @attrs={:name=>"cold"}>,
<Echowrap::Term:0x007fa06a30c160 @attrs={:name=>"complex"}>] (Actual results truncated)Get a list of news articles found on the web related to an artist.
Echowrap.artist_news(:id => 'ARH6W4X1187B99274F', :results => 1) =>
[<Echowrap::NewsArticle:0x007ff71aa41488
@attrs={:url=>"http://news.qthemusic.com/2013/08/playlist_-_black_onassis_dysto.html",
:id=>"2e704c7bdcfbf4e8cbf03f81157cfe34",
:date_found=>"2013-08-09T00:00:00", :name=>"Playlist - Black Onassis'
\"dystopian soundtrack\"
inc Primal Scream, Joy Division, Bowie",
:summary=>"destructive nature of radioactivity. The mention of Madame Curie is
particularly poignant, being as she dedicated so much of her life to her pioneering
research on radioactivity, and died of her overexposure to it.
Radioactivity in itself is dualistic, as it is something that can both destroy and
heal.\"
<span>Radiohead</span>-
2+2=5 (The Lukewarm) \"Any dystopian soundtrack would be
incomplete without a
song from <span>Radiohead</span>, one of the most talented and profound bands of our
time. 2+2=5 is a reference to George Orwell's 1984. It is a phrase used to illustrate
that truth can be irrelevant. 2+2=5 is an obviously"}>]Methods on Echowrap::NewsArticle
Get basic information about an artist.
Echowrap.artist_profile(:id => 'ARH6W4X1187B99274F') =>
<Echowrap::Artist:0x007fdcd11ad758 @attrs={:id=>"ARH6W4X1187B99274F", :name=>"Radiohead"}>
Echowrap.artist_profile(:name => 'daft punk') =>
<Echowrap::Artist:0x007fd14b2888d0 @attrs={:id=>"ARF8HTQ1187B9AE693", :name=>"Daft Punk"}>Get reviews related to an artist's work.
Echowrap.artist_reviews(:id => 'ARH6W4X1187B99274F') =>
[<Echowrap::Review:0x007ff5e20c1680
@attrs={:name=>"Radiohead - OK Computer - Album Review - AbsolutePunk.net",
:url=>"http://absolutepunk.net/showthread.php?t=3192381",
:summary=>"Release Date: May 21st 1997 I'm a firm believer in
the idea that music is quite subjective, meaning that there are not
any \"bad\"
artists, but only good ones, because everyone is going to
like different things, so everything is good to someone. On the flipside of
that, there are things I don't like, but I usually pay those things no mind,
unless it's Blood On The Dance Floor, then that's just a horrible band that I see no appeal for...",
:date_reviewed=>"2013-05-18T00:00:00", :date_found=>"2013-05-20T00:00:00",
:image_url=>"http://absolutepunk.net/geek/gars/images/8/4/7/7/7/2/
radiohead.okcomputer.albumart_2.jpg", :release=>"OK Computer",
:id=>"32f8857b1f0e2ddbb33abbbe3b2b28cd"}>,
<Echowrap::Review:0x007ff5e20c15e0
@attrs={:name=>"RADIOHEAD > Kid A, Amnesiac, Hail To The Thief | American Songwriter",
:url=>"http://www.americansongwriter.com/2009/12/radiohead-
kid-a-amnesiac-hail-to-the-thief-2/",
:summary=>"Radiohead's OK Computer tour nearly killed them.
After much soul-searching, they had created one of the most beloved
albums of the 20th century. However, like all good '90s alternative rock
bands, they were mortified by success, and the conveyor belt of endless
self-promotion was nearly too much for them to bear. While no one wanted
Radiohead to do anything differently, for the restlessly inventive British
gloom rockers, the path was clear--change or die...",
:date_found=>"2013-04-25T00:00:00",
:image_url=>"http://cdn.americansongwriter.com/wp-content/
uploads/2009/11/rs_radiohead.jpg",
:release=>"Kid A, Amnesiac, Hail To The Thief", :id=>"3f9fca724678df56f34845365110c511"}>]Search artists.
#All artists with daft in the name
Echowrap.artist_search(:name => 'daft', :results => 3) =>
[<Echowrap::Artist:0x007fdfdb9fea08 @attrs={:name=>"Dafter", :id=>"AROZZAG135A79B0A61"}>,
<Echowrap::Artist:0x007fdfdb9fe9e0 @attrs={:name=>"Daft DJ", :id=>"ARDHCDI122BCFC9DB2"}>,
<Echowrap::Artist:0x007fdfdb9fe9b8 @attrs={:name=>"Daft Werk", :id=>"ARFZYOX12AA0D91CD8"}>]
#Return multiple bucket data in the response
Echowrap.artist_search(:name => 'daft punk', :bucket => ['hotttnesss', 'familiarity', 'artist_location',
'songs'],
:results => 1) =>
[<Echowrap::Artist:0x007f968b21b8c0 @attrs={:name=>"Daft Punk",
:familiarity=>0.867852, :hotttnesss=>0.943987, :id=>"ARF8HTQ1187B9AE693",
:artist_location=>{:city=>"Paris", :region=>"Île-de-France", :location=>"Paris,
Ile-de-France, FR", :country=>"France"}, :songs=>[{:id=>"SOYNESM13F63A048E8",
:title=>"Get Lucky"}, {:id=>"SOMSYPI13EEDF75168", :title=>"Get Lucky"},
{:id=>"SOBFMZQ13E279A0048", :title=>"Get Lucky"}, {:id=>"SOTQZYM13EFD8458B2",
:title=>"Give Life Back to Music"}, {:id=>"SOUBABG13F62B54A2F",
:title=>"Give Life Back to Music"}, {:id=>"SOVBNVU13F62A7D7D9",
:title=>"Giorgio by Moroder"}, {:id=>"SOALZAG13F13FA89BA", :title=>"The Game of Love"},
{:id=>"SOTSVKD13152A70D43", :title=>"One More Time"}, {:id=>"SOJAOJL133A921021D",
:title=>"One More Time"}, {:id=>"SOJTVLG13FB174874E", :title=>"One More Time"},
{:id=>"SOUSIKY137799644A7", :title=>"One More Time"}, {:id=>"SOASBDB135CBB06DCB",
:title=>"One More Time"}, {:id=>"SOQICXY1373265000B", :title=>"One More Time"},
{:id=>"SORKZSF13E9061D6DB", :title=>"One More Time"}, {:id=>"SOSRHOS13F6168B20B", :title=>"Beyond"}]}>]
#Description, style, with a boosted mood term
Echowrap.artist_search(:description => 'quirky', :style => 'indie',
:mood => 'chill^1.2', :results => 3) =>
[<Echowrap::Artist:0x007fa9821e5e50
@attrs={:name=>"Hot Chip", :id=>"ARWA8AH1187FB3FC84"}>,
<Echowrap::Artist:0x007fa9821e5dd8
@attrs={:name=>"Robyn Hitchcock", :id=>"AR8GAJA1187B9B557D"}>,
<Echowrap::Artist:0x007fa9821e5d88
@attrs={:name=>"National Eye", :id=>"AR7WD331187FB3860E"}>]
#No country music
Echowrap.artist_search(:style => '-country', :results => 3) =>
[<Echowrap::Artist:0x007f903b26c230
@attrs={:name=>"Frederico Mondelci, Massimo Mazzoni", :id=>"ARLGNEE1269FB2E54E"}>,
<Echowrap::Artist:0x007f903b26c1e0
@attrs={:name=>"Shulman", :id=>"ARNHBRG1187B99B130"}>,
<Echowrap::Artist:0x007f903b26c1b8
@attrs={:name=>"Johannes Linstead", :id=>"AR3GE071187B9A6D71"}>]
#Artist that started after 1970 and ended before now
Echowrap.artist_search(:artist_start_year_after => '1970',
:artist_end_year_before => 'present',
:results => 3) =>
[<Echowrap::Artist:0x007fc0f2a371a8 @attrs={:name=>"Johannes Linstead", :id=>"AR3GE071187B9A6D71"}>,
<Echowrap::Artist:0x007fc0f2a37180 @attrs={:name=>"DJ A-He@d", :id=>"ARDIOGG1269FB371DE"}>,
<Echowrap::Artist:0x007fc0f2a37130 @attrs={:name=>"Matmatah", :id=>"ARWQKMX1187B98F108"}>]
#Boston artists
Echowrap.artist_search(:artist_location => 'boston', :bucket => 'artist_location',
:results => 3) =>
[<Echowrap::Artist:0x007fc1098d9718 @attrs={:name=>"Aerosmith",
:id=>"AR12F2S1187FB56EEF", :artist_location=>{:city=>"Boston",
:region=>"Massachusetts", :location=>"Boston, MA, US",
:country=>"United States"}}>,
<Echowrap::Artist:0x007fc1098d95b0
@attrs={:name=>"Pixies", :id=>"AR1E9AW1187B9AC8F6",
:artist_location=>{:city=>"Boston", :region=>"Massachusetts",
:location=>"Boston, MA, US", :country=>"United States"}}>,
<Echowrap::Artist:0x007fc1098d9588 @attrs={:name=>"Dream Theater",
:id=>"ARFYKUO1187B98D941", :artist_location=>{:city=>"Boston",
:region=>"Massachusetts", :location=>"Boston, MA, US", :country=>"United States"}}>]
#Boston artists with special city key
Echowrap.artist_search(:artist_location => 'city:boston', :bucket => 'artist_location', :results => 3) =>
[<Echowrap::Artist:0x007fc1098d9718 @attrs={:name=>"Aerosmith",
:id=>"AR12F2S1187FB56EEF", :artist_location=>{:city=>"Boston",
:region=>"Massachusetts", :location=>"Boston, MA, US",
:country=>"United States"}}>, <Echowrap::Artist:0x007fc1098d95b0
@attrs={:name=>"Pixies", :id=>"AR1E9AW1187B9AC8F6",
:artist_location=>{:city=>"Boston", :region=>"Massachusetts",
:location=>"Boston, MA, US", :country=>"United States"}}>,
<Echowrap::Artist:0x007fc1098d9588 @attrs={:name=>"Dream Theater",
:id=>"ARFYKUO1187B98D941", :artist_location=>{:city=>"Boston",
:region=>"Massachusetts", :location=>"Boston, MA, US", :country=>"United States"}}>]
#Japan artists with special country key
Echowrap.artist_search(:artist_location => 'country:brazil', :bucket => 'artist_location', :results => 3) =>
[<Echowrap::Artist:0x007fecf906c320 @attrs={:name=>"Sepultura",
:id=>"ARHLT3W1187FB5711F", :artist_location=>{:city=>"Belo Horizonte",
:region=>"Minas Gerais", :location=>"Belo Horizonte, Minas Gerais, BR",
:country=>"Brazil"}}>, #<Echowrap::Artist:0x007fecf906c2f8
@attrs={:name=>"Antônio Carlos Jobim", :id=>"ARIQC381187B9A825E",
:artist_location=>{:city=>"Rio de Janeiro", :region=>"Rio de Janeiro",
:location=>"Rio de Janeiro, Rio de Janeiro, BR", :country=>"Brazil"}}>,
<Echowrap::Artist:0x007fecf906c2d0 @attrs={:name=>"Chico Buarque",
:id=>"ARWA0921187FB3CEEF", :artist_location=>{:city=>"Rio de Janeiro",
:region=>"Rio de Janeiro", :location=>"Rio de Janeiro, Rio de Janeiro, BR", :country=>"Brazil"}}>]
#Style, max familiarity, min familiarity, and sort
Echowrap.artist_search(:style => 'rock', :max_familiarity => 0.80, :min_familiarity => 0.10,
:sort => 'hotttnesss-desc', :results => 3) =>
[<Echowrap::Artist:0x007fb9da23f410 @attrs={:name=>"Lou Reed", :id=>"ARO5T1P1187B9AC680"}>,
<Echowrap::Artist:0x007fb9da23f3e8 @attrs={:name=>"Dispatch", :id=>"ARAVYL81187FB3C6D6"}>,
<Echowrap::Artist:0x007fb9da23f3c0 @attrs={:name=>"Live", :id=>"ARE2DJ41187B99083E"}>]
#Paging example
Echowrap.artist_search(:style => 'rock', :start => 15, :results => 100) =>
(Actual Results Omitted)Return similar artists given one or more artists for comparison. The Echo Nest provides up-to-the-minute artist similarity and recommendations from their real-time musical and cultural analysis of what people are saying across the Internet and what the music sounds like.
#Artists similar to Radiohead
Echowrap.artist_similar(:id => 'ARH6W4X1187B99274F', :results => 3) =>
[<Echowrap::Artist:0x007fc04420e9f8 @attrs={:name=>"Thom Yorke", :id=>"ARH1N081187B9AC562"}>,
<Echowrap::Artist:0x007fc04420e9a8 @attrs={:name=>"Doves", :id=>"ARW64KS1187FB3C94D"}>,
<Echowrap::Artist:0x007fc04420e980 @attrs={:name=>"The Verve", :id=>"AR0L04E1187B9AE90C"}>]
#Artists similar to Daft Punk
Echowrap.artist_similar(:name => 'daft punk') =>
[<Echowrap::Artist:0x007fb4243262b8 @attrs={:name=>"Cassius", :id=>"ARCGHBU1187FB4B637"}>,
<Echowrap::Artist:0x007fb424326290 @attrs={:name=>"Basement Jaxx", :id=>"ARFSPOV1187B9B2363"}>,
<Echowrap::Artist:0x007fb424326240 @attrs={:name=>"Les Rythmes Digitales", :id=>"AR3NPVS1187FB5108F"}>]Get a list of songs created by an artist.
Echowrap.artist_songs(:id => 'ARH6W4X1187B99274F', :results => 10) =>
[<Echowrap::Song:0x007faf719ee940
@attrs={:id=>"SOINKKG1373F0A21D2", :title=>"005_Track 5"}>,
<Echowrap::Song:0x007faf719ee850
@attrs={:id=>"SOCMLWM137527E197D", :title=>"14. A Wolf at the Door"}>,
<Echowrap::Song:0x007faf719ee828
@attrs={:id=>"SOQIIYL137527E560B", :title=>"11. A Punch-Up at a Wedding"}>,
<Echowrap::Song:0x007faf719ee6c0
@attrs={:id=>"SOUEMZL137527E1E29", :title=>"04. Backdrifts"}>,
<Echowrap::Song:0x007faf719ee698
@attrs={:id=>"SOPENCY137527E0E1C", :title=>"06. Where I End and You Begin"}>,
<Echowrap::Song:0x007faf719ee5f8
@attrs={:id=>"SOQLIKC137787BCDA8", :title=>"02. Sit Down. Stand Up"}>,
<Echowrap::Song:0x007faf719ee5d0
@attrs={:id=>"SOQLLWT13926389748", :title=>"Reckoner (Left Side Wobble Edit)"}>,
<Echowrap::Song:0x007faf719ee5a8
@attrs={:id=>"SOVBYEO13926387890", :title=>"Videotape (Mojib Remix)"}>,
<Echowrap::Song:0x007faf719ee4e0
@attrs={:id=>"SOQIBRW1392638B5A3", :title=>"Climbing Up The Walls (Fila Brazilia Rm)"}>,
<Echowrap::Song:0x007faf719ee3f0
@attrs={:id=>"SOASLXX139263875C6", :title=>"Nude (Naked Lounge Remix)"}>]
Echowrap.artist_songs(:name => 'Jay-Z', :results => 10) =>
[<Echowrap::Song:0x007ff0542ae0a8
@attrs={:id=>"SOXNTQM13CF60100AD", :title=>"P.S.A. Remix"}>,
<Echowrap::Song:0x007ff0542ae080
@attrs={:id=>"SOJXJXA137378A2A90", :title=>"LOST ONE (Clean)/(CC Clean Edit)"}>,
<Echowrap::Song:0x007ff0542adf90
@attrs={:id=>"SONZLWT1373797DA09", :title=>"SHOW ME WHAT YOU GOT (Clean)"}>,
<Echowrap::Song:0x007ff0542adf68
@attrs={:id=>"SOXEVPE13737BEE859", :title=>"D.O.A. (Death Of Auto-Tune)/(Clean)"}>,
<Echowrap::Song:0x007ff0542add60
@attrs={:id=>"SOWFOPL13737DD90AD", :title=>"KINGDOM COME (Clean Edit)/(CONTENT!)"}>,
<Echowrap::Song:0x007ff0542adb80
@attrs={:id=>"SOXFDYV137383F70EE", :title=>"30 SOMETHING (Clean)/(Radio Edit)/(CONTENT!)"}>,
<Echowrap::Song:0x007ff0542adb58
@attrs={:id=>"SOUQVWY137392B1EB1", :title=>"RUN THIS TOWN (Clean Edit)/(LYRICS!)/(CONTENT!)"}>,
<Echowrap::Song:0x007ff0542ada68
@attrs={:id=>"SONWNYF137392B31D3", :title=>"RUN THIS TOWN (KIIS Edit)/(LYRICS!)/(CONTENT!)"}>,
<Echowrap::Song:0x007ff0542ad5e0
@attrs={:id=>"SOZIPKD13D9DDC5510", :title=>"Excuse Me Miss (Instrumental)"}>,
<Echowrap::Song:0x007ff0542ad5b8
@attrs={:id=>"SOOBRSH1373F4FED4E", :title=>"D.O.A. [Death of Auto-Tune]
[Chase + Status Remix] (Chase + Status Remix Album version)"}>]Suggest artists based upon partial names. This method will return a list of potential artist matches based upon a query string. The method returns the most familiar best matching artist for the query. Echonest API documentation
Echowrap.artist_suggest(:name => 'Daft Pu') =>
[<Echowrap::Artist:0x007fd13a8c7338 @attrs={:name=>"Daft Punk", :id=>"ARF8HTQ1187B9AE693"}>,
<Echowrap::Artist:0x007fd13a8c72c0 @attrs={:name=>"Daft Punk/Pharrell", :id=>"ARNCJPR13E7F76F6C2"}>,
<Echowrap::Artist:0x007fd13a8c7298 @attrs={:name=>"Daft Punk+Pharrell Williams", :id=>"ARQITXU13FA75B90F4"}>]Get a list of most descriptive terms for an artist.
Echowrap.artist_terms(:id => 'ARH6W4X1187B99274F') =>
[#<Echowrap::Term:0x007fc19c964618>, #<Echowrap::Term:0x007fc19c9645f0>, #<Echowrap::Term:0x007fc19c964550>]
Echowrap.artist_terms(:name => 'daft punk') =>
[<Echowrap::Term:0x007fdbf32bcd08
@attrs={:frequency=>1.0, :name=>"house", :weight=>1.0}>,
<Echowrap::Term:0x007fdbf32bcce0
s@attrs={:frequency=>0.5950848559271871, :name=>"punk", :weight=>0.6976976069615664}>,
<Echowrap::Term:0x007fdbf32bccb8
@attrs={:frequency=>0.4484337546091896, :name=>"techno", :weight=>0.6371464829586657}>,
<Echowrap::Term:0x007fdbf32bcc40
@attrs={:frequency=>0.5185194791177608, :name=>"electronic", :weight=>0.5917331399564902}>,
<Echowrap::Term:0x007fdbf32bcc18
@attrs={:frequency=>0.5204255848221713, :name=>"dance", :weight=>0.5347171863669326}>]
(Actual results truncated)Return a list of the top hottt artists.
Echowrap.artist_top_hottt(:genre => 'hip hop') =>
[<Echowrap::Artist:0x007fd77b204bd0 @attrs={:name=>"Kanye West", :id=>"ARRH63Y1187FB47783"}>,
<Echowrap::Artist:0x007fd77b204b58 @attrs={:name=>"Macklemore & Ryan Lewis", :id=>"ARZEHLK12DDD1882BF"}>,
<Echowrap::Artist:0x007fd77b204b30 @attrs={:name=>"Jay-Z", :id=>"ARLGIX31187B9AE9A0"}>,
<Echowrap::Artist:0x007fd77b204b08 @attrs={:name=>"Lil Wayne", :id=>"ARUDYKB11F4C83C269"}>,
<Echowrap::Artist:0x007fd77b204ae0 @attrs={:name=>"Eminem", :id=>"ARTH9041187FB43E1F"}>,
<Echowrap::Artist:0x007fd77b204a40 @attrs={:name=>"Drake", :id=>"ARODZUF11F4C841E1F"}>,
<Echowrap::Artist:0x007fd77b204a18 @attrs={:name=>"Nelly", :id=>"ARCBD0U1187FB466EF"}>,
<Echowrap::Artist:0x007fd77b2049f0 @attrs={:name=>"Flo Rida", :id=>"AR1IJ1Z11C8A41500D"}>,
<Echowrap::Artist:0x007fd77b2049a0 @attrs={:name=>"J. Cole", :id=>"ARFIDHF12496DAB7E1"}>,
<Echowrap::Artist:0x007fd77b204978 @attrs={:name=>"Kid Cudi", :id=>"ARD46C811C8A414F3F"}>,
<Echowrap::Artist:0x007fd77b204928 @attrs={:name=>"Kendrick Lamar", :id=>"AREJQVO12C1DF51FFE"}>,
<Echowrap::Artist:0x007fd77b204900 @attrs={:name=>"DJ Khaled", :id=>"ARPVZTA1187B9A63A8"}>,
<Echowrap::Artist:0x007fd77b2048d8 @attrs={:name=>"Wale", :id=>"ARXYXJ311A348EFC1A"}>,
<Echowrap::Artist:0x007fd77b204860 @attrs={:name=>"B.o.B", :id=>"ARKQQZA12086C116FC"}>,
<Echowrap::Artist:0x007fd77b204838 @attrs={:name=>"Snoop Dogg", :id=>"ARZ5H0P1187B98A1DD"}>]Returns a list of the overall top terms.
Echowrap.artist_top_terms =>
[<Echowrap::Term:0x007facdba51880 @attrs={:frequency=>1.0, :name=>"rock"}>,
<Echowrap::Term:0x007facdba51858 @attrs={:frequency=>0.9669794294745366, :name=>"00s"}>,
<Echowrap::Term:0x007facdba51830 @attrs={:frequency=>0.9555613703811564, :name=>"pop"}>,
<Echowrap::Term:0x007facdba517e0 @attrs={:frequency=>0.9455918505395747, :name=>"house"}>,
<Echowrap::Term:0x007facdba51790 @attrs={:frequency=>0.9402322319948794, :name=>"club"}>,
<Echowrap::Term:0x007facdba51768 @attrs={:frequency=>0.9297713618242534, :name=>"jazz"}>]
(Actual results truncated)Gets the twitter handle for an artist
Echowrap.artist_twitter(:name => 'Kanye West') =>
<Echowrap::Artist:0x007ffa79ade0a0 @attrs={:id=>"ARRH63Y1187FB47783", :name=>"Kanye West"}>Get links to the artist's official site, MusicBrainz site, MySpace site, Wikipedia article, Amazon list, and iTunes page.
Echowrap.artist_urls(:name => 'daft punk') =>
<Echowrap::Urls:0x007fdbe419b2d0 @attrs={:official_url=>"http://www.daftpunk.com/",
:lastfm_url=>"http://www.last.fm/music/Daft+Punk",
:mb_url=>"http://musicbrainz.org/artist/056e4f3e-d505-4dad-8ec1-d04f521cbb56.html",
:amazon_url=>"http://www.amazon.com/gp/search?ie=UTF8&keywords=Daft Punk&tag=httpechonecom-20&index=music",
:wikipedia_url=>"http://en.wikipedia.org/wiki/Daft_Punk", :itunes_url=>"http://itunes.com/DaftPunk",
:myspace_url=>"http://www.myspace.com/daftpunk"}>Get a list of video documents found on the web related to an artist. Echonest API documentation
Echowrap.artist_video(:name => 'radiohead', :results => 3) =>
[<Echowrap::Video:0x007fb4449af768 @attrs={:title=>"Radiohead - Pyramid Song (Lyrics On Screen)",
:url=>"http://www.youtube.com/watch?v=JDgqD2XiElc&feature=youtube_gdata_player", :site=>"youtube.com",
:date_found=>"2013-08-07T00:00:00", :image_url=>"http://i.ytimg.com/vi/JDgqD2XiElc/default.jpg",
:id=>"358c11132b51ee49356dbb9db04d2098"}>, <Echowrap::Video:0x007fb4449af740
@attrs={:title=>"Radiohead - Pyramid
Song", :url=>"http://www.youtube.com/watch?v=PGhr9oF4dww&feature=youtube_gdata_player", :site=>"youtube.com",
:date_found=>"2013-08-07T00:00:00", :image_url=>"http://i.ytimg.com/vi/PGhr9oF4dww/default.jpg",
:id=>"f714b5a445bb3bbc73200d577ac1c22c"}>, <Echowrap::Video:0x007fb4449af6c8 @attrs={:title=>"Radiohead -
Hunting Bears", :url=>"http://www.youtube.com/watch?v=osVPm9wuKHo&feature=youtube_gdata_player",
:site=>"youtube.com", :date_found=>"2013-08-06T00:00:00",
:image_url=>"http://i.ytimg.com/vi/osVPm9wuKHo/default.jpg", :id=>"62160affc99a9ffa0d52c49f3c103934"}>]