Feed Standard

A blog-like content feed. Each entry is a self-contained item that can be displayed, syndicated, or stored independently.

Feed Object

A feed is a collection of entries with metadata about the source.

{
	$standard: 'feed',
	$version: 1,
	$title: 'My Tech Blog',
	$description: 'Notes on software and systems',
	$url: 'https://example.com/feed',
	$language: 'en',
	$icon: 'https://example.com/icon.svg',
	$updated: '2026-03-29 14:00:00',
	$entries: [ ... ]
}

Entry Object

Each entry in the feed. The $type determines how a WorldAPI browser renders it.

{
	$type: 'description',
	$title: 'Introduction to APIs',
	$summary: 'An application programming interface is a connection between computers or between computer programs.',
	$body: 'Full article content here. Supports plain text or HTML.',
	$author: {
		$name: 'Jane Doe',
		$url: 'https://example.com/jane',
		$avatar: 'https://example.com/jane.webp'
	},
	$created: '2026-01-15 12:07:58',
	$updated: '2026-01-16 17:15:36',
	$url: 'https://example.com/posts/intro-to-apis',
	$image: 'https://example.com/cover.webp',
	$taxonomy: ['Development', 'API'],
	$attachments: [
		{
			$url: 'https://example.com/slides.pdf',
			$mime: 'application/pdf',
			$size: 2048000,
			$title: 'Presentation Slides'
		}
	]
}

Entry Types

$type	Use case
information	Factual, objective content (news, data)
description	Explanatory content (articles, essays)
instruction	How-to content (tutorials, recipes, manuals)
opinion	Subjective content (reviews, editorials)
media	Primarily image, video, or audio content
link	Curated link with commentary

Standard Properties

Property	Type	Required	Description
$standard	string	yes	Always 'feed'
$version	number	yes	Standard version
$title	string	yes	Feed or entry title
$description	string	no	Feed description
$body	string	no	Full entry content
$summary	string	no	Short excerpt
$author	object	no	Author with $name, $url, $avatar
$created	string	yes	UTC datetime
$updated	string	no	UTC datetime of last edit
$url	string	yes	Canonical URL
$image	string	no	Cover image URL
$taxonomy	array	no	Categories/tags
$attachments	array	no	Files attached to entry
$language	string	no	ISO 639-1 language code
$icon	string	no	Feed icon URL
$entries	array	yes	Array of entry objects