World newsmap for a day, ISO week or month: reports by publisher country and the most widely covered stories

Also /maps/{period}.svg (map), .png (1200×630 card), .md, and the HTML page /maps/{period}. Final periods are immutable.

get/maps/{period}.json

Request

  • Base URL: https://hottub.news
  • URL: https://hottub.news/maps/{period}.json
  • Auth: none declared

Path parameters

periodstring required

2026-10-17 (UTC day), 2026-w42 (ISO week) or 2026-10 (month)

Response

hottub-news/newsmap/v1

schema'hottub-news/newsmap/v1' required
periodstring required
period_kind'day' | 'week' | 'month'
labelstring
regionstring required
region_namestring
startstring date-time
endstring date-time

Exclusive

status'final' | 'live' required
computed_atstring date-time
measurestring
itemsinteger required

Reports from outlets in the region's countries

unplacedinteger

World only: reports whose publisher country is unknown

missing_daysinteger
linksobject

page, svg, png, md, json, prev, next

thinboolean

Too little coverage to index

altstring

Alt text for the map image

Changes

No recorded changes to this operation across all 1 revision of this API.