Live Audio Feed Catalog API v 1.3 Documentation

Broadcastify Audio API Version 1.3 - 6/1/2013

The broadcastify audio feed catalog API is only available to approved licensees.  We are currently not issuing addtional licenses to mobile device developers at this time.   If you are interested in developing an application or service that uses Broadcastify's live audio feeds, we strongly encourage you to contact us directly at support@broadcastify.com with details on your plans to use the feed catalog API to integrate with your application.

Application API key

Application key is required for access to the API.  API keys are currently provided by RadioReference.com  Please see the following URL to apply for an application key:

  • http://www.radioreference.com/apps/account/?tab=api

API Endpoint URL

  • http://api.broadcastify.com/audio/
  • https://api.broadcastify.com/audio/ (Secure)

Required API Parameters

 
  • key = your assigned application key
  • a = action (see below)
  • type = response type (json or xml)

Example:

http://api.broadcastify.com/audio/?a=feeds&type=xml&key=123456789

API Methods

feeds

Returns all feeds present in the Broadcastify directory

Optional specifiers and filters:

  • - stid=xxx returns all feeds in a specific state where xxx=RR stid
  • - coid=xxx returns all feeds in a specific country where xxx=RR coid
  • - top=xx - returns the top xx feeds ordered by number of listeners
  • - new=xx - returns the xxx newest feeds ordered by date added
  • - s=xxx - search results by text string
  • - genre=x - filter by genre numerical ID x

1 = Public Safety
2 = Aircraft
3 = Rail
4 = Amateur Radio
5 = Marine
6 = Other
7 = Special Event
8 = Disaster Event

Example:  - returns all audio feeds in XML format

http://api.broadcastify.com/audio/?a=feeds&type=xml&key=123456789

Example:  - returns all audio feeds in JSON format

http://api.broadcastify.com/audio/?a=feeds&type=json&key=123456789

Example: - returns all audio feeds in the state of Texas in JSON format

http://api.broadcastify.com/audio/?a=feeds&stid=48&type=json&key=123456789

Example:  - returns the top 10 audio feeds in the country of Canada in XML format

http://api.broadcastify.com/audio/?a=feeds&coid=2&top=10&type=xml&key=123456789

countries

Returns all countries that have audio feeds

Example:  - returns all audio feeds in XML format

http://api.broadcastify.com/audio/?a=countries&type=xml&key=123456789

states

Returns all states in a country, specified with parameter "coid", that have audio feeds

Example:  - returns all states in a country with audio feeds in JSON format

http://api.broadcastify.com/audio/?a=states&coid=1&type=json&key=123456789

- WHERE: coid = country ID

counties

Returns all counties (or equivalent entity) in a state, specified with parameter "stid", that have audio feeds.

Example:  - returns all counties in a state with audio feeds in XML format

http://api.broadcastify.com/audio/?a=counties&stid=48&type=xml&key=123456789

- WHERE: stid = state ID

county

Returns all audio feeds present in a county

Example:  - returns all feeds in a county in XML format

http://api.broadcastify.com/audio/?a=county&ctid=2537&type=xml&key=123456789

- WHERE: ctid = county ID

feed

Returns details on an individual feed

Example:  - returns feed details in json format

http://api.broadcastify.com/audio/?a=feed&feedId=100&type=json&key=123456789

- WHERE: feedId = Individual Feed ID

archives

Returns all dates that a feed has archives available / or links to all archives for a specific date.  

NOTE: The username and password parameters are required and are the user's radioreference.com username and password. The user must be a premium subscriber on RadioReference.com to get access to the archive listings. You should direct customers to http://www.radioreference.com/apps/subscription for details on subscribing/upgrading.

Example:  - returns date listing in xml format

http://api.broadcastify.com/audio/?type=xml&a=archives&feedId=2211&key=123456789&u=username&p=pw

- WHERE: feedId = Individual Feed ID

Example:  - returns all archives available for that day for that feed in json format. You get back the timeframe for the archive and the download link to the archive.

http://api.broadcastify.com/audio/?type=json&a=archives&feedId=2211&day=2011-02-10&key=123456789&u=username&p=pw

- WHERE: feedId = Individual Feed ID, date = Date in YYYY-MM-DD

 

Have more questions? Submit a request

0 Comments

Article is closed for comments.
Powered by Zendesk