Broadcastify Help Center

Live Audio Feed Catalog API v 1.3 Documentation

Broadcastify Support
Broadcastify Support
  • Updated

Broadcastify Audio API Version 1.3

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

An Application key is required for access to the API.  Please contact support@broadcastify.com to request an API key.  

API Endpoint URL

  • https://api.broadcastify.com/audio/ 

Required API Parameters

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

Example:

https://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

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

Example:  - returns all audio feeds in JSON format

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

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

https://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

https://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 countries feeds in XML format

https://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

https://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

https://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

https://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

https://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 https://www.broadcastify.com/premium/ for details on subscribing/upgrading.

Example:  - returns date listing in xml format

https://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.

https://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

 

Was this article helpful?

21 out of 22 found this helpful

Have more questions? Submit a request

Comments

0 comments

Article is closed for comments.