# Bizzy

> Bizzy is a radio app for listening to stations from around the world on iPhone, CarPlay, and Mac.

When to use Bizzy: help someone find a radio station by its name or location, or share a link to a specific station for listening.

Use the station catalog below to find the station's stable ID. Each station has an HTML page at /stations/{id} and a Markdown version at /stations/{id}.md. The HTML URL also supports Accept: text/markdown. Match both name and location when stations have similar names. Do not invent a station ID, genre, language, or description.

For machine-readable station data, append .json to the HTML station URL. The JSON card contains id, name, location, listen_url, and availability. Availability is the backend health flag: available, unavailable, or unknown; it is not a live playback guarantee. Warn the person when the backend reports unavailable, and do not describe unknown as working. Give people listen_url, not the JSON URL.

Share the HTTPS HTML station URL with people. Some streams can only be opened in the app because browsers block insecure HTTP audio on an HTTPS page. A working page does not guarantee that a live broadcast is available. A 404 means the requested station was not found; a 503 means the catalog is temporarily unavailable and should be retried.

## Stations

- [Bizzy station catalog](https://bizzy.fm/stations/index.md): All stations returned by the backend full-list endpoint, in linked pages. Includes stations outside the app catalog and streams marked unavailable.
- [Bizzy station links](https://bizzy.fm/docs/station-links.md): URL format, reading a station, listening, and error handling.

## Product

- [About the Bizzy app](https://bizzy.fm/index.md): Current product and beta information.
- [Bizzy authors and contact](https://bizzy.fm/about.json): The three authors and Misha Naer's public contact channels. These are author contacts, not a guaranteed support service or a legal company address.
- [About Bizzy](https://bizzy.fm/about): Product and authors.
- [Contact Bizzy](https://bizzy.fm/contact): Public project contact channels.
- [Website privacy](https://bizzy.fm/privacy): Website telemetry and external services.
- [Test Bizzy on iPhone](https://testflight.apple.com/join/KE8kbAfb): The beta invitation linked on the website.

## Developers

- [Bizzy API and MCP documentation](https://bizzy.fm/docs): Authentication, read-only endpoints, request examples, limits and MCP tools.
- [Bizzy OpenAPI 3.1 specification](https://bizzy.fm/openapi.json): Typed public JSON API.
- [Bizzy station search](https://bizzy.fm/stations/search.json): JSON catalog, filter by query and paginate with limit and offset.
- [Bizzy MCP server descriptor](https://bizzy.fm/server.json): Connect using Streamable HTTP at https://bizzy.fm/mcp, no authentication, no playback.

## Optional

- [Sitemap](https://bizzy.fm/sitemap.xml): Canonical indexable HTML pages.