Podcast Download Redirect

Download-tracking redirect for podcast <enclosure> URLs — the attribution seam for Apple/Spotify/Overcast plays.

Podcast apps GET this endpoint (it's the enclosure URL), we record the download, then 302 to the real audio host (the app follows it and still counts the download). Emits a structured podcast_download log line keyed by episode + privacy-safe IP hash so listens are countable (dedupe by (key, ip) for IAB-style unique downloads — analytics fast-follow).

HEAD is registered alongside GET (2026-07-15 incident): YouTube/Apple HEAD-probe enclosure URLs before ingesting; a 405 reads as "could not fetch the audio file" and the episode is rejected. HEAD returns the identical 302 + Location (the redirect target — audio.storyflo.com CloudFront — itself serves HEAD, verified 200 audio/mpeg) but does NOT emit the podcast_download line: a probe is not a listen.

Open-redirect-guarded: only *.r2.dev / *.storyflo.com audio hosts are honored; anything else is a 400.

get/v1/podcasts/dl

Request

  • Base URL: https://api.storyflo.com (the document declares no server; this is the origin it was published from)
  • URL: https://api.storyflo.com/v1/podcasts/dl
  • Auth: none declared

Query parameters

ustring required

Response

Successful Response

unknown required

Changes

No recorded changes to this operation across all 1 revision of this API.