# Latvian Weapons Catalog (weapons.rupucs.in)

> Searchable database of Latvian State Police classified weapons. Data automatically extracted from official government PDF documents via OCR.

## What this site provides

This website makes the Latvian State Police classified weapons catalog (published at vp.gov.lv) searchable and filterable. The original government data is published as PDF files that are difficult to search. This project extracts the data nightly using OCR and presents it in a structured, queryable format.

## Data quality notice

All text fields (name, caliber, manufacturer, category) are OCR-extracted from government PDF scans. Expect occasional OCR noise — misread characters, spacing issues, Latvian diacritics errors. Treat field values as approximate rather than authoritative. Cross-reference with the official PDF source when precision matters.

## Data source

Official source: https://www.vp.gov.lv/lv/informacija-par-klasificeto-ierocu-sarakstiem
Data is extracted from three PDF documents published by the Latvian State Police (Valsts Policija).

## Weapon categories

- **GG (Garstobra/Gludstobra)**: Long-barreled smoothbore firearms
- **GV (Garstobra/Vitnstobra)**: Long-barreled rifled firearms
- **IV (Isstobra/Saujamieroci)**: Short-barreled firearms

## Available data per weapon

- Name (nosaukums)
- Caliber (kalibri)
- Manufacturer (razotajs)
- Category (kategorija) — A, B, C, D
- Barrel length (stobrs) — mm
- Ammunition capacity (patronas)
- Usage flags: self-defence, hunting, sport, collection (0 or 1)
- Image thumbnail (250px WebP) and large image (600px WebP)

## API — direct data access

REST API returns JSON. The web UI is an Angular SPA; for structured data access, use the API directly.

### Get all weapons by type (paginated, 50 per page)

- https://weapons.rupucs.in/api?action=getWeaponsList&type=gg&index=0
- https://weapons.rupucs.in/api?action=getWeaponsList&type=gv&index=0
- https://weapons.rupucs.in/api?action=getWeaponsList&type=iv&index=0

### Search weapons with filters

- https://weapons.rupucs.in/api?action=filterWeapons&type=gg&name=Beretta
- https://weapons.rupucs.in/api?action=filterWeapons&type=gv&producer=Remington
- https://weapons.rupucs.in/api?action=filterWeapons&type=iv&use=sport,collection

Filter parameters: `name` (partial match), `producer` (partial match), `use` (comma-separated: self_defence, hunting, sport, collection)

### Metadata endpoints

- https://weapons.rupucs.in/api?action=lastTimeChanged&type=all — Last update timestamps
- https://weapons.rupucs.in/api?action=latestPdfs&type=all — Source PDF titles, download URLs, dates

### Response format

```json
{
  "info": "ok",
  "data": [
    {
      "image_thumbnail": "https://weapons.rupucs.in/weapons_images/gg/weapon1_.webp",
      "image_large": "https://weapons.rupucs.in/weapons_images/gg/weapon1_large.webp",
      "name": "BERETTA A400 XCEL",
      "producer": "FABBRICA D'ARMI P.BERETTA",
      "calibre": "12/76",
      "category": "B",
      "type": "garstobra gludstobra",
      "barrel_length": "760",
      "number_of_rounds": "3+1",
      "self_defence": 0,
      "hunting": 1,
      "sport": 1,
      "collection": 0
    }
  ],
  "pagination": {"index": 0, "count": 5}
}
```

### Iterating all data

To retrieve all weapons of a type, increment `index` from 0 until `index >= pagination.count`.

## Pages

- https://weapons.rupucs.in/lv — Landing page (Latvian)
- https://weapons.rupucs.in/en — Landing page (English)
- https://weapons.rupucs.in/lv/weapons-list/gg — Smoothbore firearms
- https://weapons.rupucs.in/lv/weapons-list/gv — Rifled firearms
- https://weapons.rupucs.in/lv/weapons-list/iv — Short-barreled firearms
- https://weapons.rupucs.in/lv/about — About the project
- https://weapons.rupucs.in/lv/api — API documentation

Note: The web pages are an Angular SPA. Crawlers without JavaScript support should use the API endpoints above for structured data.

## Languages

Available in Latvian (lv) and English (en). Replace /lv/ with /en/ in any URL.

## Author

Jānis Muižnieks — muiznieks@gmail.com