GunSpec

Statistics & Analytics

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

Auth RequiredStudio+

Adoption by Type

Returns the firearms adopted by operators of one type, e.g. every military adoption.

GET/v1/stats/adoption/by-type

Studio+

  • stringheaderrequired

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

  • stringrequired

    Operator type

    Accepts
    Example

application/json

  • object[]

    The response payload.

  • string

    Slug of the adopted firearm.

  • string

    Display name of the firearm.

  • integer

    How many operators of this type adopted it.

  • string[]

    ISO 3166-1 alpha-2 codes of the countries those operators belong to.

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

Requires Studio tier or higher.

Valid types are military, police, and civilian.

Results are sorted by adoption count descending.

Full rate limits

Minimum tier
Studio+
Monthly quota
150,000/mo
Rate limit
120/min
Daily cap
10,000

Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.