Skip to content
This repository was archived by the owner on Oct 28, 2021. It is now read-only.

Songza API notes

djcode edited this page Apr 16, 2013 · 6 revisions

Songza API

Main URL is:

http://songza.com/api/1/situation/targeted?

parameters are:

###current_date Todays date in urlencoded isoformat. Timezone does not seem to be necessary. ###day (required) Day of the week.

0 - Sunday

1 - Monday

2 - Tuesday

3 - Wednesday

4 - Thursday

5 - Friday

6 - Saturday

###period (required) Period during the day.

0 - Morning

1 - Late Morning

2 - Afternoon

3 - Evening

4 - Night

5 - Late Night

###device Device accessing the service? Currently set to "web". Can also be "android-tablet".

###site Not sure, but it's required. Possibly to authorize 3rd parties. Default: "songza".

###style (optional) Was set to "ipad" when accessed from the Songza Android App.

###max_situations (optional) The maximum number of "situations" to respond with.

###max_stations (optional) The maximum number of stations to respond with.

The Station URL is:

http://songza.com/api/1/station/

The song URL is:

http://songza.com/api/1/station//next

The similar station URL is:

http://songza.com/api/1/station//similar ###site Default: songza

The Browse URL is:

http://songza.com/api/1/tags

The sub-Browse URL is:

http://songza.com/api/1/gallery/tag/{cat}

where {cat} is:

genres

activities

moods

decades

culture

record_store_clerk

##The popular URLs are: http://songza.com/api/1/gallery/slug/songza/web-new-and-notable

http://songza.com/api/1/chart/name/songza/trending

http://songza.com/api/1/chart/name/songza/all-time ##Loading multiple station info at once http://songza.com/api/1/station/multi?id={id}&id={nextid)&id={theidafterthat} ... repeat