API reference

Read your own keywords and alerts from your own tools. The API is part of the Business plan. Machine-readable description: openapi.json.

Authentication

Create a personal key in Settings of your account. It is shown once. Send it with every request:

Authorization: Bearer YOUR_KEY

Keep the key private. If it leaks, create a new one in Settings and the old one stops working. Requests without a valid key get 401. A key on a plan without the API gets 403.

GET /api/v1/keywords

Every keyword you track, with its overall state and the latest numbers from each source.

curl -H "Authorization: Bearer YOUR_KEY" https://gatrends.com/api/v1/keywords

{"keywords":[{"name":"GTA 6","state":"spike","sources":{"news":{"now":54,"usual":3,"change_pct":1700,"state":"spike","checked_at":"2026-11-10T22:10:00.000Z"}}}]}

State is waiting, learning, normal, rising or spike. The example is illustrative.

GET /api/v1/alerts

Recent alerts, newest first.

• hours: how many recent hours to cover, 1 to 720. Default 72.
• keyword: only alerts whose keyword contains this text.
• limit: 1 to 200. Default 30.

curl -H "Authorization: Bearer YOUR_KEY" "https://gatrends.com/api/v1/alerts?hours=24&limit=10"

{"alerts":[{"time":"2026-11-10T22:13:00.000Z","keyword":"gta 6","source":"news","change_pct":1700,"title":"GTA 6: news coverage +1700%","note":"Usually about 3 articles","links":[]}]}

Source is one of news, hn, wiki, steam, trends, gh, ph.

Webhook

Business plans can also receive each alert at an HTTPS address. Requests carry an X-GAtrends-Signature header, an HMAC-SHA256 of the body. Set it up in Settings.

Claude, ChatGPT and other MCP clients

Pro and Business plans can connect Claude or ChatGPT with a personal connector address. See Connect.

Questions: support@gatrends.com