What does the API return per firearm?

Dimensions, weight, capacity, barrel, caliber, manufacturer, country, year, status, full feature list, materials per component, and game-balanced stats across eight axes. 9,162+ models, 1,014+ manufacturers, 605+ cartridges joined across the whole catalog.

Where does the data come from?

Manufacturer spec sheets, official records, primary references. Every firearm carries a confidence score so you can filter by data quality before it hits production.

Is there a free tier?

Yes. Explorer is free forever, 200 requests a month, 10 per minute, no credit card. Enough to evaluate, prototype, and ship a side project before you upgrade.

How does authentication work?

No passwords. Drop your email, paste the six-digit code we send, you are in. Your API key issues the moment the code verifies. One-tap on every device.

Can I compare firearms in one call?

Up to five firearms per request, every dimension lined up, best-in-class values pre-marked. One endpoint, one rendered diff. No client-side merging.

What changes between tiers?

Rate limits and field depth. Explorer 10/min, Builder 60/min, Studio 120/min, Enterprise 300/min. Builder and up unlock compare and game-stats. Full-text search and the catalog ship on every plan.

What do enterprise teams get?

A 99.9% uptime SLA on Cloudflare's edge, up to 300 requests a minute, bulk exports, webhooks for data updates, and a named contact for onboarding and support. Encrypted at rest and in transit on every plan.

FIREARMS DATA
FOR BUILDERS.

The firearms specification API for developers

Start free View API docs

View all manufacturers

9,162Firearms
1,014Manufacturers
114Endpoints
99.9%Uptime

Sample request

REST

GET /v1/firearms/glock-17-gen5

curl https://api.gunspec.io/v1/firearms/glock-17-gen5 \
  -H "X-API-Key: $GUNSPEC_KEY"

Response

{
  "success": true,
  "data": {
    "id": "glock-17-gen5",
    "name": "Glock 17 Gen5",
    "parentFirearmId": "glock-17",
    "variantType": "generation",
    "yearIntroduced": 2017,
    "status": "in_production",
    "countryOfOrigin": "AT",
    "weightEmptyG": 625,
    "weightLoadedG": 863,
    "overallLengthMm": 202,
    "barrelLengthMm": 114,
    "heightMm": 138,
    "widthMm": 32,
    "actionType": "short_recoil",
    "firingMechanism": "striker_fired",
    "triggerType": "safe_action",
    "triggerPullN": 28,
    "magazineCapacity": 17,
    "muzzleVelocityMps": 375,
    "muzzleEnergyJ": 519,
    "effectiveRangeM": 50,
    "frameMaterial": "polymer",
    "slideMaterial": "steel",
    "firingModes": "["semi_automatic"]",
    "gameDamage": 42,
    "gameAccuracy": 68,
    "gameRange": 35,
    "gameFireRate": 55,
    "gameMobility": 76,
    "gameRecoilControl": 62,
    "gameReloadSpeed": 72,
    "gameConcealment": 65,
    "dataConfidence": 0.92,
    "has3dModel": 1,
    "svgLineArtUrl": "https://assets.gunspec.io/firearms/line/svg/glock-17-gen5.svg",
    "manufacturer": { "id": "glock", "name": "Glock Ges.m.b.H.", "countryCode": "AT", "foundedYear": 1963 },
    "category": { "id": "pistol", "name": "Pistol" },
    "calibers": [
      { "caliberId": "9x19mm-parabellum", "name": "9x19mm Parabellum", "natoDesignation": "9mm NATO", "isPrimary": 1 }
    ],
    "images": [
      { "id": 2572, "kind": "render", "url": "https://api.gunspec.io/v1/firearms/glock-17-gen5/images/2572" }
    ],
    "schematics": [
      { "id": 41, "title": "Field-strip diagram", "url": "https://assets.gunspec.io/firearms/schematics/glock-17-gen5-field-strip.pdf" }
    ]
  }
}

Pull the picture, not just the numbers.

One call returns a firearm's generated render, line-art silhouette, photographs, schematics and 3D model, each with sizes and a credit block. Drop them into a spec sheet, a product page or a game without hosting a single file.

5Asset kinds
3Sizes per image
24 hEdge-cached
Every itemCarries a credit

Accuracy International AWMSniper rifleGET /v1/firearms/accuracy-international-awm/media/render
AK-101Assault rifleGET /v1/firearms/ak-101/media/render
2A Armament Balios Lite BLR-16RifleGET /v1/firearms/2a-balios-lite-blr-16/media/render
Anschütz 1771RifleGET /v1/firearms/anschutz-1771/media/render
Astra-Unceta y Cia 357RevolverGET /v1/firearms/astra-357/media/render
Abadie M1886RevolverGET /v1/firearms/abadie-1886/media/render

Embed it

fetch-render.sh

1# One request, no lookup first: address the asset by kind2curl -H "X-API-Key: $GUNSPEC_KEY" -o awm.webp \3  "https://api.gunspec.io/v1/firearms/accuracy-international-awm/media/render?size=display"4
5# The silhouette as SVG, restroked white for a dark slide6curl -H "X-API-Key: $GUNSPEC_KEY" -o ak-101.svg \7  "https://api.gunspec.io/v1/firearms/ak-101/media/silhouette?stroke_color=white"

200 OKimage/pngcache-control: public, max-age=86400, immutable

thumb12 KB
display100 KB
full480 KB

One media item, inline

GET /v1/firearms/accuracy-international-awm/media/render?format=datauri

{  "kind": "render",  "format": "datauri",  "mimeType": "image/webp",  "width": 1536,  "height": 1024,  "alt": "Accuracy International AWM, left-side profile render",  "sizes": {    "full": ".../media/2572?size=full",    "display": ".../media/2572?size=display",    "thumb": ".../media/2572?size=thumb"  },  "credit": { "author": "GunSpec", "license": "GunSpec generated" },  "dataUri": "data:image/webp;base64,UklGRi4AAABXRUJQVlA4..."}

format=datauri returns the image inside the JSON, ready for an img tag, a Markdown file or a document export, capped at 256 KB. Leave size off and the largest variant that fits is chosen for you.

Documents and reports
Ask for a data URI and the image lands inline in the PDF, the Word export or the Google Doc. No asset folder, no broken link when the report is forwarded.
Analysts · Publishers
Websites and stores
Thumb, display and full sizes for every render, pre-cut so a listing page pulls 12KB and the detail page pulls the original. Serve through your own route and cache for a day.
Retail · Media
Games and engines
Renders straight onto a texture, silhouettes for the loadout screen, and the glTF binary for the model itself. Same slug you already use for the balanced stats.
Game studios

Read the media reference Browse every render

GunSpec renders are free to use with attribution, or without it on any paid plan. Third-party photographs keep their own licence, which the credit block spells out.

GunSpec Certified data

Every specification is sourced from manufacturer datasheets, cross-checked against independent references and reviewed by a person before it ships. That process is what earns a record the mark, and the mark is yours to cite.

Manufacturer-sourcedSpecs taken from official datasheets, not scraped guesses or crowd edits.
Cross-checkedVerified against multiple independent references before publishing.
Human-reviewedA dedicated data team reviews every record. Corrections ship continuously.

Field coverageLive from the catalog, across 9,162+ firearms

Images: 28.3%
Specifications: 94%
Caliber: 100%
Weight: 94.3%

Every figure traced to its source

FirearmIntroducedAdded

Browse recent firearms

Search by what is actually on the gun.

Every firearm in the catalog is tagged across hundreds of manufacturing features. M-Lok rails, billet receivers, ambidextrous controls, nickel-boron bolt carriers. Filter, group, and ship only the firearms that match what your customers ask for.

Billet receiver
Machined from solid aluminium billet. Tighter tolerances than forged.
Free floating handguard
Mounted at the receiver only. No barrel contact, no harmonic interference.
M-Lok
Modular slot system. Rails, lights, grips bolt on, no smith work.
Ambi charging handle
Pull from either side. Same draw for left-hand and right-hand shooters.
Ambi safety
Selector mirrored on both sides of the receiver. No re-train for lefties.
Ambi magazine release
Drop a magazine with either hand. Tactical reload, both sides.
Dual drop bolt release
Bolt releases from both sides. Faster recovery after a reload.
Mid-length gas
Gas tube routed mid-barrel. Softer recoil than carbine length.
Adjustable gas block
Tunable flow. Match the load, suppress the rifle, dial out recoil.
Nickel-boron BCG
Ni-B coating. Self-lubricating, corrosion-resistant, brighter than nitride.
Fixed stock
Non-collapsing buttstock. Maximum cheek weld, simplest geometry.
Muzzle brake
Vented at the muzzle. Redirects gas, kills recoil, controls climb.