Firecrawl Alexandria
Ballotpedia
Ballotpedia, the encyclopedia of American politics and elections: candidates, races and ballot measures for US federal, state and local elections (2022 onward, including the 2026 midterms), e.g. who is running for governor of New Hampshire with party and incumbency. Statewide races by state code, sample ballots and political districts for any address or coordinate, current officeholders, candidate profiles (prior offices, profession, endorsements, campaign websites) and ballot measure details with arguments and donors, from the api4 backend behind Ballotpedia's Sample Ballot Lookup and Who Represents Me tools. Also the newest Ballotpedia News posts (news.ballotpedia.org) as a latest election news feed.
Try Ballotpedia now.
Choose an example or ask your own question.
TRY ASKING
Codefollows the fields above
const result = await firecrawl.scrape({
alexandria: {
provider: "ballotpedia-org",
capability: "districts/ballot_for_date",
options: {
election: "2024-11-05",
lat: 43.07545298388,
long: -89.388080960786,
},
},
});2Response example
This is a sample shape. Press Run to see live data from Ballotpedia.
{
"ballot_measure_count": 4,
"candidate_count": 23,
"candidate_lists_complete": true,
"district_count": 8,
"districts": [
{
"ballot_measures": [],
"id": 13889,
"name": "Dane",
"precise_boundary": true,
"races": [
{
"candidates": [
{
"id": 250935,
"image_url": null,
"is_incumbent": true,
"is_write_in": false,
"name": "Scott McDonell",
"parties": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"person_id": 290895,
"running_mate": null,
"status": "Won",
"survey_exists": false,
"url": "https://ballotpedia.org/Scott_McDonell",
"withdrew_still_on_ballot": false
}
],
"id": 141220,
"number_of_seats": 1,
"office": {
"branch": "Executive",
"chamber": null,
"id": 21856,
"is_partisan": "Partisan all",
"level": "Local",
"name": "Dane County Clerk",
"type": "Clerk",
"url": "https://ballotpedia.org/Government_of_Dane_County,_Wisconsin"
},
"office_position": null,
"race_type": "Regular",
"stage_type": "General",
"url": "https://ballotpedia.org/Municipal_elections_in_Dane_County,_Wisconsin_(2024)"
},
{
"candidates": [
{
"id": 250936,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/AdamGallagher.jpg",
"is_incumbent": true,
"is_write_in": false,
"name": "Adam Gallagher",
"parties": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"person_id": 290899,
"running_mate": null,
"status": "Won",
"survey_exists": true,
"url": "https://ballotpedia.org/Adam_Gallagher",
"withdrew_still_on_ballot": false
}
],
"id": 141221,
"number_of_seats": 1,
"office": {
"branch": "Executive",
"chamber": null,
"id": 21862,
"is_partisan": "Partisan all",
"level": "Local",
"name": "Dane County Treasurer",
"type": "Treasurer",
"url": "https://ballotpedia.org/Government_of_Dane_County,_Wisconsin"
},
"office_position": null,
"race_type": "Regular",
"stage_type": "General",
"url": "https://ballotpedia.org/Municipal_elections_in_Dane_County,_Wisconsin_(2024)"
},
{
"candidates": [
{
"id": 250937,
"image_url": null,
"is_incumbent": true,
"is_write_in": false,
"name": "Kristi Chlebowski",
"parties": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"person_id": 290898,
"running_mate": null,
"status": "Won",
"survey_exists": false,
"url": "https://ballotpedia.org/Kristi_Chlebowski",
"withdrew_still_on_ballot": false
}
],
"id": 141222,
"number_of_seats": 1,
"office": {
"branch": "Executive",
"chamber": null,
"id": 21861,
"is_partisan": "Partisan all",
"level": "Local",
"name": "Dane County Register of Deeds",
"type": "Register of Deeds",
"url": "https://ballotpedia.org/Government_of_Dane_County,_Wisconsin"
},
"office_position": null,
"race_type": "Regular",
"stage_type": "General",
"url": "https://ballotpedia.org/Municipal_elections_in_Dane_County,_Wisconsin_(2024)"
},
{
"candidates": [
{
"id": 250938,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/Ismael_Ozanne.jpg",
"is_incumbent": true,
"is_write_in": false,
"name": "Ismael Ozanne",
"parties": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"person_id": 21935,
"running_mate": null,
"status": "Won",
"survey_exists": false,
"url": "https://ballotpedia.org/Ismael_Ozanne",
"withdrew_still_on_ballot": false
}
],
"id": 141223,
"number_of_seats": 1,
"office": {
"branch": "Executive",
"chamber": null,
"id": 15417,
"is_partisan": "Partisan all",
"level": "Local",
"name": "Dane County District Attorney",
"type": "District attorney",
"url": "https://ballotpedia.org/Government_of_Dane_County,_Wisconsin"
},
"office_position": null,
"race_type": "Regular",
"stage_type": "General",
"url": "https://ballotpedia.org/Municipal_elections_in_Dane_County,_Wisconsin_(2024)"
},
{
"candidates": [
{
"id": 250941,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/Melissa_Agard_20240401_083434.jpg",
"is_incumbent": false,
"is_write_in": false,
"name": "Melissa Agard",
"parties": [
{
"id": 7,
"name": "Nonpartisan",
"url": "https://ballotpedia.org/Nonpartisan"
}
],
"person_id": 38939,
"running_mate": null,
"status": "Won",
"survey_exists": false,
"url": "https://ballotpedia.org/Melissa_Agard",
"withdrew_still_on_ballot": false
},
{
"id": 250944,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/Gavin_Folgert_20240808_092825.png",
"is_incumbent": false,
"is_write_in": false,
"name": "Dana Pellebon",
"parties": [
{
"id": 7,
"name": "Nonpartisan",
"url": "https://ballotpedia.org/Nonpartisan"
}
],
"person_id": 343197,
"running_mate": null,
"status": "Lost",
"survey_exists": false,
"url": "https://ballotpedia.org/Dana_Pellebon",
"withdrew_still_on_ballot": false
}
],
"id": 141224,
"number_of_seats": 1,
"office": {
"branch": "Executive",
"chamber": null,
"id": 26990,
"is_partisan": "Nonpartisan all",
"level": "Local",
"name": "Dane County Executive",
"type": null,
"url": "https://ballotpedia.org/Government_of_Dane_County,_Wisconsin"
},
"office_position": null,
"race_type": "Special",
"stage_type": "General",
"url": "https://ballotpedia.org/Municipal_elections_in_Dane_County,_Wisconsin_(2024)"
}
],
"type": "County"
},
{
"ballot_measures": [
{
"district_type": "City-town",
"id": 26165,
"name": "Madison, Wisconsin, Property Tax Increase Measure (November 2024)"
}
],
"id": 92584,
"name": "Madison",
"precise_boundary": true,
"races": [],
"type": "City-town"
},
{
"ballot_measures": [
{
"district_type": "School District",
"id": 26166,
"name": "Madison Metropolitan School District, Wisconsin, Question I, Exceed Revenue Limit Measure (November 2024)"
},
{
"district_type": "School District",
"id": 26167,
"name": "Madison Metropolitan School District, Wisconsin, Question II, School Facilities Bond Measure (November 2024)"
}
],
"id": 28168,
"name": "Madison Metropolitan School District",
"precise_boundary": true,
"races": [],
"type": "School District"
},
{
"ballot_measures": [],
"id": 93743,
"name": "United States",
"precise_boundary": true,
"races": [
{
"candidates": [
{
"id": 175949,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/473px-Official_Portrait_of_President_Donald_Trump.jpg",
"is_incumbent": false,
"is_write_in": false,
"name": "Donald Trump",
"parties": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"person_id": 15180,
"running_mate": "J.D. Vance",
"status": "Won",
"survey_exists": false,
"url": "https://ballotpedia.org/Donald_Trump",
"withdrew_still_on_ballot": false
},
{
"id": 192904,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/RFKJR2023.jpg",
"is_incumbent": false,
"is_write_in": false,
"name": "Robert F. Kennedy Jr.",
"parties": [
{
"id": 5,
"name": "Independent",
"url": "https://ballotpedia.org/Independent"
}
],
"person_id": 497313,
"running_mate": "Nicole Shanahan",
"status": "Lost",
"survey_exists": false,
"url": "https://ballotpedia.org/Robert_F._Kennedy_Jr.",
"withdrew_still_on_ballot": true
},
{
"id": 193007,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/ChaseOliver.jpg",
"is_incumbent": false,
"is_write_in": false,
"name": "Chase Oliver",
"parties": [
{
"id": 3,
"name": "Libertarian Party",
"url": "https://ballotpedia.org/Libertarian_Party"
}
],
"person_id": 331954,
"running_mate": "Mike ter Maat",
"status": "Lost",
"survey_exists": true,
"url": "https://ballotpedia.org/Chase_Oliver",
"withdrew_still_on_ballot": false
},
{
"id": 199149,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/CornelWest2024.jpg",
"is_incumbent": false,
"is_write_in": false,
"name": "Cornel West",
"parties": [
{
"id": 5,
"name": "Independent",
"url": "https://ballotpedia.org/Independent"
}
],
"person_id": 505574,
"running_mate": "Melina Abdullah",
"status": "Lost",
"survey_exists": true,
"url": "https://ballotpedia.org/Cornel_West",
"withdrew_still_on_ballot": false
},
{
"id": 203506,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/Claudia_De_La_Cruz_2024.jpg",
"is_incumbent": false,
"is_write_in": false,
"name": "Claudia De La Cruz",
"parties": [
{
"id": 5,
"name": "Independent",
"url": "https://ballotpedia.org/Independent"
}
],
"person_id": 516180,
"running_mate": "Karina Garcia",
"status": "Lost",
"survey_exists": true,
"url": "https://ballotpedia.org/Claudia_De_La_Cruz",
"withdrew_still_on_ballot": false
},
{
"id": 211896,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/Stein24.jpg",
"is_incumbent": false,
"is_write_in": false,
"name": "Jill Stein",
"parties": [
{
"id": 4,
"name": "Green Party",
"url": "https://ballotpedia.org/Green_Party"
}
],
"person_id": 25767,
"running_mate": "Butch Ware",
"status": "Lost",
"survey_exists": false,
"url": "https://ballotpedia.org/Jill_Stein",
"withdrew_still_on_ballot": false
},
{
"id": 219766,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/Randall_Terry.jpg",
"is_incumbent": false,
"is_write_in": false,
"name": "Randall Terry",
"parties": [
{
"id": 6,
"name": "Constitution Party",
"url": "https://ballotpedia.org/Constitution_Party"
}
],
"person_id": 45205,
"running_mate": "Stephen E. Broden",
"status": "Lost",
"survey_exists": false,
"url": "https://ballotpedia.org/Randall_Terry",
"withdrew_still_on_ballot": false
},
{
"id": 252999,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/KamalaHarrisSenate.jpg",
"is_incumbent": false,
"is_write_in": false,
"name": "Kamala D. Harris",
"parties": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"person_id": 30714,
"running_mate": "Tim Walz",
"status": "Lost",
"survey_exists": false,
"url": "https://ballotpedia.org/Kamala_Harris",
"withdrew_still_on_ballot": false
}
],
"id": 64685,
"number_of_seats": 1,
"office": {
"branch": "Executive",
"chamber": null,
"id": 1,
"is_partisan": "Partisan all",
"level": "Federal",
"name": "President of the United States",
"type": null,
"url": null
},
"office_position": null,
"race_type": "Regular",
"stage_type": "General",
"url": "https://ballotpedia.org/Presidential_election,_2024"
}
],
"type": "Country"
},
{
"ballot_measures": [
{
"district_type": "State",
"id": 24148,
"name": "Wisconsin Citizenship Voting Requirement Amendment (2024)"
}
],
"id": 562,
"name": "Wisconsin",
"precise_boundary": true,
"races": [
{
"candidates": [
{
"id": 182905,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/PhillipAnderson2024.jpg",
"is_incumbent": false,
"is_write_in": false,
"name": "Phillip Anderson",
"parties": [
{
"id": 29664,
"name": "Disrupt The Corruption Party",
"url": null
}
],
"person_id": 44619,
"running_mate": null,
"status": "Lost",
"survey_exists": true,
"url": "https://ballotpedia.org/Phillip_Anderson_(Wisconsin)",
"withdrew_still_on_ballot": false
},
{
"id": 194217,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/Tammy_Baldwin.jpg",
"is_incumbent": true,
"is_write_in": false,
"name": "Tammy Baldwin",
"parties": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"person_id": 53821,
"running_mate": null,
"status": "Won",
"survey_exists": false,
"url": "https://ballotpedia.org/Tammy_Baldwin",
"withdrew_still_on_ballot": false
},
{
"id": 219577,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/EricHovde.png",
"is_incumbent": false,
"is_write_in": false,
"name": "Eric Hovde",
"parties": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"person_id": 17290,
"running_mate": null,
"status": "Lost",
"survey_exists": false,
"url": "https://ballotpedia.org/Eric_Hovde",
"withdrew_still_on_ballot": false
},
{
"id": 247629,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/ThomasLeager2024-1.jpg",
"is_incumbent": false,
"is_write_in": false,
"name": "Thomas Leager",
"parties": [
{
"id": 29663,
"name": "America First Party",
"url": null
}
],
"person_id": 330223,
"running_mate": null,
"status": "Lost",
"survey_exists": true,
"url": "https://ballotpedia.org/Thomas_Leager",
"withdrew_still_on_ballot": false
},
{
"id": 307376,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/John-Schiess.jpg",
"is_incumbent": false,
"is_write_in": true,
"name": "John Schiess",
"parties": [
{
"id": 5,
"name": "Independent",
"url": "https://ballotpedia.org/Independent"
}
],
"person_id": 28602,
"running_mate": null,
"status": "Lost",
"survey_exists": false,
"url": "https://ballotpedia.org/John_Schiess",
"withdrew_still_on_ballot": false
}
],
"id": 62506,
"number_of_seats": 1,
"office": {
"branch": "Legislative",
"chamber": "Upper",
"id": 11813,
"is_partisan": "Partisan all",
"level": "Federal",
"name": "U.S. Senate Wisconsin",
"type": "Senator",
"url": "https://ballotpedia.org/List_of_United_States_Senators_from_Wisconsin"
},
"office_position": null,
"race_type": "Regular",
"stage_type": "General",
"url": "https://ballotpedia.org/United_States_Senate_election_in_Wisconsin,_2024"
}
],
"type": "State"
},
{
"ballot_measures": [],
"id": 430,
"name": "Wisconsin District 2",
"precise_boundary": true,
"races": [
{
"candidates": [
{
"id": 200357,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/400px-Mark_Pocan_official_photo.jpg",
"is_incumbent": true,
"is_write_in": false,
"name": "Mark Pocan",
"parties": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"person_id": 37193,
"running_mate": null,
"status": "Won",
"survey_exists": false,
"url": "https://ballotpedia.org/Mark_Pocan",
"withdrew_still_on_ballot": false
},
{
"id": 207409,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/Erik-Olsen.PNG",
"is_incumbent": false,
"is_write_in": false,
"name": "Erik Olsen",
"parties": [
{
"id": 1,
"name": "Republican Party",
"url": "https://ballotpedia.org/Republican_Party"
}
],
"person_id": 352754,
"running_mate": null,
"status": "Lost",
"survey_exists": false,
"url": "https://ballotpedia.org/Erik_Olsen",
"withdrew_still_on_ballot": false
}
],
"id": 64040,
"number_of_seats": 1,
"office": {
"branch": "Legislative",
"chamber": "Lower",
"id": 10859,
"is_partisan": "Partisan all",
"level": "Federal",
"name": "U.S. House Wisconsin District 2",
"type": "Representative",
"url": "https://ballotpedia.org/Wisconsin's_2nd_Congressional_District"
},
"office_position": null,
"race_type": "Regular",
"stage_type": "General",
"url": "https://ballotpedia.org/Wisconsin's_2nd_Congressional_District_election,_2024"
}
],
"type": "Congress"
},
{
"ballot_measures": [],
"id": 7302,
"name": "Wisconsin State Assembly District 76",
"precise_boundary": true,
"races": [
{
"candidates": [
{
"id": 248834,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/Francesca_Hong_20230521_075010.jpg",
"is_incumbent": true,
"is_write_in": false,
"name": "Francesca Hong",
"parties": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"person_id": 330225,
"running_mate": null,
"status": "Won",
"survey_exists": false,
"url": "https://ballotpedia.org/Francesca_Hong",
"withdrew_still_on_ballot": false
}
],
"id": 70184,
"number_of_seats": 1,
"office": {
"branch": "Legislative",
"chamber": "Lower",
"id": 11319,
"is_partisan": "Partisan all",
"level": "State",
"name": "Wisconsin State Assembly District 76",
"type": "Representative",
"url": "https://ballotpedia.org/Wisconsin_State_Assembly_District_76"
},
"office_position": null,
"race_type": "Regular",
"stage_type": "General",
"url": "https://ballotpedia.org/Wisconsin_State_Assembly_elections,_2024"
}
],
"type": "State Legislative (Lower)"
},
{
"ballot_measures": [],
"id": 2452,
"name": "Wisconsin State Senate District 26",
"precise_boundary": true,
"races": [
{
"candidates": [
{
"id": 242099,
"image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/KHR-headshot-as-of-feb-2025-lite_20260625_190523_42508_1.jpg",
"is_incumbent": true,
"is_write_in": false,
"name": "Kelda Roys",
"parties": [
{
"id": 2,
"name": "Democratic Party",
"url": "https://ballotpedia.org/Democratic_Party"
}
],
"person_id": 31647,
"running_mate": null,
"status": "Won",
"survey_exists": true,
"url": "https://ballotpedia.org/Kelda_Roys",
"withdrew_still_on_ballot": false
}
],
"id": 70107,
"number_of_seats": 1,
"office": {
"branch": "Legislative",
"chamber": "Upper",
"id": 28870,
"is_partisan": "Partisan all",
"level": "State",
"name": "Wisconsin State Senate District 26",
"type": "Senator",
"url": "https://ballotpedia.org/Wisconsin_State_Senate_District_26"
},
"office_position": null,
"race_type": "Regular",
"stage_type": "General",
"url": "https://ballotpedia.org/Wisconsin_State_Senate_elections,_2024"
}
],
"type": "State Legislative (Upper)"
}
],
"election_date": "2024-11-05",
"lat": 43.07545298388,
"long": -89.388080960786,
"observed_at_ms": 1790230420606,
"polling_place_locator_url": "https://myvote.wi.gov/en-us/Find-My-Polling-Place",
"race_count": 10,
"source_url": "https://api4.ballotpedia.org/sample_ballot/get_ballot_by_date",
"state": {
"abbreviation": "WI",
"id": 562,
"name": "Wisconsin"
}
}Related providers
Browse the library//
Get started
//
Give your agent Ballotpedia.
One API key for the live web and every provider in Alexandria.
Are you an AI agent? See setup options