GunSpec

Stats

Resource class for interacting with the GunSpec Statistics API. Wraps all /v1/stats endpoints. Instantiated internally by the GunSpec client and exposed as client.stats.

Authentifizierung erforderlichStudio+

client.stats.adoptionByCountry()

Get firearm adoption statistics for a specific country.

adoptionByCountry(params: AdoptionByCountryParams): Promise<APIResponse<AdoptionByCountryItem[]>>
GET/v1/stats/adoption/by-country

Studio+

  • stringHeadererforderlich

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

  • stringerforderlich

    ISO 3166-1 alpha-2 country code

    Max. Länge
    10
    Beispiel

application/json

  • object[]

    The response payload.

  • integer

    Numeric id of the adoption record itself, not of the firearm.

  • string | null

    The organisation that adopted the firearm.

  • string | null

    Kind of operator: one of military, law_enforcement, civilian, paramilitary, special_forces, private_security, training.

  • integer | null

    Year the operator adopted it. Null where the date is unrecorded.

  • string | null

    Military or standards designation for the load, e.g. M882.

  • string

    Slug of the adopted firearm.

  • string

    Display name of the firearm.

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

Alle Anfragelimits

Mindeststufe
Studio+
Monatskontingent
150,000/mo
Anfragerate
120/min
Tageslimit
10,000

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