GunSpec

Game

Resource class for interacting with the GunSpec Game API. Wraps all /v1/game endpoints. These endpoints provide game-balanced firearm data suitable for game development, including normalized stats, tier rankings, and balance analysis. Instantiated internally by the GunSpec client and exposed as client.game.

Auth RequiredBuilder+

client.game.tierList()

Get a tier list of firearms ranked by a specific stat.

tierList(params?: TierListParams): Promise<APIResponse<TierList>>
GET/v1/game/tier-list

Builder+

  • stringheaderrequired

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

  • stringdefaultdamage

    Which stat to tier by

    Accepts
    Example
  • string

    Restrict the tier list to a category slug

    Example

application/json

  • object

    The response payload.

  • string

    Which statistic this row is about, named as the field is: weightEmptyG, damage.

  • object

    Firearms grouped into tiers, strongest first.

  • object[]

    Top tier for this stat.

  • object[]

    Second tier.

  • object[]

    Third tier.

  • object[]

    Fourth tier.

  • object[]

    Bottom tier for this stat.

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

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.