GunSpec

Content

Public, key-free reads for GunSpec editorial content: blog posts and the product changelog. Both return only published entries and support pagination and category filtering. Use them to embed news, release notes, or articles directly in your own app.

Optional AuthExplorer+

Returns published posts about the service, pinned first and then newest. This is the editorial feed behind gunspec.io/updates: what is happening with the catalogue, the platform or the company, and why. /v1/changelog is the separate, narrower record of what shipped.

GET/v1/updates

  • stringheader

    Optional. Without a key this endpoint answers under the public policy; a key raises your limits and unlocks plan-gated fields. Authorization: Bearer <key> is accepted in its place.

  • integerdefault1

    Page number, from 1 to 10,000

    Range
    1 – 10000
    Example
  • integerdefault20

    Updates per page

    Range
    1 – 50
    Example
  • string

    Filter by what the post is about

    Accepts

  • SiteUpdate[]

    A dated post about the service: what is happening with the catalogue, the platform or the company, and why. Distinct from /v1/changelog, which records what shipped, and from a site notice, which is one line of chrome.

  • string

    The slug, and the URL: gunspec.io/updates/{id}.

  • string
  • string
  • UpdateKind

    What a site update is about: the catalogue, the platform, a policy, the company, or an incident.

  • UpdateBlock[]
  • UpdateBlockType

    The kind of block in a site update body. Each maps to a renderer on the website.

  • string

    The words, on a paragraph, heading or quote.

  • string[]

    The entries of a list.

  • boolean

    Whether a list is numbered.

  • string

    Who a quote is from.

  • string

    The source of a code block.

  • string

    How to highlight a code block.

  • UpdateFigure

    The figure beside an update. Either a picture, or a character-field pattern the website draws itself: most posts have no photograph, and a named drawing is the honest alternative to a stock image. Read kind to tell them apart.

  • string

    The line under a figure.

  • UpdateFigure

    The figure beside an update. Either a picture, or a character-field pattern the website draws itself: most posts have no photograph, and a named drawing is the honest alternative to a stock image. Read kind to tell them apart.

  • string

    What the asset is: silhouette, render, photo, schematic, model. /v1/firearms/{id}/media/{selector} addresses an asset by this.

  • string

    Where the picture is. Present when kind is image.

  • string

    What the picture shows. Present when kind is image.

  • UpdateGlyphPattern

    A character-field pattern an update may name in place of a photograph. The website draws it.

  • string

    Seeds the drawing. The same seed always draws the same field, so a post keeps its figure between loads.

  • string[]

    What the words pattern spells. Ignored by the others.

  • string | null

    The day the post is dated, as YYYY-MM-DD. A later edit does not re-date it.

  • integer

    Held at the top of the list regardless of date.

  • number

    Current page number

  • number

    Items per page

  • number

    Total matching records (Builder and above)

  • 400VALIDATION_ERRORValidation error
  • 429RATE_LIMITEDRate limit exceeded
  • 500INTERNAL_ERRORUnexpected server error

Minimum tier
Explorer+
Monthly quota
200/mo
Rate limit
10/min
Daily cap
50

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