Historical Global Macro Sentiment Indices (GMSI) Headlines by Country

Returns paginated historical headlines for the Global Macro Sentiment Indices (GMSI) dataset for a given country and topic over a date range (up to 90 days), including per-headline directional and semantic sentiment scores. Use match_type to filter by domestic or international coverage, or return both with COMBINED. Pass the next_token from each response into the next request to page through results. Get valid country codes from GET /countries (browse all) or GET /countries/search (search by name). Get valid topics from GET /headlines/topics/gmsi.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

ISO-2 country code. Browse all via GET /countries or search by name via GET /countries/search.

Query Params
string

Topic name to filter by. Get valid topics from GET /headlines/topics/gmsi.

string
enum
Defaults to COMBINED

Headline coverage scope. DOMESTIC includes only domestic coverage, INTERNATIONAL only foreign coverage, COMBINED includes both.

Allowed:
integer
1 to 1000
Defaults to 100

Maximum number of records per page.

Start date for the time range filter (YYYY-MM-DD format). If not provided, defaults to 7 days ago.

Pagination cursor from previous response. Use this to continue pagination within the same time range.

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json