Skip to content
HALOWERK

Tonwerk

opml normalize

Parses OPML 1.0/1.1/2.0 and applies the OPML 2.0 rules (opml.org/spec2, freely implementable): version, head and body required, every outline needs a text attribute, rss outlines need type, text and xmlUrl, type values are case-insensitive. Missing text is filled from title or the feed host, missing type on outlines with xmlUrl becomes rss, attribute spelling such as xmlurl is corrected, invalid or non-http(s) feed URLs are flagged (optionally dropped) and exact duplicates (scheme and host.

POST https://ton.halowerk.com/v1/opml-normalize

Inputs

Fields of the published input schema
FieldTypeRequiredDescription
opmlstringYesOPML document.
flattenbooleanNoPut all feeds directly into body and keep the folder as category.
sortstringNo
dedupebooleanNo
drop_invalidbooleanNoRemove feed outlines whose xmlUrl is not a valid http(s) URL.
titlestringNoNew head title.
Show full input schema
{
  "type": "object",
  "additionalProperties": false,
  "required": [
    "opml"
  ],
  "properties": {
    "opml": {
      "type": "string",
      "minLength": 10,
      "maxLength": 5000000,
      "description": "OPML document."
    },
    "flatten": {
      "type": "boolean",
      "default": false,
      "description": "Put all feeds directly into body and keep the folder as category."
    },
    "sort": {
      "type": "string",
      "enum": [
        "none",
        "title",
        "url"
      ],
      "default": "none"
    },
    "dedupe": {
      "type": "boolean",
      "default": true
    },
    "drop_invalid": {
      "type": "boolean",
      "default": false,
      "description": "Remove feed outlines whose xmlUrl is not a valid http(s) URL."
    },
    "title": {
      "type": "string",
      "maxLength": 200,
      "description": "New head title."
    }
  }
}

Open original schema

Published input example

{
  "opml": "<?xml version=\"1.0\"?><opml version=\"1.0\"><head><title>Abos</title></head><body><outline text=\"Podnews\" xmlUrl=\"https://podnews.net/rss\"/></body></opml>",
  "sort": "title"
}

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