fmstream.org - API access

The database can be accessed free-of-charge for non-commercial use. If you agree to the conditions, you can obtain limited query results in JSON format. It is only intended for solutions which are not covered by the browser based front-end which fmstream.org already provides.

Conditions - Apply for a key - Parameters

Conditions

• Your project must be 100% non-commercial. No monetizing, no ads, no fees, no user tracking.
• You take full responsibility for any legal matter. This includes copyright issues and the fact that the fmstream database contains errors. You confirm with your name, address and signature that fmstream is not liable for anything.
• You make anyone aware using your application that some streams are still assigned to wrong stations. Styles, brandings, frequencies, descriptions and slogans can also be incorrect. fmstream is still experimental.
• You name fmstream.org as data source and link to it clearly visible from the main screen.
• You confirm that you will not collect data from fmstream (stream URLs, bitrates etc) in order to store it or aggregate it in your own database.
• You agree that API functionality can change or stop working without announcement. Nevertheless, I will try to inform users about significant changes.
• You use everything on an as-is basis.
• Access can be blocked intentionally without further explanation.
• You may not hand out the key to anyone else.

Apply for a key

Send me an e-mail and describe your project. I will ask you to sign the conditions and give your full name and address and monitor the number of queries. The key is dynamic.

Parameters

The API uses the same GET parameters as the fmstream.org/index.php main site. The only difference is that the output will be in JSON format and contain a few limitations. All parameters are optional. Without parameters you get the featured stations list. Combinations that do not make sense are blocked.

GET query

c

• Country code in ITU format. Example: c=ALS for Alaska. Often political countries, but sometimes regions geographically remote from the mainland or with a special status.
• c=FT The featured stations list
• c=RD Random stations

hq

High audio quality with values 0 or 1 will order the streams of any station with low/high bitrates first.

l

Language in ISO-code (2 letters).

n

numerical offset starts output with station #n (skips n entries).

o

Is a mixture of offset and order and can be combined with n

• top order from big to small stations. The ranking depends on an internal score of the number and power of FM/AM transmitters. A few recommended stations have a special bonus.
• big filter for the big stations, ordered alphabetically. big/med/sma are used best in combination with a country or style.
• med only medium size stations, ordered alphabetically.
• sma only small stations, ordered alphabetically.
• anything else will order alphabetically and start the output with the given letter or string

s

search looks for matches in an internal search string that contains program, style, branding, frequency, country (real name, not ITU). Not case sensitive. Spaces (multiple words) are interpreted as logical OR. Search for consecutive words without spaces ('radiolondon' for Radio London).

style

The station's format or genre. Any search input is valid. Matches with the first registered style of a station are preferred: A search for "rock" will first show stations that play "rock" only.

back