NPR Station Finder API is Released

Just released this week is an interesting API for those developers / mash-up artists out there.  Announcing the NPR Station Finder API – now you can pass in the zip code (and a few other values) and find the station to hear Car Talk or Wait Wait Don’t Tell Me (my two favorite shows on NPR on KQED in the SF Bay Area). This has great potential for a mobile widget (widget developers check out the MOTODEV Challenge and the VE66 and EM35) where if I am in Chicago for the first time and want to know what the NPR local station is, I just load up the widget on my phone, punch in my zip code I’m in (or if GPS capable phone select my current location) and then viola I have my radio station that I turn the dial too. 
 

NPR
Here is the api information that I pulled from the NPR site:

The following get passed to the Station Finder API, as query string parameters on the base URL (http://api.npr.org/stations.php):

apiKey
The apiKey parameter is required for all API requests. To get a key, you must register. Once registered, you can get and/or change your apiKey from your Account Manager.
Upon registration, your apiKey will be saved to a cookie that will enable the Query Generator to apply your apiKey to your queries

zip
Searches for stations that can be heard in the provided zip code.

city
Searches for stations that can be heard in the provided city/state. When using city, the state parameter must also be used.

state
Searches for stations that can be heard in the provided city/state. When using state, the city parameter must also be used.

callLetters
The call letters are the unique identifiers associated with the stations. This parameter searches for stations that have the provided call letters, or are related to the provided call letters. Can be used with the band parameter to refine the search.

band
The band indicates if the station is an FM or AM station. This parameter searches for stations that have the provided call letters AND band, or are related to the provided call letters AND band. This parameter must be used with the call letters parameter.

network
Searches for stations that belong to the provided network.

lat
Searches for stations that can be heard in the provided latitude/longitude. Both parameters are float values. This parameter must be used with the lon parameter. The system is always expecting the latitude to be a positive value.

lon
Searches for stations that can be heard in the provided latitude/longitude. Both parameters are float values. This parameter must be used with the lat parameter. The system is always expecting the longitude to be a positive value.

id
The unique ID associated with the organization.

 

-Randy

Advertisements

Leave a Reply

Fill in your details below or click an icon to log in:

WordPress.com Logo

You are commenting using your WordPress.com account. Log Out / Change )

Twitter picture

You are commenting using your Twitter account. Log Out / Change )

Facebook photo

You are commenting using your Facebook account. Log Out / Change )

Google+ photo

You are commenting using your Google+ account. Log Out / Change )

Connecting to %s

%d bloggers like this: