Skip to main content

Output formats

extract

FormatDescription
jsonThe raw internal representation (feed metadata + items). Default.
jsonfeedJSON Feed 1.1 document.
rssRSS 2.0 document generated with feedgen.
atomAtom 1.0 document generated with feedgen.
csvFlat table of items: title, link, pubdate, description, image, unique_id.
htmlA standalone HTML preview page rendering items as cards.
markdownA Markdown bulleted list (date, title, link per item).
yamlThe feed dictionary serialized as YAML (symmetric with the spec format).

scan

FormatDescription
jsonThe raw list of discovered feeds. Default.
rss / atomEach discovered feed becomes an entry (its title and URL).
csvFlat table: title, url, feedtype, num_entries, language, confidence.
opmlOPML 2.0 subscription list for importing feeds into readers.

Publication times in the internal feed dictionary are timezone-aware UTC datetime values. When rendering RSS/Atom they are emitted as UTC (a requirement of the feed formats). See migration notes for content_kind and enclosure rules.

Undated items keep null/empty date fields where the target format permits them and are not fabricated. See undated listings.