Firearm Discovery

List the most viewed firearms

Returns firearms ranked by recorded view activity over a trailing window.

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

get/v1/popular/firearms

Request

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

Query parameters

daysinteger

Trailing window in days

limitinteger

How many to return

Response

List the most viewed firearms

successboolean required

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

Example response

{
  "success": true,
  "data": [
    {
      "entity_id": "glock-g17-gen5",
      "entity_name": "Glock 17 Gen5",
      "manufacturer_id": "glock",
      "category_id": "pistol",
      "country_of_origin": "AT",
      "year_introduced": 2017,
      "svg_line_art_url": "https://api.gunspec.io/v1/firearms/glock-g17-gen5/media/silhouette",
      "total_views": 49,
      "total_unique_users": 4
    }
  ]
}

Changes

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