client.firearms.popular()
List the most viewed firearms over a trailing window.
popular(params?: { days?: number; limit?: number }): Promise<APIResponse<PopularFirearm[]>>- stringheaderrequired
Your API key.
Authorization: Bearer <key>is accepted in its place.
- integerdefault
7Trailing window in days
- Range
- 1 – 30
- Example
- integerdefault
10How many to return
- Range
- 1 – 20
- Example
- PopularFirearm[]
The response payload.
- string
Slug of the firearm. Named
entity_idbecause the rollup counts views of any entity kind; it isidon the catalog endpoints. - string
Display name of the firearm.
- string | null
Slug of the manufacturer.
manufacturerIdon the camelCase endpoints. - string | null
Slug of the category.
categoryIdon 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.
- 400
VALIDATION_ERROR - 401
UNAUTHORIZED - 403
FORBIDDEN - 429
RATE_LIMITED - 500
INTERNAL_ERROR
- 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.