client.firearms.popular()
List the most viewed firearms over a trailing window.
popular(params?: { days?: number; limit?: number }): Promise<APIResponse<PopularFirearm[]>>- stringHeadererforderlich
Ihr API-Schlüssel.
Authorization: Bearer <key>wird ebenfalls akzeptiert.
- integerstandard
7Trailing window in days
- Bereich
- 1 – 30
- Beispiel
- integerstandard
10How many to return
- Bereich
- 1 – 20
- Beispiel
- 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_ERRORValidation error - 401
UNAUTHORIZEDAPI key required - 403
FORBIDDENValid key, not permitted - 429
RATE_LIMITEDRate limit exceeded - 500
INTERNAL_ERRORUnexpected server error
- Mindeststufe
- Explorer+
- Monatskontingent
- 200/mo
- Anfragerate
- 10/min
- Tageslimit
- 50
Die Werte gelten für die Mindeststufe dieses Endpunkts. Höhere Stufen erhöhen alle Limits.