API Documentation

GunSpec API

Everything you need to integrate firearms specification data into your app, game, or research project. 68 REST endpoints, free tier, and detailed response schemas.

Base URLhttps://api.gunspec.io

Sign up for a free API key and start making requests in seconds.

1

List Firearms

curl https://api.gunspec.io/v1/firearms
2

Search

curl "https://api.gunspec.io/v1/firearms/search?q=glock"
3

Get Details

curl https://api.gunspec.io/v1/firearms/glock-17-gen5

Authentication

All API endpoints require authentication. Pass your API key via the X-API-Key header. Sign up for a free Explorer key to get started. Higher tiers unlock additional endpoints like search, detail, compare, images, and game stats.

No Auth Required

Browse firearms, search, view specs, and list categories

API Key

Higher rate limits, compare, images, and game stats

Using API Keys

Include your API key in the X-API-Key header:

curl -H "X-API-Key: your_api_key" \
  https://api.gunspec.io/v1/firearms

Ready to build?

Get your free API key and start integrating firearms data in minutes.

Get Started Free