Access the dataset
Country snapshot filenames include their SHA-256 content hash and are immutable. The compact indexes use short revalidation, so applications can discover a new snapshot without refetching archives whose hash has not changed.
Static files
Country index points to each active snapshot. Data catalogue provides download, source and licence metadata without including the full poll arrays.
Versioned API
GET /api/v1/countries lists published archives. Country, polls and update endpoints support GET and HEAD, cross-origin reads and structured errors.
Updates
GET /api/v1/updates exposes the append-only change ledger. Human-readable updates and Atom, RSS and JSON feeds use the same records.
Snapshot schema version 1
Every snapshot is a complete country archive rather than a patch. Object keys are canonicalised before hashing, poll identities are stable, and all dates use ISO YYYY-MM-DD values.
Identity
schemaVersion- Currently
1. generatedAt- UTC snapshot generation time.
contentHash- SHA-256 of the canonical snapshot content.
country- Stable slug, display name, aliases and map name.
Archive context
elections- Dated elections and sourced next-election status.
coverageGaps- Declared archive gaps with explanatory sources.
blocPeriods- Time-bounded sourced local-balance definitions.
sources- Snapshot-level compilation sources, provenance and licence evidence.
Poll records
idp_plus 16 SHA-256 hexadecimal characters.start/end- Fieldwork dates; charts use their midpoint.
pollster- Normalised published pollster label.
sample- Integer sample size or
null. source- Recorded public source URL for that row.
values- Party-keyed percentages; unavailable values are
null.
Derived metadata
parties- Stable keys, display labels and colours.
summary- Descriptive current balance and 30-day movement.
archive- Poll count, boundaries and source coverage date.
quality- Publication permission, licence status and validation warnings.
The local balance fields are navigation aids, not internationally equivalent ideological measures. Polling records are descriptive observations, not forecasts.
Country downloads
Only archives whose source licence and attribution have passed publication validation appear here.
Licence and attribution register
Each compilation source remains subject to its own licence. Bismuth records those terms and required attribution but does not relicense underlying source material. Source records describe the snapshot as a whole; they are not necessarily the original report for every poll row.