API Documentation

Access GameListZone data programmatically. Build integrations, dashboards, and tools with our REST API.

Quick Start

1. Get an API Key

Create an API key from your dashboard.

2. Make a Request

curl -H "X-API-Key: glz_your_key_here" \
  https://gamelistzone.com/api/v1/servers

Authentication

Include your API key in every request using one of these methods:

Header (recommended)

X-API-Key: glz_your_key_here

Bearer Token

Authorization: Bearer glz_your_key_here

API Tiers

FREE

Requests: 100 requests/day

Rate limit: 10/min

Features

Basic server data
Game listings
Search functionality

Fields

id, name, gameSlug, gameName, vipLevel, status, externalLink

DEVELOPER

$29/mo

Requests: 10,000 requests/day

Rate limit: 100/min

Features

Extended server data
Game versions & flags
Priority support

Fields

All FREE fields, slug, description, bonusText, rateDisplay, language, flags, createdAt, vipExpiresAt, gameVersion, startDateTime, contactEmail

BUSINESS

$99/mo

Requests: 100,000 requests/day

Rate limit: 1000/min

Features

Analytics data
Verification status
Webhooks (coming soon)
SLA guarantee

Fields

All DEVELOPER fields, clickCount, isVerified, trustScore, healthStatus, uptime30d

Endpoints

GET/api/v1/serversFREE+

List servers with pagination and filtering

Parameters

Name	Type	Description
`page`	number	Page number (default: 1)
`limit`	number	Items per page (max: 100, default: 20)
`game`	string	Filter by game slug (e.g., "wow", "minecraft")
`status`	string	Filter by status (default: "APPROVED")
`vip_level`	string	Filter by VIP level
`language`	string	Filter by language
`sort`	string	Sort field: vipLevel, createdAt, name
`order`	string	Sort order: asc, desc

GET/api/v1/servers/:idFREE+

Get a single server by ID

GET/api/v1/gamesFREE+

List all games

Parameters

Name	Type	Description
`category`	string	Filter by category

GET/api/v1/games/:slugFREE+

Get a single game by slug

GET/api/v1/searchFREE+

Search servers by name or description

Parameters

Name	Type	Description
`q`*	string	Search query (min 2 characters)
`page`	number	Page number (default: 1)
`limit`	number	Items per page (max: 50, default: 20)
`game`	string	Filter by game slug

Response Format

All responses include metadata about your API usage:

{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "totalPages": 8,
    "hasMore": true
  },
  "meta": {
    "tier": "FREE",
    "requestsToday": 45,
    "dailyLimit": 100
  }
}

Error Handling

Errors include a descriptive message:

{
  "error": "Daily limit exceeded",
  "tier": "FREE",
  "requestsToday": 100,
  "dailyLimit": 100
}

HTTP Status Codes

200 - Success
400 - Bad request (invalid parameters)
401 - Unauthorized (invalid or missing API key)
404 - Resource not found
429 - Rate limit exceeded
500 - Internal server error