Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we
store it to create your key and to recognise you if you sign in with another
provider. See our Privacy Policy and
Terms.
openapi: 3.2.0
info:
title: Geotone Briefings API
version: 1.0.0
summary: Live media-intelligence signals derived from global news coverage
description: 'Read-only JSON mirrors of every Geotone dashboard: coverage volume, tone, surge z-scores, and article samples for 40 geopolitical topics and 196 countries. Derived data is CC BY 4.0 — attribute ''Geotone / GDELT''. Endpoints mirror pages one-to-one; there are intentionally no bulk-export routes. Rate limit: 60 uncached requests/minute/IP (cached responses are unlimited).'
license:
name: CC BY 4.0
url: https://creativecommons.org/licenses/by/4.0/
contact:
email: contact@geotone.news
url: https://geotone.news/about
servers:
- url: https://geotone.news
tags:
- name: Briefings
paths:
/api/v1/briefings/{date}:
get:
operationId: getBriefing
summary: Daily briefings for a date (publishing begins in a later release)
parameters:
- name: date
in: path
required: true
schema:
type: string
format: date
example: '2026-07-02'
responses:
'200':
description: Briefings for the date
'404':
description: No briefing for that date
tags:
- Briefings