POST /v1/post/fetch

Back to Docs Page

Raw markdown source view for LLM workflows.

---
title: POST /v1/post/fetch
description: Returns live payloads for requested servers and auto-inserts valid unknown pairs.
---

Base URL for this endpoint: `https://api.gamequery.dev`

## Request headers

```http
Content-Type: application/json
X-API-Token: YOUR_API_KEY
X-API-Token-Type: FREE
X-API-Token-Email: [email protected]
```

## Request body

```json
{
  "servers": [
    {
      "game_id": "counterstrike16",
      "servers": ["203.0.113.12:27015", "203.0.113.13:27015"]
    }
  ]
}
```

## Success response shape

```json
{
  "203.0.113.12:27015": {
    "name": "Example Server",
    "players": 14,
    "maxplayers": 32,
    "_updater": {
      "status": "online",
      "firewall_interval_minutes": 1,
      "firewall_label": "none",
      "next_probe_at": "2026-02-20T10:00:00.000Z",
      "last_probe_at": "2026-02-20T09:59:00.000Z",
      "last_online_at": "2026-02-20T09:59:00.000Z"
    }
  },
  "_meta": {
    "auto_inserted": 1,
    "inserted_servers": [
      { "game_id": "counterstrike16", "server": "203.0.113.12:27015" }
    ],
    "invalid_servers": []
  }
}
```

## Operational details

- Response body is gzip-compressed.
- Missing data returns a fallback message object.
- Stale payloads can include `_stale` diagnostics when freshness thresholds are exceeded.