Skip to content

Source Coverage

This page is the single canonical surface for what PolitiClaw actually covers today. The per-provider matrix lives on the generated source coverage page; this page indexes coverage by user goal and names the blind spots directly.

Coverage by user goal

Bills and votes

Federal bills are wired through api.congress.gov via the shared apiDataGov key, and the scoring path maps bills to declared issue stances. Roll-call vote coverage spans both chambers: House votes through api.congress.gov (tier 1) and Senate votes through voteview.com (tier 2, zero-key). Rep scoring, vote alerts, and upcoming-vote snapshots reflect both chambers once politiclaw_ingest_votes has been run.

Representatives

politiclaw_get_my_reps resolves your US House member and both US Senators, either through the zero-key local shapefile pipeline or the optional Geocodio upgrade. Current rep coverage stops at US House and US Senate. Municipal, county, and state-legislative offices are not resolved.

Ballots and elections

Ballot and election logistics come from Google Civic's voterInfoQuery, gated on the optional googleCivic key. Ballots come from Google Civic only, with generic contest shape. Judicial retention detail and ballot-measure plain-language enrichment are not wired.

Candidate research

politiclaw_research_finance reads FEC OpenFEC through the shared apiDataGov key for candidate and committee finance totals (mode='candidate') and side-by-side challenger comparison (mode='challengers'). Deeper enrichment — donor industries, revolving-door context, state-level finance — is not wired; see the generated matrix for the full status of optional finance providers.

What is not covered today

  • State legislatures: Current coverage is federal only. State bills, state roll-call votes, and state legislators are out of scope for the wired runtime.
  • Local representatives: Current rep coverage stops at US House and US Senate. Municipal, county, and state-legislative offices are not resolved.
  • Down-ballot depth: Ballots come from Google Civic only, with generic contest shape. Judicial retention detail and ballot-measure plain-language enrichment are not wired.

Per-provider matrix

When you need the exact provider status (implemented, optional_upgrade, transport_pending), config keys, and runtime file paths, use the generated pages:

The schema only declares named keys for providers that are actually wired. For providers planned but not yet wired (state bills, state finance), see the Roadmap section of the plugin README. Unknown legacy key strings may still validate so older configs keep loading, but they are ignored by runtime adapters.

Built for people who want local-first political tooling.