GunSpec

Statistics & Analytics

Aggregated insights from the firearms database. Discover popular calibers, prolific manufacturers, category breakdowns, era analysis, material distributions, and adoption patterns.

Auth RequiredBuilder+

Feature Frequency

Returns how often each catalogued feature appears across firearms.

GET/v1/stats/feature-frequency

Builder+

  • stringheaderrequired

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

  • string

    Restrict to a category slug

    Example
  • integerdefault50

    How many to return

    Range
    1 – 100
    Example

application/json

  • object[]

    The response payload.

  • string

    The feature as stored, and the value to send as feature to /v1/firearms/by-feature.

  • integer

    How many records fall in this bucket.

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

Requires Builder tier or higher.

Features are extracted from firearm specification fields.

Results are sorted by count descending.

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.