Statistics

Count firearms by category

Returns the firearm count per category, with the mean weight, magazine capacity and barrel length of each.

Available on every plan. Requires an API key; Explorer keys receive a reduced field set.

get/v1/stats/by-category

Request

  • Base URL: https://api.gunspec.io
  • URL: https://api.gunspec.io/v1/stats/by-category
  • Auth: one of:
    • API key in header X-API-Key
    • HTTP bearer

Response

Count firearms by category

successboolean required

Always true on a successful response. Every error carries false and an error object instead.

Example response

{
  "success": true,
  "data": [
    {
      "id": "pistol",
      "name": "Pistol",
      "firearm_count": 3922,
      "avg_weight_g": 816.37,
      "avg_magazine_capacity": 10.94,
      "avg_barrel_length_mm": 111.07
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.