GunSpec

Firearms

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

Authentifizierung erforderlichExplorer+

Popular Firearms

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

GET/v1/popular/firearms

Explorer+

  • stringHeadererforderlich

    Ihr API-Schlüssel. Authorization: Bearer <key> wird ebenfalls akzeptiert.

  • integerstandard7

    Trailing window in days

    Bereich
    1 – 30
    Beispiel
  • integerstandard10

    How many to return

    Bereich
    1 – 20
    Beispiel

application/json

  • PopularFirearm[]

    The response payload.

  • string

    Slug of the firearm. Named entity_id because the rollup counts views of any entity kind; it is id on the catalog endpoints.

  • string

    Display name of the firearm.

  • string | null

    Slug of the manufacturer. manufacturerId on the camelCase endpoints.

  • string | null

    Slug of the category. categoryId on the camelCase endpoints.

  • string | null

    ISO 3166-1 alpha-2 code of the country of origin.

  • integer | null

    Year the model was introduced.

  • FirearmStatus | null

    Production status, one of in_production, discontinued, out_of_production, in_service, limited_production, prototype. Discontinued records are kept deliberately: a rifle built in 2004 wears parts nobody sells today.

  • string | null

    Line-art silhouette, or null where none has been drawn.

  • integer

    Views recorded inside the trailing window given by days.

  • integer

    Distinct visitors behind those views. Forty views from one reader is a different fact from forty readers.

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

Ranking is based on anonymised view analytics, refreshed daily.

The window is capped at 30 days and the result set at 20 firearms.

Alle Anfragelimits

Mindeststufe
Explorer+
Monatskontingent
200/mo
Anfragerate
10/min
Tageslimit
50

Die Werte gelten für die Mindeststufe dieses Endpunkts. Höhere Stufen erhöhen alle Limits.