API v1.0 — LIVE

Build on GripNews
Intelligence

28+ endpoints for game intelligence, friction analysis, device optimization, signal ingestion and real-time webhooks. Get your API key in seconds.

# Register for an API key
$ curl -X POST https://api.gripnews.uk/v1/auth/register \
  -d '{"owner_email":"you@example.com"}'

# Check platform status
$ curl https://api.gripnews.uk/v1/status
{ "status": "active", "version": "1.0.0", "total_api_keys": 1 }
28+
API Endpoints
v1.0
Stable Release
REST
JSON API
99.9%
Uptime Target

Everything you need to integrate.

Production-ready features out of the box.

🔐

API Key Auth

Register, rotate and revoke keys instantly. Scoped permissions with enterprise tiers.

Rate Limiting

Tiered rate limits: Free (60/hr), Pro (600/hr), Enterprise (6000/hr).

🔔

Webhooks

Subscribe to real-time events. HMAC-signed payloads with automatic retry.

🎮

Game Registry

500+ games with fuzzy search, aliases, platform data and trend tracking.

📊

Confidence Scores

Every response includes a confidence score so you know how much to trust the data.

🛡️

HMAC Signatures

Webhook payloads are signed with your secret. Verify integrity on every delivery.

Powerful endpoints, simple integration.

From health checks to full signal ingestion — everything you need.

GET

Platform Status

/v1/status

Live platform health, active incidents, total signals, API key count and webhook stats.

Public
GET

Live Hotspots

/v1/live/hotspots

Real-time friction hotspots ranked by PSI score with severity, decay and heat levels.

Public
POST

Friction Scan

/v1/friction/scan

Analyse a game issue — returns friction score, category, probable causes and recommended fixes.

API Key
POST

Solve

/v1/solve

Match a problem to verified solutions with confidence scores and estimated fix time.

API Key
POST

Device Optimize

/v1/device/optimize

Get optimal settings for Steam Deck, ROG Ally, PS5, Xbox and more — per game.

API Key
POST

Signal Ingest

/v1/events/ingest

Push structured signal data with source confidence, metrics and context. Triggers webhooks on high PSI.

API Key + Scope
GET

Game Registry

/v1/games

Search, list and filter games by genre, platform, tracking status. Full CRUD for admins.

Public
GET

Trending Games

/v1/games/trending

Top games ranked by signal volume and PSI with real-time trend direction.

Public
POST

Webhooks

/v1/webhooks

Subscribe to events like hotspot.created and psi.spike. Test, list and manage deliveries.

API Key + Scope

Up and running in 3 steps.

1

Register

POST your email to /v1/auth/register and get your API key instantly. No sign-up forms.

2

Authenticate

Add X-API-Key: your_key to every request. That's it — no OAuth, no tokens.

3

Build

Call any endpoint. Get JSON responses with confidence scores, PSI data and actionable intelligence.

cURL
JavaScript
Python
# 1. Get your API key $ curl -X POST https://api.gripnews.uk/v1/auth/register \ -H "Content-Type: application/json" \ -d '{"owner_email":"dev@yourapp.com"}' # 2. Scan for friction $ curl -X POST https://api.gripnews.uk/v1/friction/scan \ -H "X-API-Key: grip_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"game":"warzone","issue":"lag spikes in ranked"}' # 3. Get device settings $ curl -X POST https://api.gripnews.uk/v1/device/optimize \ -H "X-API-Key: grip_YOUR_KEY" \ -H "Content-Type: application/json" \ -d '{"device":"steam_deck_oled","game":"elden-ring","priority":"balanced"}'

Start free. Scale when you're ready.

Every tier includes full API access. Upgrade for higher limits and priority support.

Free

£0
forever
  • 60 requests / hour
  • All public endpoints
  • API key auth
  • Community support
  • Basic scopes
Get Free Key

Enterprise

£199
per month
  • 6000 requests / hour
  • Full admin access
  • Bulk CSV import
  • Dedicated support
  • Custom integrations
Contact Sales

Ready to build?

Register your API key with a single POST request. No sign-up forms, no credit card. Start building in seconds.

$ curl -X POST https://api.gripnews.uk/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"owner_email":"you@example.com"}'

# Response:
{ "api_key": "grip_YOUR_SECRET_KEY..." }
← Back to GripNews