Skip to content
HALOWERK

Tonwerk

feed loudness series

Feed mode: takes the newest 1-4 episodes of an RSS feed and fetches only a byte range of each enclosure (by default from the middle of MP3 files, from the start for other containers; large ID3 tags are skipped), so every value is an honest sample measurement, not the loudness of the whole episode. Clip mode: measures 2-6 supplied audio files completely. Each sample is measured with ffmpeg 6.1 ebur128 (integrated loudness with BS.1770 gating, loudness range, true peak with oversampling,.

POST https://ton.halowerk.com/v1/feed-loudness-series

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
feed_xmlstringNoRSS 2.0 feed as XML text (alternative to feed_url).
feed_urlstringNoPublic http(s) URL of the RSS feed; fetched when feed_xml is absent (at most 8 MB).
episodesintegerNoNumber of newest episodes to sample (feed mode).
sample_secondsintegerNoApproximate length of each sample in seconds (feed mode).
positionstringNoWhere to take the sample from (middle only for MP3).
clipsarrayNoAlternative to a feed: complete audio clips to compare (together at most 14 MB of base64).
targetstringNoauto: -19 LUFS for mono files, -16 LUFS otherwise.
tolerance_lunumberNoAllowed deviation from the target (Apple: ±1 dB).
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "feed_xml": {
      "type": "string",
      "minLength": 20,
      "maxLength": 8000000,
      "description": "RSS 2.0 feed as XML text (alternative to feed_url)."
    },
    "feed_url": {
      "type": "string",
      "format": "uri",
      "maxLength": 2048,
      "description": "Public http(s) URL of the RSS feed; fetched when feed_xml is absent (at most 8 MB)."
    },
    "episodes": {
      "type": "integer",
      "minimum": 1,
      "maximum": 4,
      "default": 3,
      "description": "Number of newest episodes to sample (feed mode)."
    },
    "sample_seconds": {
      "type": "integer",
      "minimum": 20,
      "maximum": 120,
      "default": 60,
      "description": "Approximate length of each sample in seconds (feed mode)."
    },
    "position": {
      "type": "string",
      "enum": [
        "middle",
        "start"
      ],
      "default": "middle",
      "description": "Where to take the sample from (middle only for MP3)."
    },
    "clips": {
      "type": "array",
      "minItems": 2,
      "maxItems": 6,
      "description": "Alternative to a feed: complete audio clips to compare (together at most 14 MB of base64).",
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "audio_base64"
        ],
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 200
          },
          "audio_base64": {
            "type": "string",
            "minLength": 16,
            "maxLength": 14000000
          }
        }
      }
    },
    "target": {
      "type": "string",
      "enum": [
        "auto",
        "stereo",
        "mono"
      ],
      "default": "auto",
      "description": "auto: -19 LUFS for mono files, -16 LUFS otherwise."
    },
    "tolerance_lu": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 3,
      "default": 1,
      "description": "Allowed deviation from the target (Apple: ±1 dB)."
    }
  }
}

Open original schema

Published input example

{
  "feed_url": "https://podnews.net/rss",
  "episodes": 3,
  "sample_seconds": 60
}

Result & documentation

Machine-readable documentation of this hub

Source of this page: the published HALOWERK catalog. Updated: 2026-11-17 UTC.

More endpoints in this hub

All endpoints in this hub →