GZW Data API
Gray Zone Warfare — complete game data API. 40+ datasets, auto-scraped weekly from the official wiki.
v2.0 · 100 req/min · MIT
# Base URL
https://gzw-data.vercel.app
All endpoints are prefixed with /api/. Every response includes CORS headers, so you can call the API directly from the browser.
# Authentication
No authentication required. The API is fully open and free to use.
# Rate Limiting
100 requests per minute per IP address. Rate limit info is returned in response headers:
X-RateLimit-Limit: 100
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1721234567
If you exceed the limit, the API returns HTTP 429. Reset your limit by waiting for the next window.
# Response Format
All endpoints return JSON with this structure:
{
"data": [ ... ], // Array of items or object
"count": 44, // Number of items (arrays only)
"source": "GZW Data API",
"timestamp": "2026-07-20T12:00:00.000Z"
}
# Endpoints
Every data file is automatically available as /api/<name>. No registration needed.
Smart Routes (combined datasets)
GET
/api/armor
Combined armor: vests (35) + helmets (42) + glasses (14) = 91 items
?type= ?nij= ?material= ?category=vest|helmet|glasses
GET
/api/weapon_parts
Combined weapon parts: barrels, stocks, grips, suppressors, mags, etc. — 268+ items
?search=
GET
/api/helmet_mods
Combined helmet mods: night vision (5) + mounts (3) = 8 items
?mod_type=night_vision|mount ?search=
GET
/api/loot
120 loot items — alcohol, jewellery, electronics, intel, etc.
?search=
GET
/api/apparel
63 apparel items — tactical clothing, shirts, trousers, gloves, boots
?search= ?type=
Equipment
GET/api/weapons
44 weapons — type, caliber, mag size, fire rate, image
?type= ?caliber= ?search=
GET/api/ammo
67 ammo types — penetration data by armor class
?caliber= ?search=
GET/api/vests
35 armor vests & plate carriers — NIJ rating, material, grid
?nij= ?material= ?type=
GET/api/helmets
42 helmets & head protection
?material= ?type=
GET/api/backpacks
17 backpacks — weight, grid, image
?capacity= ?type=
GET/api/rigs
12 tactical rigs — weight, grid, image
?capacity=
GET/api/throwables
8 grenades — frag, smoke, stun
—
Wearables
GET/api/glasses
14 eyewear items
?type=
GET/api/face_cover
5 face covers & masks
—
GET/api/headsets
8 headsets & earmuffs
—
GET/api/headwear_items
40 caps, helmets, headwear
—
GET/api/belts
9 belts & belt accessories
—
Medical & Supplies
GET/api/medical
34 medical items — bandages, splints, surgery kits, stims
?type= ?effect=
GET/api/provisions
37 food & drink provisions
?type=
GET/api/drinks
18 drink items
—
Containers & Loot
GET/api/containers
29 storage containers — ammo boxes, weapon cases
—
GET/api/loot_containers
4 world-spawn loot containers
—
GET/api/gear
27 miscellaneous gear items
—
Weapon Parts (individual categories)
GET/api/muzzle_devices
45 muzzle devices
—
GET/api/suppressors
23 suppressors
—
GET/api/stock_adapters
10 stock adapters
—
GET/api/pistol_grips
25 pistol grips
—
GET/api/foregrips
19 foregrips
—
GET/api/magazines
51 magazines
—
GET/api/night_vision
5 night vision devices
—
GET/api/helmet_mounts
3 helmet mounts
—
Game Items
GET/api/keys
127 keys across all locations
?location= ?type=
GET/api/task_items
101 task-specific items
—
GET/api/weapon_camos
Weapon camouflage skins
—
Reference
GET/api/factions
6 factions with lore & logos
—
GET/api/info_pages
10 reference pages — Health, Ballistics, Trading, etc.
—
GET/api/tasks
467 tasks — vendor, area, objectives
?vendor= ?area= ?search=
Utility
GET/api/stats
Dataset statistics with item counts for every endpoint
—
GET/api/search?q=
Cross-dataset search — finds matching items across all datasets
?q= required
GET/api/images
Item image URL lookup (JSON object, 400+ entries)
—
GET/api/spec
OpenAPI 3.0 specification (JSON)
—
GET/api/health
Health check — shows loaded datasets and their status
—
# Query Parameters
Every endpoint supports these query parameters for filtering and pagination:
Field filters
Filter by any string field in the dataset. The filter is case-insensitive.
curl "/api/vests?nij=III&material=Ceramic"
curl "/api/ammo?caliber=5.56x45mm%20NATO"
curl "/api/keys?type=Keycard"
Free text search
Search across all fields in a dataset with ?search=.
curl "/api/weapons?search=AK"
curl "/api/tasks?search=artifact"
Sorting
Sort by any field with ?sort=field:asc|desc.
curl "/api/weapons?sort=name:asc"
curl "/api/tasks?sort=name:desc"
Limit results
Cap the number of returned items with ?limit=.
curl "/api/tasks?limit=5"
curl "/api/weapons?limit=10"
# Full Example
Find all ceramic III vests, sorted by name:
curl "https://gzw-data.vercel.app/api/vests?nij=III&material=Ceramic&sort=name:asc"
Response:
{
"data": [
{
"name": "CGPC3 TQS",
"nij": "III",
"material": "Ceramic",
"weight": 3.2,
"grid": "4x3",
"image": "https://static.wikia.nocookie.net/..."
}
],
"count": 9,
"source": "GZW Data API",
"timestamp": "2026-07-20T12:00:00.000Z"
}
# Data Sources
All data is automatically scraped from the GZW Fandom Wiki every Monday at 06:00 UTC.