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.