--- type: "firecrawl-provider" description: "civicAPI (civicapi.org), a free keyless election results API. Live US election-night results for the 3 November 2026 midterms (and other dates): every US Senate, US House and governor race with candidates, parties, votes, percentages, share reporting and winner calls, the nationwide seat tally per chamber, one race in full with county breakdown, and civicAPI's own Monte Carlo forecast of Senate, House and governor control with per-race ratings. Counts are unofficial until certified. Attribution to civicAPI is required by its terms." use_when: "civicAPI (civicapi.org), a free keyless election results API. Live US election-night results for the 3 November 2026 midterms (and other dates): every US Senate, US House and governor race with candidates, parties, votes, percentages, share reporting and winner calls, the nationwide seat tally per chamber, one race in full with county breakdown, and civicAPI's own Monte Carlo forecast of Senate, House and governor control with per-race ratings. Counts are unofficial until certified. Attribution to civicAPI is required by its terms." categories: "Public records" capabilities: 3 credits_per_call: 5 --- # civicAPI live election results and forecasts on Firecrawl Alexandria civicAPI (civicapi.org), a free keyless election results API. Live US election-night results for the 3 November 2026 midterms (and other dates): every US Senate, US House and governor race with candidates, parties, votes, percentages, share reporting and winner calls, the nationwide seat tally per chamber, one race in full with county breakdown, and civicAPI's own Monte Carlo forecast of Senate, House and governor control with per-race ratings. Counts are unofficial until certified. Attribution to civicAPI is required by its terms. - Categories: Public records - Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records) - Provider key: `civicapi-org` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/civicapi-org) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/civicapi-org/openapi.json) ## Capabilities - [Forecast](https://firecrawl.dev/alexandria/agents/providers/civicapi-org/elections/forecast): civicAPI's own 2026 forecast for a chamber (senate, house or governor): Monte Carlo simulation summary (expected seats, percentiles, majority probabilities), rating totals, majority rating, seat distribution, input weights, House popular-vote and generic-ballot estimates, and per-race ratings with projected vote shares and candidates, optionally for one state. One GET of /api/v2/forecast/{chamber}/2026/civicapi. - [Live results](https://firecrawl.dev/alexandria/agents/providers/civicapi-org/elections/live_results): Live results of every race of a chamber (senate, house or governor) on an election date, nationwide or for one state, from one civicAPI race search: candidates, parties, votes, percent, share reporting, called/winner and current leader, plus counts of called and reporting races, calls by party and civicAPI's nationwide seat tally. chamber all lists every race on the ballot in one state (state legislature, statewide offices, ballot measures). Date defaults to 2026-11-03. - [Race](https://firecrawl.dev/alexandria/agents/providers/civicapi-org/elections/race): One civicAPI race in full: every candidate with party, votes, percent, incumbency, winner and runoff flags, share reporting, poll open and close times, last update, test-data and disputed flags, and optionally the county or district breakdown. One GET of /api/v2/race/{id}. ## 1. Choose this provider when civicAPI (civicapi.org), a free keyless election results API. Live US election-night results for the 3 November 2026 midterms (and other dates): every US Senate, US House and governor race with candidates, parties, votes, percentages, share reporting and winner calls, the nationwide seat tally per chamber, one race in full with county breakdown, and civicAPI's own Monte Carlo forecast of Senate, House and governor control with per-race ratings. Counts are unofficial until certified. Attribution to civicAPI is required by its terms. ## 2. Minimal request Call `POST https://api.firecrawl.dev/v2/scrape` with `{ alexandria: { provider, capability, options } }`. For a batch, send `{ alexandria: [...] }` with up to 10 calls. ```json { "provider": "civicapi-org", "capability": "elections/forecast", "options": { "chamber": "senate" } } ``` ## 3. Add provider options Use only the options needed for the task: - `chamber` (string, required): Which forecast. Example: `senate` - `state` (string): Only ratings for this state (two letters). Totals and simulations stay national. Pattern: ^[A-Za-z]{2}$. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "civicapi-org", capability: "elections/forecast", options: { chamber: "senate", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "civicapi-org", "capability": "elections/forecast", "options": { "chamber": "senate" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "civicapi-org", "capability": "elections/forecast", "options": { "chamber": "senate" } } }' ``` ### CLI ```sh firecrawl scrape 'civicapi-org/elections/forecast' \ --options '{"chamber":"senate"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "civicapi-org", "capability": "elections/forecast", "options": { "chamber": "senate" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "civicapi-org", "capability": "elections/forecast", "options": { "chamber": "senate" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "attribution": "Results and forecasts from civicAPI (https://civicapi.org)", "chamber": "senate", "count": 35, "factor_weights": { "betting_markets": 0.2, "expert_ratings": 0.2, "fundraising": 0.1, "outside_spending": 0.1, "polls": 0.2 }, "forecaster": "civicAPI", "last_updated": "2026-11-03", "majority_rating": "Safe D", "monte_carlo": { "democrat_seats_p5": 59, "democrat_seats_p50": 63, "democrat_seats_p95": 66, "expected_democrat_seats": 62.7, "expected_republican_seats": 62.8, "majority_threshold": 51, "prob_democrat_majority": 100, "prob_republican_majority": 100, "republican_seats_p5": 59, "republican_seats_p50": 63, "republican_seats_p95": 67, "simulations": 65000 }, "national": null, "observed_at_ms": 1793720565648, "ratings": [ { "democrat_pct": 62.2, "democratic_candidate": "Mary Peltola", "district": null, "incumbent_party": "R", "independent_candidate": "Sidney “Sid” Hill", "independent_pct": 0.1, "key": "AK", "rating": "Tilt D", "republican_candidate": null, "republican_pct": 37.7, "state": "AK" }, { "democrat_pct": 5.3, "democratic_candidate": "Everett Wess", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "AL", "rating": "Safe R", "republican_candidate": "Barry Moore", "republican_pct": 94.7, "state": "AL" }, { "democrat_pct": 7.7, "democratic_candidate": "Hallie Shoffner", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "AR", "rating": "Safe R", "republican_candidate": "Tom Cotton", "republican_pct": 92.3, "state": "AR" }, { "democrat_pct": 98.7, "democratic_candidate": "John Hickenlooper", "district": null, "incumbent_party": "D", "independent_candidate": "Donald Willoughby", "independent_pct": 0, "key": "CO", "rating": "Safe D", "republican_candidate": null, "republican_pct": 1.3, "state": "CO" }, { "democrat_pct": 98.5, "democratic_candidate": "Chris Coons", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "DE", "rating": "Safe D", "republican_candidate": "Michael \"Dr. Mike\" Katz", "republican_pct": 1.5, "state": "DE" }, { "democrat_pct": 17.3, "democratic_candidate": "Angie Nixon", "district": null, "incumbent_party": "R", "independent_candidate": "Neil J. Gillespie", "independent_pct": 0, "key": "FL", "rating": "Likely R", "republican_candidate": "Ashley Moody", "republican_pct": 82.7, "state": "FL" }, { "democrat_pct": 84.2, "democratic_candidate": "Jon Ossoff", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "GA", "rating": "Likely D", "republican_candidate": "Mike Collins", "republican_pct": 15.8, "state": "GA" }, { "democrat_pct": 50.8, "democratic_candidate": "Josh Turek", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "IA", "rating": "Tossup", "republican_candidate": "Ashley Hinson", "republican_pct": 49.2, "state": "IA" }, { "democrat_pct": 5.8, "democratic_candidate": null, "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 2.2, "key": "ID", "rating": "Safe R", "republican_candidate": "Jim Risch", "republican_pct": 92, "state": "ID" }, { "democrat_pct": 92, "democratic_candidate": "Juliana Stratton", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "IL", "rating": "Safe D", "republican_candidate": "Don Tracy", "republican_pct": 8, "state": "IL" }, { "democrat_pct": 43, "democratic_candidate": "Adam Hamilton", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "KS", "rating": "Tossup", "republican_candidate": "Roger Marshall", "republican_pct": 57, "state": "KS" }, { "democrat_pct": 13.2, "democratic_candidate": "Charles Booker", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "KY", "rating": "Likely R", "republican_candidate": "Andy Barr", "republican_pct": 86.8, "state": "KY" }, { "democrat_pct": 8, "democratic_candidate": "Jamie Davis", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "LA", "rating": "Safe R", "republican_candidate": "Julia Letlow", "republican_pct": 92, "state": "LA" }, { "democrat_pct": 98, "democratic_candidate": "Edward J. Markey", "district": null, "incumbent_party": "D", "independent_candidate": "Shiva Ayyadurai", "independent_pct": 0, "key": "MA", "rating": "Safe D", "republican_candidate": "John Deaton", "republican_pct": 2, "state": "MA" }, { "democrat_pct": 58.4, "democratic_candidate": "Troy Jackson", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "ME", "rating": "Tossup", "republican_candidate": "Susan Collins", "republican_pct": 41.6, "state": "ME" }, { "democrat_pct": 61.3, "democratic_candidate": "Abdul El-Sayed", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "MI", "rating": "Tilt D", "republican_candidate": "Mike Rogers", "republican_pct": 38.7, "state": "MI" }, { "democrat_pct": 80, "democratic_candidate": "Peggy Flanagan", "district": null, "incumbent_party": "D", "independent_candidate": "Marisa Simonetti", "independent_pct": 0, "key": "MN", "rating": "Likely D", "republican_candidate": "Michele Tafoya", "republican_pct": 20, "state": "MN" }, { "democrat_pct": 8, "democratic_candidate": "Scott Colom", "district": null, "incumbent_party": "R", "independent_candidate": "Ty Pinkins", "independent_pct": 0, "key": "MS", "rating": "Safe R", "republican_candidate": "Cindy Hyde-Smith", "republican_pct": 92, "state": "MS" }, { "democrat_pct": 0.6, "democratic_candidate": "Alani Bankhead", "district": null, "incumbent_party": "R", "independent_candidate": "Seth Bodnar", "independent_pct": 7.4, "key": "MT", "rating": "Safe R", "republican_candidate": "Kurt Alme", "republican_pct": 92, "state": "MT" }, { "democrat_pct": 76.2, "democratic_candidate": "Roy Cooper", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "NC", "rating": "Lean D", "republican_candidate": "Michael Whatley", "republican_pct": 23.8, "state": "NC" }, { "democrat_pct": 1.9, "democratic_candidate": null, "district": null, "incumbent_party": "R", "independent_candidate": "Dan Osborn", "independent_pct": 39.7, "key": "NE", "rating": "Tossup", "republican_candidate": "Pete Ricketts", "republican_pct": 58.4, "state": "NE" }, { "democrat_pct": 69.3, "democratic_candidate": "Chris Pappas", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "NH", "rating": "Tilt D", "republican_candidate": "John E. Sununu", "republican_pct": 30.7, "state": "NH" }, { "democrat_pct": 98.8, "democratic_candidate": "Cory Booker", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "NJ", "rating": "Safe D", "republican_candidate": "Justin Murphy", "republican_pct": 1.2, "state": "NJ" }, { "democrat_pct": 95.7, "democratic_candidate": "Ben Ray Luján", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "NM", "rating": "Safe D", "republican_candidate": "Larry Marker", "republican_pct": 4.3, "state": "NM" }, { "democrat_pct": 55.6, "democratic_candidate": "Sherrod Brown", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "OH", "rating": "Tossup", "republican_candidate": "Jon Husted", "republican_pct": 44.4, "state": "OH" }, { "democrat_pct": 1.4, "democratic_candidate": "N'Kiyla Jasmine Thomas", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "OK", "rating": "Safe R", "republican_candidate": "Kevin Hern", "republican_pct": 98.6, "state": "OK" }, { "democrat_pct": 82.3, "democratic_candidate": "Jeff Merkley", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "OR", "rating": "Likely D", "republican_candidate": "David Brock Smith", "republican_pct": 17.7, "state": "OR" }, { "democrat_pct": 97.4, "democratic_candidate": "John F. Reed", "district": null, "incumbent_party": "D", "independent_candidate": "Michael Bahry", "independent_pct": 0, "key": "RI", "rating": "Safe D", "republican_candidate": "Raymond T. McKay", "republican_pct": 2.6, "state": "RI" }, { "democrat_pct": 26.4, "democratic_candidate": "Annie Andrews", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "SC", "rating": "Lean R", "republican_candidate": "Darline Graham", "republican_pct": 73.6, "state": "SC" }, { "democrat_pct": 0.2, "democratic_candidate": null, "district": null, "incumbent_party": "R", "independent_candidate": "Brian Bengs", "independent_pct": 5.1, "key": "SD", "rating": "Safe R", "republican_candidate": "Mike Rounds", "republican_pct": 94.7, "state": "SD" }, { "democrat_pct": 1.3, "democratic_candidate": "Marquita Bradshaw", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "TN", "rating": "Safe R", "republican_candidate": "Bill Hagerty", "republican_pct": 98.7, "state": "TN" }, { "democrat_pct": 68.7, "democratic_candidate": "James Talarico", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "TX", "rating": "Tilt D", "republican_candidate": "Ken Paxton", "republican_pct": 31.3, "state": "TX" }, { "democrat_pct": 98.2, "democratic_candidate": "Mark Warner", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "VA", "rating": "Safe D", "republican_candidate": "Bert Mizusawa", "republican_pct": 1.8, "state": "VA" }, { "democrat_pct": 1.4, "democratic_candidate": "Rachel Fetty Anderson", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "WV", "rating": "Safe R", "republican_candidate": "Shelley Moore Capito", "republican_pct": 98.6, "state": "WV" }, { "democrat_pct": 1.6, "democratic_candidate": "James W. Byrd", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "WY", "rating": "Safe R", "republican_candidate": "Harriet Hageman", "republican_pct": 98.4, "state": "WY" } ], "seat_distribution": [ { "democrat_seats": 53, "probability_pct": 0 }, { "democrat_seats": 54, "probability_pct": 0.01 }, { "democrat_seats": 55, "probability_pct": 0.06 }, { "democrat_seats": 56, "probability_pct": 0.22 }, { "democrat_seats": 57, "probability_pct": 0.85 }, { "democrat_seats": 58, "probability_pct": 2.15 }, { "democrat_seats": 59, "probability_pct": 4.81 }, { "democrat_seats": 60, "probability_pct": 8.57 }, { "democrat_seats": 61, "probability_pct": 13.12 }, { "democrat_seats": 62, "probability_pct": 16.79 }, { "democrat_seats": 63, "probability_pct": 17.42 }, { "democrat_seats": 64, "probability_pct": 15.08 }, { "democrat_seats": 65, "probability_pct": 10.61 }, { "democrat_seats": 66, "probability_pct": 6.1 }, { "democrat_seats": 67, "probability_pct": 2.82 }, { "democrat_seats": 68, "probability_pct": 1 }, { "democrat_seats": 69, "probability_pct": 0.32 }, { "democrat_seats": 70, "probability_pct": 0.06 }, { "democrat_seats": 71, "probability_pct": 0.01 }, { "democrat_seats": 72, "probability_pct": 0 }, { "democrat_seats": 73, "probability_pct": 0 } ], "source_url": "https://civicapi.org/api/v2/forecast/senate/2026/civicapi", "state": null, "totals": { "democrat": 62, "independent": 0, "republican": 59, "tossup": 5 }, "year": 2026 } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Forecast - Capability: `elections/forecast` - Description: civicAPI's own 2026 forecast for a chamber (senate, house or governor): Monte Carlo simulation summary (expected seats, percentiles, majority probabilities), rating totals, majority rating, seat distribution, input weights, House popular-vote and generic-ballot estimates, and per-race ratings with projected vote shares and candidates, optionally for one state. One GET of /api/v2/forecast/{chamber}/2026/civicapi. - Instructions: Pre-results expectations or context next to live_results: who is favoured to control the Senate or House, and how a given race is rated. - Cost: 5 credits per call - Capability file: [Forecast](https://firecrawl.dev/alexandria/agents/providers/civicapi-org/elections/forecast) Accepted options: - `chamber` (string, required): Which forecast. Example: `senate` - `state` (string): Only ratings for this state (two letters). Totals and simulations stay national. Pattern: ^[A-Za-z]{2}$. Example: `` Response schema example: ```json { "attribution": "Results and forecasts from civicAPI (https://civicapi.org)", "chamber": "senate", "count": 35, "factor_weights": { "betting_markets": 0.2, "expert_ratings": 0.2, "fundraising": 0.1, "outside_spending": 0.1, "polls": 0.2 }, "forecaster": "civicAPI", "last_updated": "2026-11-03", "majority_rating": "Safe D", "monte_carlo": { "democrat_seats_p5": 59, "democrat_seats_p50": 63, "democrat_seats_p95": 66, "expected_democrat_seats": 62.7, "expected_republican_seats": 62.8, "majority_threshold": 51, "prob_democrat_majority": 100, "prob_republican_majority": 100, "republican_seats_p5": 59, "republican_seats_p50": 63, "republican_seats_p95": 67, "simulations": 65000 }, "national": null, "observed_at_ms": 1793720565648, "ratings": [ { "democrat_pct": 62.2, "democratic_candidate": "Mary Peltola", "district": null, "incumbent_party": "R", "independent_candidate": "Sidney “Sid” Hill", "independent_pct": 0.1, "key": "AK", "rating": "Tilt D", "republican_candidate": null, "republican_pct": 37.7, "state": "AK" }, { "democrat_pct": 5.3, "democratic_candidate": "Everett Wess", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "AL", "rating": "Safe R", "republican_candidate": "Barry Moore", "republican_pct": 94.7, "state": "AL" }, { "democrat_pct": 7.7, "democratic_candidate": "Hallie Shoffner", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "AR", "rating": "Safe R", "republican_candidate": "Tom Cotton", "republican_pct": 92.3, "state": "AR" }, { "democrat_pct": 98.7, "democratic_candidate": "John Hickenlooper", "district": null, "incumbent_party": "D", "independent_candidate": "Donald Willoughby", "independent_pct": 0, "key": "CO", "rating": "Safe D", "republican_candidate": null, "republican_pct": 1.3, "state": "CO" }, { "democrat_pct": 98.5, "democratic_candidate": "Chris Coons", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "DE", "rating": "Safe D", "republican_candidate": "Michael \"Dr. Mike\" Katz", "republican_pct": 1.5, "state": "DE" }, { "democrat_pct": 17.3, "democratic_candidate": "Angie Nixon", "district": null, "incumbent_party": "R", "independent_candidate": "Neil J. Gillespie", "independent_pct": 0, "key": "FL", "rating": "Likely R", "republican_candidate": "Ashley Moody", "republican_pct": 82.7, "state": "FL" }, { "democrat_pct": 84.2, "democratic_candidate": "Jon Ossoff", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "GA", "rating": "Likely D", "republican_candidate": "Mike Collins", "republican_pct": 15.8, "state": "GA" }, { "democrat_pct": 50.8, "democratic_candidate": "Josh Turek", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "IA", "rating": "Tossup", "republican_candidate": "Ashley Hinson", "republican_pct": 49.2, "state": "IA" }, { "democrat_pct": 5.8, "democratic_candidate": null, "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 2.2, "key": "ID", "rating": "Safe R", "republican_candidate": "Jim Risch", "republican_pct": 92, "state": "ID" }, { "democrat_pct": 92, "democratic_candidate": "Juliana Stratton", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "IL", "rating": "Safe D", "republican_candidate": "Don Tracy", "republican_pct": 8, "state": "IL" }, { "democrat_pct": 43, "democratic_candidate": "Adam Hamilton", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "KS", "rating": "Tossup", "republican_candidate": "Roger Marshall", "republican_pct": 57, "state": "KS" }, { "democrat_pct": 13.2, "democratic_candidate": "Charles Booker", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "KY", "rating": "Likely R", "republican_candidate": "Andy Barr", "republican_pct": 86.8, "state": "KY" }, { "democrat_pct": 8, "democratic_candidate": "Jamie Davis", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "LA", "rating": "Safe R", "republican_candidate": "Julia Letlow", "republican_pct": 92, "state": "LA" }, { "democrat_pct": 98, "democratic_candidate": "Edward J. Markey", "district": null, "incumbent_party": "D", "independent_candidate": "Shiva Ayyadurai", "independent_pct": 0, "key": "MA", "rating": "Safe D", "republican_candidate": "John Deaton", "republican_pct": 2, "state": "MA" }, { "democrat_pct": 58.4, "democratic_candidate": "Troy Jackson", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "ME", "rating": "Tossup", "republican_candidate": "Susan Collins", "republican_pct": 41.6, "state": "ME" }, { "democrat_pct": 61.3, "democratic_candidate": "Abdul El-Sayed", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "MI", "rating": "Tilt D", "republican_candidate": "Mike Rogers", "republican_pct": 38.7, "state": "MI" }, { "democrat_pct": 80, "democratic_candidate": "Peggy Flanagan", "district": null, "incumbent_party": "D", "independent_candidate": "Marisa Simonetti", "independent_pct": 0, "key": "MN", "rating": "Likely D", "republican_candidate": "Michele Tafoya", "republican_pct": 20, "state": "MN" }, { "democrat_pct": 8, "democratic_candidate": "Scott Colom", "district": null, "incumbent_party": "R", "independent_candidate": "Ty Pinkins", "independent_pct": 0, "key": "MS", "rating": "Safe R", "republican_candidate": "Cindy Hyde-Smith", "republican_pct": 92, "state": "MS" }, { "democrat_pct": 0.6, "democratic_candidate": "Alani Bankhead", "district": null, "incumbent_party": "R", "independent_candidate": "Seth Bodnar", "independent_pct": 7.4, "key": "MT", "rating": "Safe R", "republican_candidate": "Kurt Alme", "republican_pct": 92, "state": "MT" }, { "democrat_pct": 76.2, "democratic_candidate": "Roy Cooper", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "NC", "rating": "Lean D", "republican_candidate": "Michael Whatley", "republican_pct": 23.8, "state": "NC" }, { "democrat_pct": 1.9, "democratic_candidate": null, "district": null, "incumbent_party": "R", "independent_candidate": "Dan Osborn", "independent_pct": 39.7, "key": "NE", "rating": "Tossup", "republican_candidate": "Pete Ricketts", "republican_pct": 58.4, "state": "NE" }, { "democrat_pct": 69.3, "democratic_candidate": "Chris Pappas", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "NH", "rating": "Tilt D", "republican_candidate": "John E. Sununu", "republican_pct": 30.7, "state": "NH" }, { "democrat_pct": 98.8, "democratic_candidate": "Cory Booker", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "NJ", "rating": "Safe D", "republican_candidate": "Justin Murphy", "republican_pct": 1.2, "state": "NJ" }, { "democrat_pct": 95.7, "democratic_candidate": "Ben Ray Luján", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "NM", "rating": "Safe D", "republican_candidate": "Larry Marker", "republican_pct": 4.3, "state": "NM" }, { "democrat_pct": 55.6, "democratic_candidate": "Sherrod Brown", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "OH", "rating": "Tossup", "republican_candidate": "Jon Husted", "republican_pct": 44.4, "state": "OH" }, { "democrat_pct": 1.4, "democratic_candidate": "N'Kiyla Jasmine Thomas", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "OK", "rating": "Safe R", "republican_candidate": "Kevin Hern", "republican_pct": 98.6, "state": "OK" }, { "democrat_pct": 82.3, "democratic_candidate": "Jeff Merkley", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "OR", "rating": "Likely D", "republican_candidate": "David Brock Smith", "republican_pct": 17.7, "state": "OR" }, { "democrat_pct": 97.4, "democratic_candidate": "John F. Reed", "district": null, "incumbent_party": "D", "independent_candidate": "Michael Bahry", "independent_pct": 0, "key": "RI", "rating": "Safe D", "republican_candidate": "Raymond T. McKay", "republican_pct": 2.6, "state": "RI" }, { "democrat_pct": 26.4, "democratic_candidate": "Annie Andrews", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "SC", "rating": "Lean R", "republican_candidate": "Darline Graham", "republican_pct": 73.6, "state": "SC" }, { "democrat_pct": 0.2, "democratic_candidate": null, "district": null, "incumbent_party": "R", "independent_candidate": "Brian Bengs", "independent_pct": 5.1, "key": "SD", "rating": "Safe R", "republican_candidate": "Mike Rounds", "republican_pct": 94.7, "state": "SD" }, { "democrat_pct": 1.3, "democratic_candidate": "Marquita Bradshaw", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "TN", "rating": "Safe R", "republican_candidate": "Bill Hagerty", "republican_pct": 98.7, "state": "TN" }, { "democrat_pct": 68.7, "democratic_candidate": "James Talarico", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "TX", "rating": "Tilt D", "republican_candidate": "Ken Paxton", "republican_pct": 31.3, "state": "TX" }, { "democrat_pct": 98.2, "democratic_candidate": "Mark Warner", "district": null, "incumbent_party": "D", "independent_candidate": null, "independent_pct": 0, "key": "VA", "rating": "Safe D", "republican_candidate": "Bert Mizusawa", "republican_pct": 1.8, "state": "VA" }, { "democrat_pct": 1.4, "democratic_candidate": "Rachel Fetty Anderson", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "WV", "rating": "Safe R", "republican_candidate": "Shelley Moore Capito", "republican_pct": 98.6, "state": "WV" }, { "democrat_pct": 1.6, "democratic_candidate": "James W. Byrd", "district": null, "incumbent_party": "R", "independent_candidate": null, "independent_pct": 0, "key": "WY", "rating": "Safe R", "republican_candidate": "Harriet Hageman", "republican_pct": 98.4, "state": "WY" } ], "seat_distribution": [ { "democrat_seats": 53, "probability_pct": 0 }, { "democrat_seats": 54, "probability_pct": 0.01 }, { "democrat_seats": 55, "probability_pct": 0.06 }, { "democrat_seats": 56, "probability_pct": 0.22 }, { "democrat_seats": 57, "probability_pct": 0.85 }, { "democrat_seats": 58, "probability_pct": 2.15 }, { "democrat_seats": 59, "probability_pct": 4.81 }, { "democrat_seats": 60, "probability_pct": 8.57 }, { "democrat_seats": 61, "probability_pct": 13.12 }, { "democrat_seats": 62, "probability_pct": 16.79 }, { "democrat_seats": 63, "probability_pct": 17.42 }, { "democrat_seats": 64, "probability_pct": 15.08 }, { "democrat_seats": 65, "probability_pct": 10.61 }, { "democrat_seats": 66, "probability_pct": 6.1 }, { "democrat_seats": 67, "probability_pct": 2.82 }, { "democrat_seats": 68, "probability_pct": 1 }, { "democrat_seats": 69, "probability_pct": 0.32 }, { "democrat_seats": 70, "probability_pct": 0.06 }, { "democrat_seats": 71, "probability_pct": 0.01 }, { "democrat_seats": 72, "probability_pct": 0 }, { "democrat_seats": 73, "probability_pct": 0 } ], "source_url": "https://civicapi.org/api/v2/forecast/senate/2026/civicapi", "state": null, "totals": { "democrat": 62, "independent": 0, "republican": 59, "tossup": 5 }, "year": 2026 } ``` ### Live results - Capability: `elections/live_results` - Description: Live results of every race of a chamber (senate, house or governor) on an election date, nationwide or for one state, from one civicAPI race search: candidates, parties, votes, percent, share reporting, called/winner and current leader, plus counts of called and reporting races, calls by party and civicAPI's nationwide seat tally. chamber all lists every race on the ballot in one state (state legislature, statewide offices, ballot measures). Date defaults to 2026-11-03. - Instructions: Election night: who is winning or has won the Senate, House or governor races, overall or in one state. Poll again for fresh counts; pass a race_id to race for every candidate and the county map. - Cost: 5 credits per call - Capability file: [Live results](https://firecrawl.dev/alexandria/agents/providers/civicapi-org/elections/live_results) Accepted options: - `chamber` (string, required): senate (US Senate), house (US House), governor, or all races in one state (needs state). Example: `senate` - `date` (string): Election date YYYY-MM-DD. Defaults to 2026-11-03. Pattern: ^\d{4}-\d{2}-\d{2}$. Example: `` - `state` (string): Two-letter US state code, e.g. GA. Case-insensitive. Pattern: ^[A-Za-z]{2}$. Example: `` Response schema example: ```json { "attribution": "Results and forecasts from civicAPI (https://civicapi.org)", "called_count": 0, "calls_by_party": [], "chamber": "senate", "count": 1, "date": "2026-11-03", "national": null, "observed_at_ms": 1793720565631, "races": [ { "called": false, "candidates": [ { "candidate_id": 220200, "name": "Jon Ossoff", "party": "Democratic", "percent": 0, "seats": null, "votes": 0, "winner": false }, { "candidate_id": 220201, "name": "Mike Collins", "party": "Republican", "percent": 0, "seats": null, "votes": 0, "winner": false } ], "date": "2026-11-03", "district": null, "leader": null, "leader_party": null, "name": "Georgia US Senate", "percent_reporting": 0, "race_id": 87087, "results_url": "https://civicapi.org/results/elections/87087", "scope": "General", "state": "GA", "type": "US Senate", "winner": null, "winner_party": null } ], "reporting_count": 0, "source_url": "https://civicapi.org/api/v2/race/search?startDate=2026-11-03&endDate=2026-11-03&country=US&limit=50000&province=GA&election_type=General", "state": "GA", "status_note": "Election-night counts are unofficial until each state certifies them; civicAPI updates races as official sources report." } ``` ### Race - Capability: `elections/race` - Description: One civicAPI race in full: every candidate with party, votes, percent, incumbency, winner and runoff flags, share reporting, poll open and close times, last update, test-data and disputed flags, and optionally the county or district breakdown. One GET of /api/v2/race/{id}. - Instructions: Details of one race found with live_results (race_id), or a pasted civicapi.org/results/elections/{id} URL; include_regions for county-level counts. - Cost: 5 credits per call - Capability file: [Race](https://firecrawl.dev/alexandria/agents/providers/civicapi-org/elections/race) Accepted options: - `include_regions` (boolean): Add the county or district breakdown (regions). Default false. Example: `false` - `race_id` (number): civicAPI race id from live_results, e.g. 87088. Example: `10` - `url` (string): A https://civicapi.org/results/elections/{id} URL; used when race_id is absent. Example: `` Response schema example: ```json { "attribution": "Results and forecasts from civicAPI (https://civicapi.org)", "called": false, "candidates": [ { "advanced": false, "candidate_id": 220202, "incumbent": false, "name": "Rick Jackson", "party": "Republican", "percent": 0, "seats": null, "votes": 0, "winner": false }, { "advanced": false, "candidate_id": 220203, "incumbent": false, "name": "Keisha Lance Bottoms", "party": "Democratic", "percent": 0, "seats": null, "votes": 0, "winner": false } ], "date": "2026-11-03", "district": null, "is_disputed": false, "last_updated": "2026-10-13T19:28:40.381Z", "leader": null, "leader_party": null, "municipality": null, "name": "Georgia Governor", "observed_at_ms": 1793720565634, "percent_reporting": 0, "polls_close": "2026-11-03T23:00:00.000Z", "polls_open": "2026-11-03T11:00:00.000Z", "race_id": 87088, "regions": null, "registered_voters": null, "results_url": "https://civicapi.org/results/elections/87088", "round": 1, "scope": "Statewide", "seats": null, "source_url": "https://civicapi.org/api/v2/race/87088", "state": "GA", "status_note": "Election-night counts are unofficial until each state certifies them; civicAPI updates races as official sources report.", "test_data": false, "type": "Governor", "winner": null, "winner_party": null } ```