Data Quality

List cited sources

Every site the catalogue cites, strongest first: its kind and place in the source hierarchy, the basis for that kind, and how many records cite it. A maker's own site, a standards body or a government is an authority; every other kind a person has classed from the site's own pages is classified; the rest are unclassified and count as the weakest kind until someone classes them. Classed with the same rules as every record's provenance.sourceKinds, so the two never disagree.

No API key required.

get/v1/data/sources

Request

  • Base URL: https://api.gunspec.io
  • URL: https://api.gunspec.io/v1/data/sources
  • Auth: one of:
    • none
    • API key in header X-API-Key
    • HTTP bearer

Query parameters

pageinteger

Page number, from 1 to 10,000

per_pageinteger

Items per page (max 100)

qstring

Only sites whose host, or whose maker ids, contain this.

kind'manufacturer' | 'standards_body' | 'government' | 'peer_reviewed' | 'reference' | 'aggregator' | 'press' | 'retailer' | 'community' | 'other'

Only one kind of source.

tier'authority' | 'classified' | 'unclassified'

Only one tier.

Response

List cited sources

successboolean required

Always true on a successful response. Every error carries false and an error object instead.

Example response

{
  "success": true,
  "data": [
    {
      "host": "sigsauer.com",
      "kind": "manufacturer",
      "basis": "declared",
      "tier": "authority",
      "citations": 200,
      "records": {
        "firearms": 184,
        "manufacturers": 1
      },
      "makers": [
        "sig-sauer"
      ],
      "evidence": "title \"Chapuis USA Official Site\"; maker's official US site"
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 20,
    "limit": 20,
    "total": 42,
    "totalPages": 3
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.