Collector for DR and Bauer airplay; data sources and modelling plan

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-11-15 00:42:05 +00:00
co-authored by Claude Opus 5.5
commit 6e4d2f1585
13 changed files with 2329 additions and 0 deletions
+47
View File
@@ -0,0 +1,47 @@
# Data sources
Found on 2026-11-15. All of these sources are public and need no login or API key. The collector
identifies itself and waits between requests.
**The big constraint:** every source of exact plays keeps only **about 7 days**. History only
exists from the day collection starts, so the collector runs every 6 hours.
## DR (P3, P4 regions, P5, P6 Beat, P8 Jazz)
DR's pages are Next.js. Each page's data is the JSON in `<script id="__NEXT_DATA__">` under
`props.pageProps`. (`api.dr.dk` needs an API key that isn't in the public pages, so it isn't used.)
| What | URL | Gives |
|---|---|---|
| A day's programmes | `/playlister/{channel}/{YYYY-MM-DD}` | `schedule.items[]`: `slug`, `title`, `startTime`, `endTime` (UTC) |
| A programme's plays | `/playlister/{channel}/{date}/{slug}` | `playlistIndexPoints[]`: `playedTime` (with offset), `title`, `durationMilliseconds`, `trackUrn`, `roles[]` (`artistUrn`, `name`, `role`; the main artist is `Hovedkunstner`) |
| An artist | `/lyd/musik/kunstner/{id}` (the slug is optional) | `weekPlaySums[]`: **52 weeks** of plays per channel; `mostPlayed[]`: all-time plays per track per channel; `latestPlayed[]`: the last 20 plays |
| Rotation lists | linked weekly from `dr.dk/rotationer` (`asset.dr.dk/.../DD-MM-YYYY-dr-rotationer.pdf`) | per channel, the songs in each rotation category A / B / C for the coming week |
- **Channels:** `p3`, `p4kbh`, `p4sjaelland`, `p4fyn`, `p4syd`, `p4trekanten`, `p4vest`, `p4aarhus`, `p4nord`, `p4bornholm`, `p4esbjerg`, `p5`, `p6beat`, `p8jazz`. The national `p4` page exists too, but its plays come from the regions.
- **Window:** dates older than about 7 days give 404.
- **Artist pages:** they give a year of weekly history the moment an artist is discovered. This is the only long history available.
- **Rotation PDF:**
- Text is extractable: categories as headings, then artist and title on the same line.
- Pages 0–2 and 11 hold the lists; the others are graphics.
- The channel names aren't in the text (probably logos), so mapping pages to channels is still to do.
- Only the current PDF is linked, and its URL changes weekly, so old weeks can't be fetched later.
## Bauer Media Denmark (NOVA, Radio Soft, The Voice, Pop FM, Radio 100, + web stations)
Radioplay became Rayo (`rayo.dk`). It uses Bauer's international API:
| What | URL | Gives |
|---|---|---|
| Stations | `https://listenapi.planetradio.co.uk/api9.2/stations/DK` | `stationCode`, `stationName` (about 80, many web-only) |
| Plays | `.../api9.2/events/{code}/{YYYY-MM-DD HH:MM:SS}/{n}` | the `n` (≤ 100) plays before that time, newest first: `nowPlayingTime` (Danish local time), `nowPlayingArtist`, `nowPlayingTrack`, `nowPlayingTrackId`, `nowPlayingDuration` (seconds) |
| Now playing | `.../api9.2/nowplaying/{code}` | the current event |
- **Codes:** NOVA `nov`, Radio Soft `dso`, The Voice `the`, Pop FM `pop`, Radio 100 `rhu`.
- **Errors:** older than about 7 days gives HTTP 200 with `["invalid date"]`; `n` > 100 gives `["invalid limit"]`.
- **Artists:** one string, featured artists included (`"Eminem ft. Rihanna"`), with no artist ids. Normalising names is part of the modelling work.
- **Why Bauer matters:** it records every play, including songs outside any published rotation list, and the same API serves Bauer's stations in other countries.
## Station ranking (Kantar)
The four biggest Danish stations for music are DR P4, DR P3, NOVA and Radio Soft; DR P4 is split into 10 regional channels. The collector covers all four, plus the other DR music channels and Bauer's other Danish stations.