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.

Auth RequiredExplorer+

client.stats.catalogCoverage()

Get catalog completeness percentages. Reports what share of firearms have a line-art image, core specifications filled, at least one caliber mapped, and a recorded weight. Computed live.

catalogCoverage(): Promise<APIResponse<CatalogCoverage>>
GET/v1/stats/catalog-coverage

Explorer+

  • stringheaderrequired

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

application/json

  • object

    The response payload.

  • integer

    Total records matching the query across every page.

  • number

    Percentage of firearms carrying at least one image.

  • number

    Percentage of firearms carrying at least one recorded specification.

  • number

    Percentage of firearms with at least one caliber recorded.

  • number

    Percentage of firearms with an unloaded weight recorded.

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

Full rate limits

Minimum tier
Explorer+
Monthly quota
200/mo
Rate limit
10/min
Daily cap
50

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