GunSpec

Firearms

Browse, search, compare, and retrieve detailed specifications for over 9,000+ firearms including variants.

Auth RequiredBuilder+

One asset

Fetch a single asset addressed either by kind (silhouette, render, photo, schematic, model) or by the numeric id from the list.

GET/v1/firearms/{id}/media/{selector}

Builder+

  • stringheaderrequired

    Your API key. Authorization: Bearer <key> is accepted in its place.

  • stringrequired

    Resource slug ID

    Accepts
    a lowercase slug: letters, digits and hyphens
    Example
  • unknownrequired

    Which asset: a kind, which resolves to the primary asset of that kind, or the numeric id of one row from /v1/firearms/{id}/media. Addressing by kind means never having to list first just to learn an id.

    Accepts
    or a numeric id
    Example

  • stringdefaultraw

    Bytes, an inline data URI, or metadata only

    Accepts
    Example
  • stringdefaultfull

    Pre-rendered derivative; falls back to the original when absent

    Accepts
    Example
  • integerdefault0

    Silhouettes only: inject a stroke so line art reads on any background

    Range
    0 – 20
    Example
  • stringdefaultblack

    Silhouettes only: stroke colour. Any CSS colour the browser understands; quotes, angle brackets, ampersands and backslashes are refused, because the value is written into an SVG attribute

    Max length
    64
    Example

application/json

  • MediaItem

    One asset belonging to a firearm. Every kind, whether silhouette, render, photo, schematic or 3D model, is returned in this same shape, and url is always absolute and directly fetchable.

  • integer | null

    Null for assets stored as a column rather than a row (the 3D model).

  • MediaKind

    What kind of asset a media row is.

  • string | null

    Media type of the bytes, e.g. image/png.

  • integer | null

    Pixel width, where it is known.

  • integer | null

    Pixel height, where it is known.

  • string | null

    Alt text, where one has been written. Null otherwise, so do not render an empty string.

  • string

    Absolute, directly fetchable URL.

  • object

    Per-size URLs. Absent on assets we link rather than host.

  • string

    URL of the asset at full size.

  • string

    URL of the mid-size rendition, for a detail page.

  • string

    URL of the thumbnail rendition, for a list or grid.

  • object

    Attribution required to reuse the asset. Populated wherever the catalogue records it.

  • string | null

    Where the record came from: a curated entry, an inference, or an import.

  • string | null

    Who made the asset, where it is credited.

  • string | null

    Page the asset or document was taken from.

  • string | null

    Licence the asset is held under, where one is recorded.

  • 400VALIDATION_ERRORValidation error
  • 401UNAUTHORIZEDAPI key required
  • 403FORBIDDENValid key, not permitted
  • 404NOT_FOUNDResource not found
  • 429RATE_LIMITEDRate limit exceeded
  • 500INTERNAL_ERRORUnexpected server error

Requires Builder tier or higher. Listing media and its credits is Explorer.

Address by kind (/media/silhouette) to skip the listing call entirely. This is the fastest way to pull an asset when you only know the firearm.

size=thumb is typically 10-20x smaller than full: on the AK-47 render that is 12KB against 528KB. Use it for grids, lists and HUD icons.

format=datauri without an explicit size automatically picks the largest variant under the 256KB cap, so embedding just works. Pass an explicit size if you need a specific one.

Assets we link rather than host, such as schematics, 3D models and externally sourced photos, answer with a 302 to their location.

stroke_width and stroke_color apply to silhouettes only and are ignored elsewhere.

Full rate limits

Minimum tier
Builder+
Monthly quota
25,000/mo
Rate limit
60/min
Daily cap
2,000

Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.