Methodology
Last updated: 2026-09-25The facts on Open America come from government sources. Vote tallies, bill text, sponsorship, committee assignments, floor activity, and lobbying disclosures are all pulled from official public feeds. We do not buy data from vendors, and we do not invent it. If you want to check a figure, this page tells you where it came from and how it was calculated.
We also use AI in a few clearly labeled places, covered in their own section below. It never produces the data or the statistics, only plain-language reading aids.
Data sources
Seven official, public sources. Most carry more than one feed.
- congress.gov API (v3). The bulk of the corpus: bills and resolutions, sponsors and cosponsors, amendments, committee assignments, member biographies, CRS plain-language summaries, policy areas, related-bill links, hearings, committee reports, nominations, and the Daily Congressional Record index.
- clerk.house.gov. Three feeds: the FloorSummary XML for live House floor activity, the EVS XML for House roll-call votes with each member's position, and the official member Demographics PDFs (background such as prior military service, medical and legal professions, and freshman status).
- senate.gov. The roll-call vote menu and the per-vote XML for each Senate roll call (per-senator positions, party tallies, question text), the per-day floor-activity XML (the Senate's end-of-day record of business), and committee membership rosters. Some senate.gov endpoints block automated access by network address, so we fetch those through a thin proxy that forwards only to specific senate.gov paths.
- whitehouse.gov OMB. Statements of Administration Policy. The White House's formal position on a pending bill, shown on that bill's page.
- govinfo.gov. The Daily Congressional Record archive, which is the full floor transcript.
- lda.gov. Federal Lobbying Disclosure Act filings: who is lobbying, for which client, on which bills, and on what issues. We link the bills named in a filing back to their pages, and a filing back to the bills it names.
- The House Clerk's election statistics. The certified result of each House general election, from the Clerk's "Statistics of the Presidential and Congressional Election" (for 2024, published March 10, 2025). A member page shows how that member won the seat in 2024 (share of the vote and the margin over the runner-up, a fusion candidate's party lines added together) only when the 2024 winner is that member; the district map shows a seat's 2024 result except in the nine states that drew new lines for 2026.
- efdsearch.senate.gov. The Senate's electronic financial disclosure system: every periodic transaction report a senator has filed since January 2025. E-filed reports are read into the trades explorer row by row as filed; paper filings are linked, not read; an amended report is replaced by its amendment. Use of these reports is limited by 5 U.S.C. 13107(c), and Open America shows them free, for public information only. Refreshed daily.
- api.open.fec.gov. The Federal Election Commission's campaign finance totals for each member's principal campaign committee in the current two-year cycle: money raised, money spent, cash on hand, itemized gifts from individuals and money from PACs and other political committees, with the date the reports run through. Totals only: no individual contributor is named anywhere on the site. Refreshed daily.
- State election offices. On election night the district map and the Senate board show counts published by the secretaries of state and state election boards that offer a machine-readable feed. The numbers are passed through as published: no race is called, nothing is projected, and a state with no feed is shown as having none. The same feed is a free public JSON API, documented at Election results API, which names the states covered.
Where AI is and isn't used
No number on Open America is produced by a model. Vote counts, party-unity percentages, and every other statistic are computed directly from the government feeds. AI is used in three places, each labeled where it appears:
- Bill summaries. For some bills we generate a short plain-language summary. The model is given only the bill's own title, status, and official summary, and is told to summarize that and add nothing else.
- Ask about a bill. An optional question box on bill pages, answered from that bill's text. It runs only when you ask.
- Constituent letters. An optional tool that drafts a letter for you to edit and send. It runs only when you start it.
If an AI summary or answer ever disagrees with the bill, the bill is right.
How often the data refreshes
While a chamber is in session, floor activity, roll-call votes and White House bill statements are re-checked every minute and new bills, committee meetings and hearings every five minutes; lobbying filings, House and Senate financial disclosures, committee rosters and FEC campaign totals refresh once a day, the Senate's daily floor record hourly through the evening, discharge petitions every six hours, and election results every five minutes from the state feeds once counting begins on November 3, and every minute through election night.
Both live passes check whether a chamber is actually in session first, so weekend, recess and overnight minutes cost almost nothing. The live floor page receives new actions as a push stream while the tab is open and falls back to a one-minute poll if the stream drops. How current each source is right now is on the status page; the same JSON the pages read is documented on the API page.
How every statistic is calculated
One definition per metric. The same source on every page where the metric appears.
Bills introduced (per legislator)
Count of bills and resolutions where the legislator is the sponsor, excluding amendments. Counts span the legislator's full congressional career, not just the current Congress.
Amendments are excluded so the count matches the list you see when you click in. They are tracked on their own and shown with the bill they amend.
Bills cosponsored (per legislator)
Count of bills where the legislator is a cosponsor, with the same amendment exclusion.
Party unity (per legislator)
Of all the legislator's recorded Yea and Nay positions, the share where they voted with their party's majority on that specific roll call. "Their party's majority" is the side (Yea or Nay) that drew more votes from the legislator's own party on that vote.
Independents are compared to the independent caucus rather than to D or R. Present and Not Voting positions are left out of the denominator. If a party splits evenly on a vote, that vote has no majority and does not count either way.
Missed votes (per legislator)
Share of roll calls during the legislator's service where they were recorded as Not Voting, out of the total roll calls during their service. Legislators who joined mid-Congress are not penalized for votes held before they were sworn in.
Vote tallies (Yea, Nay) on a roll call
The headline tally on a vote page is the official count from the clerk.house.gov or senate.gov XML. We separately store every individual member's position. The two reconcile exactly on every recent Senate vote we checked (verified 2026-06-05 across the most recent 50 Senate roll calls, zero discrepancies). If they ever disagree, the official chamber tally is canonical and the per-member data is treated as suspect.
Moving in Congress right now
Bills with floor activity or formal legislative action in the last 48 hours, ranked by most recent action first, then by how much activity they saw. It is cached for 5 minutes on the server. This is a live signal of what the chambers are doing, not a measure of popularity. Where the site shows what is "most watched," that reflects what Open America's own users have added to their watchlists recently, not an editorial pick.
Coverage
Bills and resolutions go back to the 94th Congress (1975). Recorded roll-call votes go back to the 101st Congress (1989). Coverage is deepest for the most recent Congresses, where every feed above is running live; older years are present but thinner. Lobbying filings cover recent years, with the heaviest coverage from 2023 onward.
What we don't have
The current gaps:
- No real-time Senate floor narrative. The Senate does not publish a minute-by-minute feed the way clerk.house.gov does. We ingest the Senate's per-day floor record after the chamber gavels out, and we show Senate roll-call votes within a few minutes of close. For a vote in progress we link to the senate.gov live stream.
- No campaign finance. We track federal lobbying disclosures (who lobbied on what), but not FEC contributions, donor data, or spending. OpenSecrets and FollowTheMoney do that well, and we link to them where it helps.
- No bills before 1975 or votes before 1989. Earlier records exist on congress.gov but are not in our ingestion yet.
- No state, local, or tribal legislatures. Open America covers the U.S. Congress only.
Errors and corrections
If a number on Open America disagrees with its upstream source (congress.gov, clerk.house.gov, senate.gov, lda.gov, the FEC), the upstream is right and we have a bug. Report it with the page URL and the specific figure. Data correctness is a top priority.
Citation and data use
Attribute figures as "Open America (openamerica.io)" and link back when the format allows, and for anything tied to a moment (live counts, as-of statistics) include the date and time of your snapshot. The statement below is the same text that appears on the API page, in the Terms of Service and in llms.txt.
Draft. This data-use statement is published for review and its wording may change before it is adopted.
Government records
Source records from congress.gov, the House Clerk (clerk.house.gov and disclosures-clerk.house.gov), senate.gov, lda.gov and whitehouse.gov are works of the United States government. Open America republishes them without any claim of copyright (17 U.S.C. 105) and adds no restriction of its own to them.
State election feeds
The election results on /elections/ come from official state election offices whose terms vary from state to state; at least one publishes its feed under a state copyright notice and marks its results unofficial. Those feeds are not part of any grant made here, and election results are never part of an export or bulk download.
What Open America adds
Open America's own derived fields (transactions parsed from PTR filings, lobbying-to-bill links, LD-203 honoree matches, bill lifecycle states, member statistics and AI summaries) may be used, quoted, republished and built on, for paid or unpaid work, with the attribution "Open America (openamerica.io)" and the date you retrieved the data, subject to the lobbying and disclosure notices below.
Lobbying data
Lobbying data comes from lda.gov, whose terms of service ask three things of anyone who reuses it: cite the date the data was retrieved; do not modify content and still cite it as LDA.gov; and state that "Senate Office of Public Records cannot vouch for the data or analyses derived from these data after the data have been retrieved from LDA.gov." Carry all three with any lobbying figure you take from this site.
Financial disclosures
Financial disclosure data (everything on /disclosures/ and /trades/, and anything derived from a House PTR filing) is subject to 5 U.S.C. 13107(c): a report may not be obtained or used for any commercial purpose other than by news and communications media for dissemination to the general public, to determine or establish anyone's credit rating, or in the solicitation of money for any political, charitable or other purpose, and the Attorney General may seek a penalty of up to $10,000 for a violation. Open America does not sell this data and it is not part of any paid plan.
Live feeds
Repackaging one of the live endpoints as your own API, or reselling the feed as it stands, needs a written agreement: write to [email protected]. There is no Creative Commons licence on the live endpoints; attribution and the notices here are the whole of the grant.
AI summaries
Summaries written by a model are labelled as AI-generated wherever they appear, on a page or in JSON, and where one disagrees with the bill, the bill is right.
References: 17 U.S.C. 105, lda.gov terms of service, 5 U.S.C. 13107.
Journalists and researchers who want help citing or pulling something specific can write to [email protected] and we will respond.