---
title: "World newsmap for a day, ISO week or month: reports by publisher country and the most widely covered stories"
method: GET
path: "/maps/{period}.json"
---

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

`GET /maps/{period}.json`

## Request

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

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

## Path parameters

- `period` string, required

## Response `200`

hottub-news/newsmap/v1

- Newsmap: hottub-news/newsmap/v1. Reports are placed in their publisher's country, not where events happened; paid placements are never included.
  - `schema` 'hottub-news/newsmap/v1', required
  - `period` string, required
  - `period_kind` 'day' | 'week' | 'month'
  - `label` string
  - `region` string, required
  - `region_name` string
  - `start` string, date-time
  - `end` string, date-time: Exclusive
  - `status` 'final' | 'live', required
  - `computed_at` string, date-time
  - `measure` string
  - `items` integer, required: Reports from outlets in the region's countries
  - `unplaced` integer: World only: reports whose publisher country is unknown
  - `missing_days` integer
  - `countries` object[], required
    - `code` string: ISO 3166-1 alpha-2
    - `name` string
    - `items` integer
  - `stories` object[], required
    - `story` string
    - `title` string
    - `title_en` string
    - `lang` string
    - `url` string, uri
    - `teaser` string
    - `source` string
    - `source_country` string
    - `outlets` integer: Distinct outlets in the region (weeks/months: on its biggest day)
    - `reports` integer
    - `outlet_days` integer: Ranking weight: sum over days of distinct outlets
    - `countries` string[]
  - `links` object: page, svg, png, md, json, prev, next
  - `thin` boolean: Too little coverage to index
  - `alt` string: Alt text for the map image

## Other responses

- `404`: Error with a fix-it message

---

[API](https://skmtc.dev/hottub/apis/hottub-news.md) · [All operations](https://skmtc.dev/hottub/apis/hottub-news/llms.txt) · [OpenAPI document](https://skmtc.dev/hottub/apis/hottub-news/revisions/cf50ab224171?raw)