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
Comments
0 comments
Article is closed for comments.