Skip to main content
Developer API

Towerblock Radio
Public API

Access real-time now-playing data, DJ schedules, artist profiles, the pirate radio heritage archive, events and recorded sets. Built for music discovery apps, researchers, journalists and cultural institutions.

Quick Start

  1. 1. Request an API key using the form below.
  2. 2. Wait for approval (usually within 48 hours).
  3. 3. Make requests with your key and an endpoint name.

Example: cURL

curl -X POST https://base44.com/api/apps/public/functions/publicApi \
  -H "Content-Type: application/json" \
  -d '{"api_key":"tbk_yourkey","endpoint":"now-playing"}'

Example: JavaScript

const res = await fetch("https://base44.com/api/apps/public/functions/publicApi", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    api_key: "tbk_yourkey",
    endpoint: "track-history",
    limit: 10
  })
});
const { data } = await res.json();
console.log(data.tracks);

Authentication

Every request must include your api_key parameter. Keys are prefixed with tbk_. Keys must be approved before they return data. To get a key, use the request form at the bottom of this page.

Endpoints

GETnow-playing

Get the track currently or most recently playing on Towerblock Radio.

// Request
{
  "api_key": "tbk_yourkey",
  "endpoint": "now-playing"
}

// Response
{
  "data": { ... },
  "endpoint": "now-playing",
  "timestamp": "2026-07-15T14:00:00.000Z"
}
GETtrack-history

Recent track play history with timestamps and artwork.

Parameters
limit (number) - Results to return (1-100, default 50)
// Request
{
  "api_key": "tbk_yourkey",
  "endpoint": "track-history",
  "limit": 10
}

// Response
{
  "data": { ... },
  "endpoint": "track-history",
  "timestamp": "2026-07-15T14:00:00.000Z"
}
GETschedule

Upcoming and recurring DJ shows on the station.

Parameters
limit (number) - Results to return (1-100, default 50)
// Request
{
  "api_key": "tbk_yourkey",
  "endpoint": "schedule",
  "limit": 20
}

// Response
{
  "data": { ... },
  "endpoint": "schedule",
  "timestamp": "2026-07-15T14:00:00.000Z"
}
GETartists

Approved DJ and artist profiles with bios, genres and social links.

Parameters
limit (number) - Results to return (1-100, default 50)
// Request
{
  "api_key": "tbk_yourkey",
  "endpoint": "artists",
  "limit": 50
}

// Response
{
  "data": { ... },
  "endpoint": "artists",
  "timestamp": "2026-07-15T14:00:00.000Z"
}
GETarchive

Recorded DJ sets and radio sessions from the archive.

Parameters
limit (number) - Results to return (1-100, default 50)
// Request
{
  "api_key": "tbk_yourkey",
  "endpoint": "archive",
  "limit": 20
}

// Response
{
  "data": { ... },
  "endpoint": "archive",
  "timestamp": "2026-07-15T14:00:00.000Z"
}
GETevents

Upcoming Towerblock Radio events and broadcasts.

Parameters
limit (number) - Results to return (1-100, default 50)
// Request
{
  "api_key": "tbk_yourkey",
  "endpoint": "events",
  "limit": 20
}

// Response
{
  "data": { ... },
  "endpoint": "events",
  "timestamp": "2026-07-15T14:00:00.000Z"
}
GETheritage/stations

Pirate radio station records from the Heritage archive.

Parameters
limit (number) - Results to return (1-100, default 50)
// Request
{
  "api_key": "tbk_yourkey",
  "endpoint": "heritage/stations",
  "limit": 50
}

// Response
{
  "data": { ... },
  "endpoint": "heritage/stations",
  "timestamp": "2026-07-15T14:00:00.000Z"
}
GETheritage/people

Pioneers, DJs and founders from the Heritage archive.

Parameters
limit (number) - Results to return (1-100, default 50)
// Request
{
  "api_key": "tbk_yourkey",
  "endpoint": "heritage/people",
  "limit": 50
}

// Response
{
  "data": { ... },
  "endpoint": "heritage/people",
  "timestamp": "2026-07-15T14:00:00.000Z"
}
GETheritage/timeline

Cultural timeline events from UK pirate radio history.

Parameters
limit (number) - Results to return (1-100, default 50)
// Request
{
  "api_key": "tbk_yourkey",
  "endpoint": "heritage/timeline",
  "limit": 50
}

// Response
{
  "data": { ... },
  "endpoint": "heritage/timeline",
  "timestamp": "2026-07-15T14:00:00.000Z"
}
GETheritage/genres

Genre entries with connected cultural histories.

Parameters
limit (number) - Results to return (1-100, default 50)
// Request
{
  "api_key": "tbk_yourkey",
  "endpoint": "heritage/genres",
  "limit": 50
}

// Response
{
  "data": { ... },
  "endpoint": "heritage/genres",
  "timestamp": "2026-07-15T14:00:00.000Z"
}

Rate Limits & Terms

Rate Limits

Default: 100 requests per hour. Higher limits available on request for research or institutional use.

Usage Terms

Attribute Towerblock Radio as the data source. Do not redistribute raw API dumps. Heritage archive data is for research and educational use.

Get Your API Key

Request access to the Towerblock Radio API.

Request an API Key

Fill in your details and we will review your request.

Current broadcast artwork

Slimzee with Maxwell D, Plague / Pay As U Go Cartel @Blazein - Amsterdam

ON AIR