Blog

Posts from the ReliefWeb blog (reliefweb.int/blog) about ReliefWeb features, updates, and projects (title, author, body, tags, date).

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

Defaults

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

Profiles

Profile	Fields
`minimal`	`title`
`list`	`title`, `url`, `date.created`, `tags.name`
`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`	`date.created:desc`	`title`, `body`
`analysis`	`published`	n/a	`title`, `body`

Available fields

Name	Description	Type	Attributes
`attached_image`	Attached image shortcut - defaults to attached_image.id	integer
`attached_image.filename`	File name of the image	string
`attached_image.id`	Unique id of image used by ReliefWeb	integer	searchable
`attached_image.mimetype`	MIME type of the image	string
`attached_image.url`	Link to the original image	string
`attached_image.url-large`	Link to a large image with a width of 680px	string
`attached_image.url-small`	Link to a small image with a width of 200px	string
`attached_image.url-thumb`	Link to a thumbnail image with a maximum width of 220px and a maximum height of 100px	string
`author`	Name of blog post author	string	searchable sortable exact
`body`	Text of blog post in Markdown format	string	searchable
`body-html`	Text of blog post in HTML format	string
`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
`id`	Id for blog post used by ReliefWeb	number	searchable sortable
`image`	Image shortcut - defaults to image.id	integer
`image.caption`	Caption attached to the image	string	searchable
`image.copyright`	Copyright attached to the image	string	searchable
`image.filename`	File name of the image	string
`image.id`	Unique id of image used by ReliefWeb	integer	searchable
`image.mimetype`	MIME type of the image	string
`image.url`	Link to the original image	string
`image.url-large`	Link to a large image with a width of 680px	string
`image.url-small`	Link to a small image with a width of 200px	string
`image.url-thumb`	Link to a thumbnail image with a maximum width of 220px and a maximum height of 100px	string
`redirects`	Previous URL aliases that redirect to this item	string	searchable
`status`	Published or not	string	facetable
`tags`	Shortcut for categories applied to blog post - defaults to tags.name	string	searchable facetable exact multi common
`tags.id`	Unique id for blog post categories used by ReliefWeb	number	facetable
`tags.name`	Name of blog post categories	string	searchable facetable exact
`title`	Title of blog post	string	sortable exact
`url`	Canonical url of blog post	string
`url_alias`	Friendly' url of blog post	string
`uuid`	UUID of the document or term	string	searchable