Skip to content
HALOWERK

Tonwerk

episode topic map

Takes 2-300 episodes inline or from an RSS feed (title plus description, content:encoded or itunes:summary, HTML removed). Tokens are lower-cased words of at least three letters without German and English Snowball stop words; plural and inflection variants are folded onto the shortest form present in the corpus (s, e, n, en, es, er endings; own rule), adjacent content words also form bigrams. Weights are sublinear TF-IDF (1+ln tf, smooth idf). Topics are terms that occur in at least.

POST https://ton.halowerk.com/v1/episode-topic-map

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).
episodesarrayNo
top_termsintegerNo
max_topicsintegerNo
min_episodesintegerNoMinimum number of episodes that share a topic term.
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": "array",
      "minItems": 2,
      "maxItems": 300,
      "items": {
        "type": "object",
        "additionalProperties": false,
        "required": [
          "title"
        ],
        "properties": {
          "id": {
            "type": "string",
            "maxLength": 300
          },
          "title": {
            "type": "string",
            "minLength": 1,
            "maxLength": 500
          },
          "text": {
            "type": "string",
            "maxLength": 200000,
            "description": "Show notes or transcript text."
          },
          "date": {
            "type": "string",
            "maxLength": 60
          }
        }
      }
    },
    "top_terms": {
      "type": "integer",
      "minimum": 3,
      "maximum": 15,
      "default": 8
    },
    "max_topics": {
      "type": "integer",
      "minimum": 2,
      "maximum": 40,
      "default": 12
    },
    "min_episodes": {
      "type": "integer",
      "minimum": 2,
      "maximum": 20,
      "default": 2,
      "description": "Minimum number of episodes that share a topic term."
    }
  }
}

Open original schema

Published input example

{
  "feed_url": "https://podnews.net/rss",
  "max_topics": 10
}

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 โ†’