# gunspec-io Firearm Discovery API

**Canonical:** https://apis.io/apis/gunspec-io/gunspec-io-firearm-discovery-api/  
**Provider:** gunspec-io — https://apis.io/providers/gunspec-io/  
**Base URL:** https://api.gunspec.io  
**Documentation:** https://docs.gunspec.io/en/api/firearms

gunspec-io Firearm Discovery API is one of 22 APIs that [gunspec-io](https://apis.io/providers/gunspec-io/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Firearm Discovery. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and 6 JSON Schemas.

Cross-catalog queries: random picks, top lists, head-to-head, and filters by feature, action, material, designer, or conflict

## Operations (15)

| Method | Path | Summary |
|---|---|---|
| GET | `/v1/firearms/random` | Get a random firearm |
| GET | `/v1/firearms/top` | Rank firearms by a superlative |
| GET | `/v1/firearms/head-to-head` | Compare two firearms head to head |
| GET | `/v1/firearms/game-meta` | Get the game meta roster |
| GET | `/v1/firearms/action-types` | List action types |
| GET | `/v1/firearms/filter-options` | Get available filter values |
| GET | `/v1/features/icons` | List feature icons |
| GET | `/v1/firearms/by-feature` | Filter by feature |
| GET | `/v1/firearms/by-action` | Filter by action type |
| GET | `/v1/firearms/by-material` | Filter by construction material |
| GET | `/v1/firearms/by-designer` | Filter by designer |
| GET | `/v1/firearms/by-conflict` | Filter by conflict |
| GET | `/v1/firearms/power-rating` | Rank by composite power rating |
| GET | `/v1/firearms/timeline` | Browse the catalog chronologically |
| GET | `/v1/popular/firearms` | List the most viewed firearms |

## Machine-readable artifacts (8)

- **OpenAPI** — https://artifacts.apis.io/gunspec-io/openapi/gunspec-io-firearm-discovery-api-openapi.yml
- **Documentation** — https://docs.gunspec.io
- **JSONSchema** — https://artifacts.apis.io/gunspec-io/json-schema/gunspec-io-api-contract-run-schema.json
- **JSONSchema** — https://artifacts.apis.io/gunspec-io/json-schema/gunspec-io-caliber-schema.json
- **JSONSchema** — https://artifacts.apis.io/gunspec-io/json-schema/gunspec-io-sdk-verification-run-schema.json
- **JSONSchema** — https://artifacts.apis.io/gunspec-io/json-schema/gunspec-io-ammunition-load-schema.json
- **JSONSchema** — https://artifacts.apis.io/gunspec-io/json-schema/gunspec-io-firearm-list-item-schema.json
- **JSONSchema** — https://artifacts.apis.io/gunspec-io/json-schema/gunspec-io-firearm-search-result-schema.json

## Other gunspec-io APIs (12)

- [gunspec-io Account API](https://apis.io/apis/gunspec-io/gunspec-io-account-api/)
- [gunspec-io Ammunition API](https://apis.io/apis/gunspec-io/gunspec-io-ammunition-api/)
- [gunspec-io Calibers API](https://apis.io/apis/gunspec-io/gunspec-io-calibers-api/)
- [gunspec-io Categories API](https://apis.io/apis/gunspec-io/gunspec-io-categories-api/)
- [gunspec-io Changes API](https://apis.io/apis/gunspec-io/gunspec-io-changes-api/)
- [gunspec-io Collections API](https://apis.io/apis/gunspec-io/gunspec-io-collections-api/)
- [gunspec-io Compatibility API](https://apis.io/apis/gunspec-io/gunspec-io-compatibility-api/)
- [gunspec-io Conflicts API](https://apis.io/apis/gunspec-io/gunspec-io-conflicts-api/)
- [gunspec-io Content API](https://apis.io/apis/gunspec-io/gunspec-io-content-api/)
- [gunspec-io Countries API](https://apis.io/apis/gunspec-io/gunspec-io-countries-api/)
- [gunspec-io Data Quality API](https://apis.io/apis/gunspec-io/gunspec-io-data-quality-api/)
- [gunspec-io Firearm Analysis API](https://apis.io/apis/gunspec-io/gunspec-io-firearm-analysis-api/)

## Tags

Firearm Discovery

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/gunspec-io/gunspec-io-firearm-discovery-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/gunspec-io/.