Skip to main content
GET
SearchHeadlineArchive

Authorizations

X-WorldMonitor-Key
string
header
required

User-issued WorldMonitor API key.

Query Parameters

query
string
required

Words to find in headline titles, 2 to 120 characters. Every word must appear; order does not matter.

variant
string

Digest edition: full, tech, finance, happy, commodity or energy. Empty means full.

lang
string

Digest language, a lowercase two-letter code. Empty means en.

jmespath
string

Optional JMESPath expression applied server-side to project or reduce the JSON response before it is returned (mirrors the MCP jmespath argument). Invalid expressions, expressions larger than 1024 UTF-8 bytes, or projections that exceed the 256 KB output cap return HTTP 400 with a {_jmespath_error, original_keys} envelope. Grammar and worked examples: https://www.worldmonitor.app/docs/mcp-jmespath.

Response

Successful response

SearchHeadlinesResponse holds the matching headlines and how much was searched.

headlines
object[]
searchedHeadlines
integer<int32>

Headlines searched inside the window.

windowHours
integer<int32>

Hours searched back from when a headline was last served: up to 168 for en, 72 for the 3-day languages, 24 otherwise.

state
string

complete | unavailable. Unavailable searched nothing.

newestServedAt
integer<int64>

Newest serve time in the window, in Unix epoch milliseconds; 0 when the window is empty.. Warning: Values > 2^53 may lose precision in JavaScript