gzw-data (Python)

Dependency-free Python client for the free Gray Zone Warfare data API. Fan-made and not affiliated with the game's developer.

PyPI: https://pypi.org/project/gzw-data/
Guide: https://gzw-data.dev/docs/python/
API reference: https://gzw-data.dev/docs/

pip install gzw-data

from gzw_data import GzwDataClient

client = GzwDataClient()                       # no API key needed
print(client.datasets())                       # {'ammo': 79, 'weapons': 44, ...}
print(client.get("weapons", "ak-12")["name"])  # AK-12
for ammo in client.iterate("ammo", search="5.56"):
    print(ammo["name"])
print(list(client.search("AK")))               # dataset names that matched

Errors raise GzwApiError (.status, .code, .url, .retry_after). Rate-limit (honouring Retry-After) and 5xx responses are retried with backoff.

Game data comes from the community wiki and has its own terms: see the data license. Code is MIT.

Development

python -m unittest discover -s tests

Releases are automatic: bump the version and push to main. See RELEASING.md.

Metadata

Release files for gzw-data 0.1.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for gzw-data 0.1.3
File	Size	Uploaded
gzw_data-0.1.3.tar.gz	6.4 kB	Oct 16, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for gzw-data 0.1.3
File	Interpreter	ABI	Platform	Reset
gzw_data-0.1.3-py3-none-any.whl 5.5 kB Oct 16, 2026	Python 3	none	any	Details

Total release size: 11.9 kB

Release files / gzw_data-0.1.3.tar.gz

Download URL	gzw_data-0.1.3.tar.gz
Size	6.4 kB
Tags	Source
SHA-256 checksum How to use checksums	`3978ebde7fe8641064574fee462e6f21107547eff5294febb3d38ad15afc6f8e`
BLAKE2b-256 checksum How to use checksums	`d5fbb9b69f53e5755d5e1170402852455d08ff80666dc8bd93dfc8ea8d944b6f`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ZoniBoy00/gzw-data-py
Publishing commit: github.com/ZoniBoy00/gzw-data-py/tree/580bc4b705e8e9753fb52030c9a8a8b7ab416d93

Workflow

Publishing configuration: github.com/ZoniBoy00/gzw-data-py/blob/580bc4b705e8e9753fb52030c9a8a8b7ab416d93/.github/workflows/publish.yml
Publishing logs: github.com/ZoniBoy00/gzw-data-py/actions/runs/38936724875/attempts/1

Artifact

Subject: gzw_data-0.1.3.tar.gz
SHA-256 checksum: 3978ebde7fe8641064574fee462e6f21107547eff5294febb3d38ad15afc6f8e Verifying attestations

Release files / gzw_data-0.1.3-py3-none-any.whl

Download URL	gzw_data-0.1.3-py3-none-any.whl
Size	5.5 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`8bf1b88a1f5f9001a1c0263aafdef7272206169cfc30b65fa8170f8c2e59da7f`
BLAKE2b-256 checksum How to use checksums	`8b07f5fef40a5fc3d976499d0ef48c8a4fcf7639dbbc88d99025dce3887992af`
Upload date	Oct 16, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/ZoniBoy00/gzw-data-py
Publishing commit: github.com/ZoniBoy00/gzw-data-py/tree/580bc4b705e8e9753fb52030c9a8a8b7ab416d93

Workflow

Publishing configuration: github.com/ZoniBoy00/gzw-data-py/blob/580bc4b705e8e9753fb52030c9a8a8b7ab416d93/.github/workflows/publish.yml
Publishing logs: github.com/ZoniBoy00/gzw-data-py/actions/runs/38936724875/attempts/1

Artifact

Subject: gzw_data-0.1.3-py3-none-any.whl
SHA-256 checksum: 8bf1b88a1f5f9001a1c0263aafdef7272206169cfc30b65fa8170f8c2e59da7f Verifying attestations