Methodology

This page explains how ThePolitibase aggregates, processes, and displays congressional data. We document our methodology so you can evaluate our work and so journalists citing us can understand the underlying mechanics.

Data update frequency

  • Member roster: Refreshed every 6 hours from Congress.gov + unitedstates.io.
  • Bills: Refreshed continuously; bill detail pages cache for 1 hour.
  • Senate floor votes: Pulled directly from senate.gov XML on each request, cached 30 minutes.
  • House floor votes: Pulled from Congress.gov + clerk.house.gov XML, cached 30 minutes.
  • Campaign finance: Pulled from OpenFEC and cached six hours per candidate, with a background warmer running every fifteen minutes — so figures are usually a few hours old at most.
  • Policy area / legislative subjects: Warmed continuously in the background from Congress.gov. CRS does not change a bill’s policy area once assigned, so in practice each one is fetched once and reused.

Vote outcome classification

We don’t simply compare yeas to nays. Some votes have higher thresholds:

  • Cloture motions: Need 60 yeas to pass, regardless of nay count.
  • Treaty ratifications and constitutional amendment proposals: Need two-thirds.
  • Veto overrides: Need two-thirds in each chamber.

When these thresholds aren’t met, we display a clarifying note next to the vote (e.g., “Did not reach 60-vote cloture threshold”).

Vote result text

We use the official Senate and House result strings (“Cloture Invoked,” “Confirmed,” “Motion Rejected,” etc.) when available. We fall back to a tally-based heuristic only when the official result string is missing.

Bill status stages

Bills move through one or more of these stages, in order:

  1. Introduced
  2. In Committee
  3. Out of Committee (reported)
  4. Passed One Chamber
  5. Passed Both Chambers
  6. Awaiting Signature
  7. Signed Into Law (or Vetoed)

We classify the current stage based on the most advanced action recorded in Congress.gov. A vetoed bill does not become law unless the veto is overridden.

Member alignment scores

When we report a member’s “party alignment” percentage, that is the share of recent recorded votes on which they voted with their party majority. We exclude unanimous votes (where alignment is meaningless) and procedural quorum/journal votes.

What we don’t claim

We do not claim to capture every committee meeting, every press release, every speech, or every district event. We track what Congress publishes through its official APIs. If a member claims an action that isn’t in Congress.gov, we don’t show it.

If you find an error or have a methodology question, please report it.

Last revised 9 September 2026. This page describes how the site works; the data it describes refreshes on the schedules above, independently of when this text was last edited.