Topics

Curated editorial topic pages (reliefweb.int/topics) with title, introduction, overview, resources, rivers, theme, and disaster_type.

Endpoint: POST or GET https://api.reliefweb.int/v2/topics
Single topic: GET https://api.reliefweb.int/v2/topics/{id|uuid}

Defaults

Requests to /v2/topics default to profile=minimal and preset=minimal. Single-record requests (/v2/topics/{id}) default to profile=default and preset=minimal. See Choose fields and presets.

Profiles

Profile	Fields
`minimal`	`title`
`list`	`title`, `url`, `date.created`, `icon.url`
`full`	All fields
`default`	All fields

Add more with fields.include.

Presets

Preset	Status filter	Sort	Default query fields
`minimal`	`published`	n/a	`title`
`latest`	`published`	n/a	`title`, `introduction`, `overview`, `resources`, `theme`, `disater_type`
`analysis`	`published`	n/a	`title`, `introduction`, `overview`, `resources`, `theme`, `disater_type`

Available fields

Name	Description	Type	Attributes
`date`	Shortcut for date - defaults to date.created	object	facetable
`date.changed`	Date entry modified on ReliefWeb (ISO 8601)	date	sortable facetable
`date.created`	Date entry created on ReliefWeb (ISO 8601)	date	sortable facetable
`disaster_type`	Shortcut for disaster type - defaults to disaster_type.name	string	searchable facetable exact multi common
`disaster_type.code`	GLIDE hazard code for disaster type.	string	searchable facetable
`disaster_type.id`	Id for disaster type used by ReliefWeb	integer	searchable facetable
`disaster_type.name`	Link for values	string	searchable facetable exact
`featured`	Flag indicating the item is featured	boolean	searchable sortable facetable
`icon`	Shortcut for icon - defaults to icon.url	object
`icon.filename`	Filename of icon	integer	searchable
`icon.filesize`	Size of icon file in bytes	integer	searchable
`icon.height`	Height of icon in pixels	integer	searchable
`icon.id`	Id of icon	integer	searchable
`icon.mimetype`	MIME type of icon	string	searchable
`icon.url`	URL of icon image	string	searchable
`icon.width`	Width of icon in pixels	integer	searchable
`id`	Unique id of page used by ReliefWeb	number	searchable sortable
`introduction`	Introduction text in Markdown format	string	searchable
`introduction-html`	Introduction text in HTML format	string
`overview`	Overview text in Markdown format	string	searchable
`overview-html`	Overview text in HTML format	string
`redirects`	Previous URL aliases that redirect to this item	string	searchable
`resources`	Resources section in Markdown format	string	searchable
`resources-html`	Resources section in HTML format	string
`rivers`	Associated content rivers	array	multi
`rivers.id`	Id of river	string	searchable
`rivers.override`	Override flag for river	integer	searchable
`rivers.title`	Title of river	string	searchable
`rivers.url`	URL of river	string	searchable
`status`	Published or not	string	facetable
`theme`	Shortcut for theme - defaults to theme.name	string	searchable facetable exact multi common
`theme.id`	Id of theme used by ReliefWeb	integer	searchable facetable
`theme.name`	Link for values	string	searchable facetable exact
`title`	Title of page	string	sortable exact
`url`	Canonical url of the page	string
`url_alias`	Friendly' url of page	string
`uuid`	UUID of the document or term	string	searchable