# Menjometre
> Independent observatory of public grants and contracts in Catalonia

## About
Menjometre tracks 28B+ EUR in public subsidies and contracts across 336,000+ entities in Catalonia (2016-2026). Data sources: RAISC (Catalan grants registry), BDNS (national grants), Contractes.cat (public contracts). Open source, built for public accountability.

## Key Pages
- Homepage: https://menjometre.cat
- Grant Rankings: https://menjometre.cat/subvencions
- Contract Rankings: https://menjometre.cat/contractes
- Methodology: https://menjometre.cat/metodologia
- Network Graph: https://menjometre.cat/xarxa
- Entity Detail: https://menjometre.cat/entitat/{slug}
- Person Profile: https://menjometre.cat/xarxa/persona/{name}
- Suggestions: https://menjometre.cat/suggeriments

## Data
- 19.5M grant records from RAISC (2016-2026)
- 1.7M contract records from Contractes.cat (2015-2026)
- 300K BDNS records (national grants, 2022-present)
- 336,000+ beneficiary entities tracked
- Scoring algorithm: volume, concentration, recurrence, dominance, accountability (5 components)

## Scoring
The Menjometre score (0-100) measures statistical patterns in public fund distribution. It is NOT an indicator of irregularity. Components: volume (total amount percentile), concentration (department HHI), recurrence (consecutive grant years), dominance (share of any purpose category), accountability (registry presence, filed accounts, grant dependency). Entities need 3+ grants and 5,000+ EUR to be scored.

## Language
Primary language: Catalan (ca). All UI and content in Catalan.

## Public API
All endpoints return JSON with CORS enabled (Access-Control-Allow-Origin: *).

- GET /api/search?q={query} — Search entities by name or CIF (max 8 results)
- GET /api/entity/{identifier} — Full entity profile. Identifier: CIF, slug, or name. Returns scores, grants, contracts, equivalencies, rank.
- GET /api/top?limit=10&sort_by=score&type=all&year=2024 — Ranked entity list. sort_by: score|amount|contracts. type: all|premsa|tercer_sector. year: filter by active year. Max 100.
- GET /api/stats — Dataset summary (totals, scored entities, date range, last sync)
- GET /api/equivalencies?amount=5000000 — Convert EUR amount to public service equivalencies (teachers, nurses, schools, etc.)
- GET /api/export?format=json — Bulk entity export (up to 10K entities with scores). format: json|csv
- GET /api/export/entity?identifier={slug}&type=grants&year=2024 — Per-entity grant/contract list. type: grants|contracts. year: optional filter.

## Source Code
https://gitlab.com/menjometre/menjometre (AGPL-3.0)