Endpoint Reference (v1)
POST /v1/post/fetch
Returns live payloads for requested servers and auto-inserts valid unknown pairs.
Base URL for this endpoint: https://api.gamequery.dev
Request headers
Content-Type: application/json
X-API-Token: YOUR_API_KEY
X-API-Token-Type: FREE
X-API-Token-Email: [email protected]Request body
{
"servers": [
{
"game_id": "counterstrike16",
"servers": ["203.0.113.12:27015", "203.0.113.13:27015"]
}
]
}Success response shape
{
"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
_stalediagnostics when freshness thresholds are exceeded.