API Reference - PatchPulse Docs

Real-time Game Update Intelligence

Endpoints

Access structured patch data for over 4,200 titles across Steam, Epic, GOG, and console ecosystems. All responses are delivered in strict JSON format with ISO 8601 timestamps and semantic versioning.

GET /v1/patches

Retrieve Patch Feed

Fetch paginated patch notes with filtering by platform, genre, or release window. Supports cursor-based pagination for high-throughput integrations.

{
  "data": [
    {
      "id": "pp_8f3a9c2d",
      "game_slug": "cyber-drift-2077",
      "version": "1.4.2",
      "platform": "pc_steam",
      "published_at": "2024-05-12T08:30:00Z",
      "summary": "Performance optimization and ray-tracing fixes",
      "changelog_url": "https://cdn.patchpulse.io/logs/8f3a9c2d.json"
    }
  ],
  "meta": { "next_cursor": "eyJpZCI6ImZhbGwifQ==" }
}

GET /v1/games/{slug}/latest

Single Game Snapshot

Pull the most recent patch payload for a specific title. Returns full metadata, affected systems, and developer notes. Ideal for dashboard widgets and alert triggers.

{
  "game": "stellar-colonies",
  "latest_patch": {
    "id": "pp_7b2e1a9f",
    "version": "2.1.0",
    "size_mb": 48.2,
    "release_type": "major",
    "tags": ["multiplayer", "ui_overhaul", "balance"],
    "published_at": "2024-05-10T14:00:00Z"
  }
}

GET /v1/changes/{patch_id}

Granular Changelog

Retrieve parsed, categorized change entries. PatchPulse's NLP engine structures raw markdown/text into standardized JSON objects with sentiment and impact scoring.

{
  "patch_id": "pp_7b2e1a9f",
  "changes": [
    {
      "category": "bugfix",
      "impact": "high",
      "text": "Resolved memory leak in particle shader pipeline",
      "affected_system": "graphics"
    },
    {
      "category": "feature",
      "impact": "medium",
      "text": "Added cross-region matchmaking queues",
      "affected_system": "network"
    }
  ]
}

Authentication

All API requests require a valid API key passed via the Authorization header. Keys are scoped to specific environments and tied to your developer dashboard permissions.

Header Format

Bearer Token Authentication

Include your secret key in every request. PatchPulse validates signatures on a rolling 24-hour window and rejects malformed headers with a 401 status.

Authorization: Bearer pp_live_9k2m4x7q8v3n5w1z
Content-Type: application/json

Key Management

Scoped Access & Rotation

Generate separate keys for development, staging, and production. Use the dashboard to rotate credentials, set IP allowlists, and monitor usage quotas. Keys expire after 90 days of inactivity.

Missing or expired tokens return `{"error": "unauthorized", "code": "AUTH_001"}`. Never expose live keys in client-side code or public repositories.

Rate Limits

PatchPulse enforces tiered rate limits to ensure stable data delivery across the developer ecosystem. Limits are calculated per API key using a sliding window algorithm.

Standard Tier

120 Requests / Minute

Default allocation for individual developers and small teams. Includes real-time webhook subscriptions for up to 50 game titles. Exceeding the limit returns `429 Too Many Requests` with a `Retry-After` header.

Enterprise Tier

2,400 Requests / Minute

Dedicated throughput for platform integrations, news aggregators, and SaaS applications. Includes priority queue access, bulk export endpoints, and guaranteed 99.95% uptime SLA.

Response Headers

Usage Tracking

Every response includes rate-limit metadata to help you implement intelligent backoff strategies:

X-RateLimit-Limit: 120
X-RateLimit-Remaining: 84
X-RateLimit-Reset: 1715523600