get_election_results

tech.dataporium/mcp · Verify this server

US election results with margins, swing, turnout and partisan lean. Coverage: president and US Senate by state for every election 1976 to 2024, US House by district 1976 to 2024 and county results of the presidential race 2000 to 2024; county, city or town, congressional district and precinct results, governors, other statewide offices, state legislature seats and statewide ballot measures for 2016, 2018, 2020, 2022 and 2024. Results are certified; election-night rows (status live) are unofficial counts and a race is only called when called_at is set. party_margin/rd_margin_pct = Republican share minus Democratic share in points (positive = Republican lead, R+3.2 means Republicans led by 3.2 points); swing_pct is the change of that margin against the previous comparable race in the same area (positive = toward Republicans); flipped = the winning party changed. view "races" (default): races with winner or leader, runner-up, votes and shares, margin, swing, flip; filter by year, office (president, us_senate, us_house, governor, lt_governor, attorney_general, secretary_of_state, treasurer, other_statewide, state_senate, state_house, ballot_measure, judicial; several with commas), state (two-letter code), name (race or candidate text) and filters such as {"margin_max": 5} (close races), {"flipped": true}, {"winner_party": "R"}, {"status": "live"}. Each row has race_id: use it as `race` in view "results". view "results": one race (race = race_id such as "2024-president", "2024-us-senate-tx", "2022-governor-az") with every candidate (votes and share) and the result by area: level state, county, cousub (city or town), cd (district) or precinct (precinct needs county = 5-digit code); state limits to a state; name searches area names; sort total_votes, rd_margin, swing, dem_pct, rep_pct, turnout or name. view "candidates": people who ran: name, state, office, year, filters {"party": "D", "won": true, "in_congress": true}; with slug (from a candidate row) one candidate with every race. view "geography": one area with its races, partisan lean, bellwether record, split tickets, turnout and demographics: level state, county, cousub, cd or national and area_code (state: 2-digit code such as 48; county: 5-digit code such as 48453), or for a county give state and county name instead of area_code. view "area": the latest elections for a state, county (name) and/or city in one call (state, county, city). view "summary": analysis = trend (national presidential vote by year), seats (seats won by party and change), legislatures (control of state legislature chambers), flips and swing (areas that changed party or moved most; year, office, level state or county), bellwethers, split_tickets, lean (partisan lean index), demographics (county results next to income, education, age and race) or coverage (what is loaded). view "turnout": turnout by state or county and year (share of citizen voting-age adults, registered voters where reported); level state or county, state, name, filters {"min_turnout": 60}. On election night the answer also has election_night_note ("Election night: unofficial, still counting, last update HH:MM UTC"): share it; live rows are only ever "Leading" (leader_label), never a winner. The answer has website_link: share it so the user can see the pages on dataporium.tech.