--- type: "firecrawl-provider" description: "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." use_when: "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." categories: "Places" capabilities: 8 credits_per_call: "1-5" --- # Ballotpedia on Firecrawl Alexandria 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. - Categories: Places - Category index: [Places category](https://firecrawl.dev/alexandria/agents/categories/places) - Provider key: `ballotpedia-org` - Access: Firecrawl credits - Cost: 1–5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/ballotpedia-org) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/openapi.json) ## Capabilities - [Ballot for date](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/ballot_for_date): The ballot at a coordinate for one election date: every district with its races (office, stage, seats, candidates with party, incumbency and status) and ballot measures, with the district boundaries as drawn for that date. Works for past elections (since 2022) and upcoming ones. Returns not_found when Ballotpedia has no election on that date at the coordinate. - [Ballot measure details](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/ballot_measure_details): One ballot measure by Ballotpedia id: title, article URL, ballot question, yes/no vote summaries, arguments for and against with authors and sources, and the committee, donor and social-link sections as returned. - [Candidate details](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/candidate_details): Ballotpedia candidate profile and background data (election candidates for governor, Congress, state legislature and local office) for one or more candidate ids from a race: current offices, campaign contact channels, endorsements and the presence of a Candidate Connection survey. Unknown ids are reported in missing_ids; when none of the ids is known the call fails with not_found. - [Districts for coordinate](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/districts_for_coordinate): Every political district Ballotpedia places a coordinate in, per election date: federal, state, congressional, state legislative, county, county subdivision, city/town, city council ward, school district, judicial district and their subdivisions. Districts are listed per election (boundaries as they applied on that date) and as a deduplicated set with the election dates each district appears on. Upcoming elections only by default; include_historical adds every election since 2022. - [Geocode address](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/geocode_address): Resolve a US street address to the latitude/longitude Ballotpedia's lookup tools use. Runs Ballotpedia's address autocomplete (Esri via Amazon Location, US only) and geocodes the best suggestion. Returns not_found when the address produces no suggestion. - [Latest](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/latest): The newest Ballotpedia News posts (news.ballotpedia.org: election coverage, 2026 election analysis, ballot measures, federal, state and local politics, the Daily Brew newsletter) in the shared latest-feed shape: canonical url, publishedAt (RFC 3339 UTC, from the post's WordPress date_gmt publish instant, to the second), title and source "ballotpedia", plus category, the post's Ballotpedia News section. Newest first and de-duplicated by url. Reads the 100 newest posts of the site or of one section, so at most 100 items come back. Without a filter no section contributes more than a third of limit (at least 5), so the daily newsletter cannot crowd out election coverage. since (or its alias publishedSince) keeps only items published at or after that instant; nothing new since then is an empty list, not an error. The ballotpedia.org wiki itself (results pages such as Election_results,_2026) sits behind an AWS WAF JavaScript challenge and is not read. - [Officeholders for coordinate](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/officeholders_for_coordinate): Current officeholders for a coordinate from Ballotpedia's Who Represents Me: districts (congressional, state legislative, state, and local where Ballotpedia covers it) with their offices and the people currently holding them, with party, Ballotpedia article URL and photo. Returns not_found for a coordinate outside Ballotpedia's US coverage. - [Statewide races](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/statewide_races): Statewide races and candidates for a US state by two-letter code, no address needed: governor, U.S. Senate, lieutenant governor, attorney general, secretary of state and other statewide offices, plus statewide ballot measures, for one election date (default: the next upcoming election). Each race lists its candidates with party, incumbency and ballot status and links to Ballotpedia's election article, e.g. the 2026 New Hampshire gubernatorial election (Democratic nominee, Republican incumbent, Libertarian). Elections since 2022 work. Returns not_found when Ballotpedia lists no statewide race or measure in the state on that date. ## 1. Choose this provider when 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. ## 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": "ballotpedia-org", "capability": "districts/ballot_for_date", "options": { "election": "2024-11-05", "lat": 43.07545298388, "long": -89.388080960786 } } ``` ## 3. Add provider options Use only the options needed for the task: - `election` (string, required): Election date, YYYY-MM-DD, as returned by districts_for_coordinate. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `lat` (number, required): lat Example: `10` - `long` (number, required): long Example: `10` ## 4. Request through your preferred interface ### JavaScript ```javascript 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, }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "ballotpedia-org", "capability": "districts/ballot_for_date", "options": { "election": "2024-11-05", "lat": 43.07545298388, "long": -89.388080960786 } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "ballotpedia-org", "capability": "districts/ballot_for_date", "options": { "election": "2024-11-05", "lat": 43.07545298388, "long": -89.388080960786 } } }' ``` ### CLI ```sh firecrawl scrape 'ballotpedia-org/districts/ballot_for_date' \ --options '{"election":"2024-11-05","lat":43.07545298388,"long":-89.388080960786}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "ballotpedia-org", "capability": "districts/ballot_for_date", "options": { "election": "2024-11-05", "lat": 43.07545298388, "long": -89.388080960786 } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "ballotpedia-org", "capability": "districts/ballot_for_date", "options": { "election": "2024-11-05", "lat": 43.07545298388, "long": -89.388080960786 } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "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" } } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Ballot for date - Capability: `districts/ballot_for_date` - Description: The ballot at a coordinate for one election date: every district with its races (office, stage, seats, candidates with party, incumbency and status) and ballot measures, with the district boundaries as drawn for that date. Works for past elections (since 2022) and upcoming ones. Returns not_found when Ballotpedia has no election on that date at the coordinate. - Instructions: After districts_for_coordinate, for the full races and candidates of one election date. Candidate ids feed candidate_details; ballot measure ids feed ballot_measure_details. - Cost: 5 credits per call - Capability file: [Ballot for date](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/ballot_for_date) Accepted options: - `election` (string, required): Election date, YYYY-MM-DD, as returned by districts_for_coordinate. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `lat` (number, required): lat Example: `10` - `long` (number, required): long Example: `10` Response schema example: ```json { "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" } } ``` ### Ballot measure details - Capability: `districts/ballot_measure_details` - Description: One ballot measure by Ballotpedia id: title, article URL, ballot question, yes/no vote summaries, arguments for and against with authors and sources, and the committee, donor and social-link sections as returned. - Instructions: After ballot_for_date or districts_for_coordinate, with a ballot measure id. - Cost: 5 credits per call - Capability file: [Ballot measure details](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/ballot_measure_details) Accepted options: - `ballot_measure_id` (number, required): Ballotpedia ballot measure id (ballot_measures[].id from ballot_for_date). Example: `10` Response schema example: ```json { "arguments_against": [ { "argument": "\"None of us want to be in a position to prevent large, meaningful gatherings of our neighbors from taking place, and thanks to virtual meeting technology, we don’t have to. We do have a responsibility as government officials to preserve the lives of our constituents to the degree that we can. AJR 10 prevents public health officers from doing their jobs, endangering countless lives in any future pandemic. To date, Wisconsin has lost nearly 19,000 lives to COVID-19. How many more might be lost in a future pandemic if this constitutional amendment passes?\"", "author": "State Sen. Chris Larson (D-07)", "source": "https://urbanmilwaukee.com/pressrelease/republican-backed-constitutional-amendments-take-us-backwards-deny-hard-truths/" }, { "argument": "\"The argument that an order to close places of worship in response to a state of\nemergency at the national, state or local level for an emergency related to public health\ndoes not infringe on the current Wisconsin Constitution which states that 'the right of\nevery person to worship Almighty God according to the dictates of conscience shall\nnever infringed'. Closing places of worship does not prevent any person from\nworshipping God, as such worship can and is practiced on an individual basis in one's\nown home during an emergency.\"", "author": "League of Women Voters of Wisconsin", "source": "https://lobbying.wi.gov/Data/PositionFileUploads/11112025_031201_LWVWI%20Opposition%20to%20AJR10%20and%20SJR4.pdf" } ], "arguments_in_support": [ { "argument": "\"Sadly, in 2020, we saw the government use emergency powers to abridge the people's right to assemble in places of worship. Religious liberty is not granted by government; it is given by God and protected by our Constitution.\"", "author": "Daniel Degner, President of Wisconsin Family Action", "source": "https://wifamilyaction.org/religious-freedom-constitutional-amendment-on-the-ballot/" }, { "argument": "\"The events of 2020 exposed a troubling inconsistency in how we apply constitutional rights. While liquor stores, bars, and casinos remained open under the label of 'essential,' houses of worship were shuttered, even when their leaders followed the same or stricter health protocols. This disparity sent a damaging message that faith, and those who practice it, are somehow less important or less worthy of protection. But our state and federal constitutions do not rank freedoms by perceived convenience. Both promise every citizen that the government will never make any law prohibiting the free practice of religion, no asterisk, no exceptions. This resolution doesn’t ask for special treatment; it asks for equal protection. It ensures that the government cannot single out religious gatherings for closure while allowing other gatherings to remain open. It doesn’t dictate how a congregation must operate, it simply says the decision to gather belongs with the faithful, not the government.\"", "author": "State Rep. Ron Tusler (R-3)", "source": "https://docs.legis.wisconsin.gov/misc/lc/hearing_testimony_and_materials/2025/ajr10/ajr0010_2025_05_07.pdf" } ], "ballot_measure_id": 28844, "ballot_question": "

Question 1: “Freedom to gather in places of worship during an emergency. 

Shall section 18 of article I of the constitution, which deals with religious liberty, be amended to prohibit the state or a political subdivision of the state from ordering the closure of, or forbidding gatherings in, places of worship in response to a state of emergency, including a public health emergency?”

", "name": "Wisconsin Prohibit Government Closure of Places of Worship During Emergencies Amendment (2026)", "no_summary": "

A \"no\" vote opposes this amendment to prohibit the state or any political subdivision from ordering the closure of or forbidding gatherings in places of worship in response to a state of emergency, including public health emergencies.

", "observed_at_ms": 1790230430207, "overall_summary": null, "sections": { "committees_opposing": null, "committees_supporting": null, "socials_links": { "oppose": null, "support": null }, "top_donors": { "oppose": null, "support": null } }, "source_url": "https://api4.ballotpedia.org/myvote_ballot_measures?ballot_measure=28844", "url": "https://ballotpedia.org/Wisconsin_Prohibit_Government_Closure_of_Places_of_Worship_During_Emergencies_Amendment_(2026)", "yes_summary": "

A \"yes\" vote supports this amendment to prohibit the state or any political subdivision from ordering the closure of or forbidding gatherings in places of worship in response to a state of emergency, including public health emergencies.

" } ``` ### Candidate details - Capability: `districts/candidate_details` - Description: Ballotpedia candidate profile and background data (election candidates for governor, Congress, state legislature and local office) for one or more candidate ids from a race: current offices, campaign contact channels, endorsements and the presence of a Candidate Connection survey. Unknown ids are reported in missing_ids; when none of the ids is known the call fails with not_found. - Instructions: After ballot_for_date, with the candidate ids of a race. - Cost: 5 credits per call - Capability file: [Candidate details](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/candidate_details) Accepted options: - `candidate_ids` (number[], required): Ballotpedia candidate ids (races[].candidates[].id from ballot_for_date). Example: `[]` Response schema example: ```json { "candidate_count": 2, "candidates": [ { "campaign_contact": [ { "contact": "https://www.kalvinbarrett.com/", "inactive": false, "type": "Website" }, { "contact": "campaign@example.invalid", "inactive": false, "type": "Email" }, { "contact": "https://www.facebook.com/SheriffBarrett/", "inactive": false, "type": "Facebook" }, { "contact": "sheriffbarrett", "inactive": false, "type": "Twitter" }, { "contact": "https://www.linkedin.com/in/kalvin-barrett-45b060185/", "inactive": false, "type": "LinkedIn" } ], "campaign_themes": 1, "candidate_id": 446423, "current_offices": [ "Dane County Sheriff" ], "endorsements": [ { "name": "U.S. Sen. Tammy Baldwin", "url": "https://ballotpedia.org/Endorsements_by_Tammy_Baldwin" } ], "sections": { "achievements": null, "candidate_cards": null, "candidate_pledges": null, "candidate_ratings": null, "candidate_submitted_prior_offices": null, "official_prior_offices": null, "outside_surveys": null, "professions": null, "religions": null, "survey": null }, "survey_exists": false }, { "campaign_contact": [ { "contact": "https://voteokazaki.com/", "inactive": false, "type": "Website" }, { "contact": "campaign@example.invalid", "inactive": false, "type": "Email" }, { "contact": "https://www.facebook.com/profile.php?id=61574385603013", "inactive": false, "type": "Facebook" }, { "contact": "https://www.linkedin.com/in/okazaki", "inactive": false, "type": "LinkedIn" } ], "campaign_themes": 1, "candidate_id": 446425, "current_offices": [ "Dane County Clerk of the Circuit Court" ], "endorsements": [], "sections": { "achievements": null, "candidate_cards": null, "candidate_pledges": null, "candidate_ratings": null, "candidate_submitted_prior_offices": null, "official_prior_offices": null, "outside_surveys": null, "professions": null, "religions": null, "survey": null }, "survey_exists": false } ], "missing_ids": [], "observed_at_ms": 1790230427041, "requested_ids": [ 446423, 446425 ], "source_url": "https://api4.ballotpedia.org/myvote_candidates?candidates=446423%2C446425" } ``` ### Districts for coordinate - Capability: `districts/districts_for_coordinate` - Description: Every political district Ballotpedia places a coordinate in, per election date: federal, state, congressional, state legislative, county, county subdivision, city/town, city council ward, school district, judicial district and their subdivisions. Districts are listed per election (boundaries as they applied on that date) and as a deduplicated set with the election dates each district appears on. Upcoming elections only by default; include_historical adds every election since 2022. - Instructions: Coordinate to district identifiers and date-specific boundaries. Use the election dates returned here as input to ballot_for_date. - Cost: 5 credits per call - Capability file: [Districts for coordinate](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/districts_for_coordinate) Accepted options: - `include_historical` (boolean): Also return past elections (since 2022) with the districts as drawn on each date. Larger response. Example: `false` - `lat` (number, required): Latitude in decimal degrees (WGS84). Example: `10` - `long` (number, required): Longitude in decimal degrees (WGS84). Example: `10` Response schema example: ```json { "district_count": 11, "districts": [ { "election_dates": [ "2022-11-08", "2024-08-13", "2024-11-05", "2026-08-11", "2026-11-03" ], "id": 430, "name": "Wisconsin District 2", "precise_boundary": true, "type": "Congress" }, { "election_dates": [ "2022-11-08", "2023-02-21", "2023-04-04", "2024-04-02", "2024-08-13", "2024-11-05", "2025-02-18", "2025-04-01", "2026-04-07", "2026-08-11", "2026-11-03", "2027-02-16" ], "id": 562, "name": "Wisconsin", "precise_boundary": true, "type": "State" }, { "election_dates": [ "2024-08-13", "2024-11-05" ], "id": 2452, "name": "Wisconsin State Senate District 26", "precise_boundary": true, "type": "State Legislative (Upper)" }, { "election_dates": [ "2022-11-08", "2024-08-13", "2024-11-05", "2026-08-11", "2026-11-03" ], "id": 7302, "name": "Wisconsin State Assembly District 76", "precise_boundary": true, "type": "State Legislative (Lower)" }, { "election_dates": [ "2022-11-08", "2023-04-04", "2024-04-02", "2024-08-13", "2024-11-05", "2025-04-01", "2026-02-17", "2026-04-07", "2026-08-11", "2026-11-03" ], "id": 13889, "name": "Dane", "precise_boundary": true, "type": "County" }, { "election_dates": [ "2023-04-04", "2024-04-02", "2024-11-05", "2025-04-01", "2026-04-07" ], "id": 28168, "name": "Madison Metropolitan School District", "precise_boundary": true, "type": "School District" }, { "election_dates": [ "2023-04-04", "2024-04-02", "2025-04-01", "2026-04-07" ], "id": 63613, "name": "Wisconsin Appellate Court District 4", "precise_boundary": true, "type": "Judicial District" }, { "election_dates": [ "2023-02-21", "2023-04-04", "2024-11-05", "2025-04-01" ], "id": 92584, "name": "Madison", "precise_boundary": true, "type": "City-town" }, { "election_dates": [ "2024-04-02", "2024-11-05" ], "id": 93743, "name": "United States", "precise_boundary": true, "type": "Country" }, { "election_dates": [ "2023-02-21", "2023-04-04", "2025-04-01", "2026-04-07" ], "id": 95106, "name": "Madison City Council District 4", "precise_boundary": true, "type": "City-town subdivision" }, { "election_dates": [ "2024-04-02", "2025-06-17", "2026-04-07" ], "id": 95123, "name": "Dane County Supervisor District 1", "precise_boundary": true, "type": "County subdivision" } ], "election_count": 14, "elections": [ { "candidate_lists_complete": true, "date": "2022-11-08", "districts": [ { "ballot_measure_count": 3, "id": 13889, "name": "Dane", "precise_boundary": true, "race_count": 2, "type": "County" }, { "ballot_measure_count": 0, "id": 562, "name": "Wisconsin", "precise_boundary": true, "race_count": 6, "type": "State" }, { "ballot_measure_count": 0, "id": 430, "name": "Wisconsin District 2", "precise_boundary": true, "race_count": 1, "type": "Congress" }, { "ballot_measure_count": 0, "id": 7302, "name": "Wisconsin State Assembly District 76", "precise_boundary": true, "race_count": 1, "type": "State Legislative (Lower)" } ] }, { "candidate_lists_complete": true, "date": "2023-02-21", "districts": [ { "ballot_measure_count": 0, "id": 92584, "name": "Madison", "precise_boundary": true, "race_count": 1, "type": "City-town" }, { "ballot_measure_count": 0, "id": 95106, "name": "Madison City Council District 4", "precise_boundary": true, "race_count": 1, "type": "City-town subdivision" }, { "ballot_measure_count": 0, "id": 562, "name": "Wisconsin", "precise_boundary": true, "race_count": 1, "type": "State" } ] }, { "candidate_lists_complete": true, "date": "2023-04-04", "districts": [ { "ballot_measure_count": 2, "id": 13889, "name": "Dane", "precise_boundary": true, "race_count": 0, "type": "County" }, { "ballot_measure_count": 1, "id": 92584, "name": "Madison", "precise_boundary": true, "race_count": 1, "type": "City-town" }, { "ballot_measure_count": 0, "id": 95106, "name": "Madison City Council District 4", "precise_boundary": true, "race_count": 1, "type": "City-town subdivision" }, { "ballot_measure_count": 0, "id": 28168, "name": "Madison Metropolitan School District", "precise_boundary": true, "race_count": 2, "type": "School District" }, { "ballot_measure_count": 3, "id": 562, "name": "Wisconsin", "precise_boundary": true, "race_count": 1, "type": "State" }, { "ballot_measure_count": 0, "id": 63613, "name": "Wisconsin Appellate Court District 4", "precise_boundary": true, "race_count": 1, "type": "Judicial District" } ] }, { "candidate_lists_complete": true, "date": "2024-04-02", "districts": [ { "ballot_measure_count": 0, "id": 13889, "name": "Dane", "precise_boundary": true, "race_count": 5, "type": "County" }, { "ballot_measure_count": 0, "id": 95123, "name": "Dane County Supervisor District 1", "precise_boundary": true, "race_count": 1, "type": "County subdivision" }, { "ballot_measure_count": 0, "id": 28168, "name": "Madison Metropolitan School District", "precise_boundary": true, "race_count": 2, "type": "School District" }, { "ballot_measure_count": 0, "id": 93743, "name": "United States", "precise_boundary": true, "race_count": 1, "type": "Country" }, { "ballot_measure_count": 2, "id": 562, "name": "Wisconsin", "precise_boundary": true, "race_count": 0, "type": "State" }, { "ballot_measure_count": 0, "id": 63613, "name": "Wisconsin Appellate Court District 4", "precise_boundary": true, "race_count": 1, "type": "Judicial District" } ] }, { "candidate_lists_complete": true, "date": "2024-08-13", "districts": [ { "ballot_measure_count": 0, "id": 13889, "name": "Dane", "precise_boundary": true, "race_count": 5, "type": "County" }, { "ballot_measure_count": 2, "id": 562, "name": "Wisconsin", "precise_boundary": true, "race_count": 1, "type": "State" }, { "ballot_measure_count": 0, "id": 430, "name": "Wisconsin District 2", "precise_boundary": true, "race_count": 1, "type": "Congress" }, { "ballot_measure_count": 0, "id": 7302, "name": "Wisconsin State Assembly District 76", "precise_boundary": true, "race_count": 1, "type": "State Legislative (Lower)" }, { "ballot_measure_count": 0, "id": 2452, "name": "Wisconsin State Senate District 26", "precise_boundary": true, "race_count": 1, "type": "State Legislative (Upper)" } ] }, { "candidate_lists_complete": true, "date": "2024-11-05", "districts": [ { "ballot_measure_count": 0, "id": 13889, "name": "Dane", "precise_boundary": true, "race_count": 5, "type": "County" }, { "ballot_measure_count": 1, "id": 92584, "name": "Madison", "precise_boundary": true, "race_count": 0, "type": "City-town" }, { "ballot_measure_count": 2, "id": 28168, "name": "Madison Metropolitan School District", "precise_boundary": true, "race_count": 0, "type": "School District" }, { "ballot_measure_count": 0, "id": 93743, "name": "United States", "precise_boundary": true, "race_count": 1, "type": "Country" }, { "ballot_measure_count": 1, "id": 562, "name": "Wisconsin", "precise_boundary": true, "race_count": 1, "type": "State" }, { "ballot_measure_count": 0, "id": 430, "name": "Wisconsin District 2", "precise_boundary": true, "race_count": 1, "type": "Congress" }, { "ballot_measure_count": 0, "id": 7302, "name": "Wisconsin State Assembly District 76", "precise_boundary": true, "race_count": 1, "type": "State Legislative (Lower)" }, { "ballot_measure_count": 0, "id": 2452, "name": "Wisconsin State Senate District 26", "precise_boundary": true, "race_count": 1, "type": "State Legislative (Upper)" } ] }, { "candidate_lists_complete": true, "date": "2025-02-18", "districts": [ { "ballot_measure_count": 0, "id": 562, "name": "Wisconsin", "precise_boundary": true, "race_count": 1, "type": "State" } ] }, { "candidate_lists_complete": true, "date": "2025-04-01", "districts": [ { "ballot_measure_count": 0, "id": 13889, "name": "Dane", "precise_boundary": true, "race_count": 3, "type": "County" }, { "ballot_measure_count": 0, "id": 92584, "name": "Madison", "precise_boundary": true, "race_count": 1, "type": "City-town" }, { "ballot_measure_count": 0, "id": 95106, "name": "Madison City Council District 4", "precise_boundary": true, "race_count": 1, "type": "City-town subdivision" }, { "ballot_measure_count": 0, "id": 28168, "name": "Madison Metropolitan School District", "precise_boundary": true, "race_count": 3, "type": "School District" }, { "ballot_measure_count": 1, "id": 562, "name": "Wisconsin", "precise_boundary": true, "race_count": 2, "type": "State" }, { "ballot_measure_count": 0, "id": 63613, "name": "Wisconsin Appellate Court District 4", "precise_boundary": true, "race_count": 1, "type": "Judicial District" } ] }, { "candidate_lists_complete": true, "date": "2025-06-17", "districts": [ { "ballot_measure_count": 0, "id": 95123, "name": "Dane County Supervisor District 1", "precise_boundary": true, "race_count": 1, "type": "County subdivision" } ] }, { "candidate_lists_complete": true, "date": "2026-02-17", "districts": [ { "ballot_measure_count": 0, "id": 13889, "name": "Dane", "precise_boundary": true, "race_count": 1, "type": "County" } ] }, { "candidate_lists_complete": true, "date": "2026-04-07", "districts": [ { "ballot_measure_count": 0, "id": 13889, "name": "Dane", "precise_boundary": true, "race_count": 2, "type": "County" }, { "ballot_measure_count": 0, "id": 95123, "name": "Dane County Supervisor District 1", "precise_boundary": true, "race_count": 1, "type": "County subdivision" }, { "ballot_measure_count": 0, "id": 95106, "name": "Madison City Council District 4", "precise_boundary": true, "race_count": 1, "type": "City-town subdivision" }, { "ballot_measure_count": 0, "id": 28168, "name": "Madison Metropolitan School District", "precise_boundary": true, "race_count": 2, "type": "School District" }, { "ballot_measure_count": 0, "id": 562, "name": "Wisconsin", "precise_boundary": true, "race_count": 1, "type": "State" }, { "ballot_measure_count": 0, "id": 63613, "name": "Wisconsin Appellate Court District 4", "precise_boundary": true, "race_count": 1, "type": "Judicial District" } ] }, { "candidate_lists_complete": true, "date": "2026-08-11", "districts": [ { "ballot_measure_count": 0, "id": 13889, "name": "Dane", "precise_boundary": true, "race_count": 2, "type": "County" }, { "ballot_measure_count": 0, "id": 562, "name": "Wisconsin", "precise_boundary": true, "race_count": 5, "type": "State" }, { "ballot_measure_count": 0, "id": 430, "name": "Wisconsin District 2", "precise_boundary": true, "race_count": 1, "type": "Congress" }, { "ballot_measure_count": 0, "id": 7302, "name": "Wisconsin State Assembly District 76", "precise_boundary": true, "race_count": 1, "type": "State Legislative (Lower)" } ] }, { "candidate_lists_complete": false, "date": "2026-11-03", "districts": [ { "ballot_measure_count": 0, "id": 13889, "name": "Dane", "precise_boundary": true, "race_count": 2, "type": "County" }, { "ballot_measure_count": 3, "id": 562, "name": "Wisconsin", "precise_boundary": true, "race_count": 5, "type": "State" }, { "ballot_measure_count": 0, "id": 430, "name": "Wisconsin District 2", "precise_boundary": true, "race_count": 1, "type": "Congress" }, { "ballot_measure_count": 0, "id": 7302, "name": "Wisconsin State Assembly District 76", "precise_boundary": true, "race_count": 1, "type": "State Legislative (Lower)" } ] }, { "candidate_lists_complete": false, "date": "2027-02-16", "districts": [ { "ballot_measure_count": 0, "id": 562, "name": "Wisconsin", "precise_boundary": true, "race_count": 1, "type": "State" } ] } ], "include_historical": true, "lat": 43.07545298388, "long": -89.388080960786, "observed_at_ms": 1790230413569, "polling_place_locator_url": "https://myvote.wi.gov/en-us/Find-My-Polling-Place", "source_url": "https://api4.ballotpedia.org/myvote_redistricting_with_historical?long=-89.388080960786&lat=43.07545298388&include_volunteer=true&include_historical=true", "state": { "abbreviation": "WI", "id": 562, "name": "Wisconsin" } } ``` ### Geocode address - Capability: `districts/geocode_address` - Description: Resolve a US street address to the latitude/longitude Ballotpedia's lookup tools use. Runs Ballotpedia's address autocomplete (Esri via Amazon Location, US only) and geocodes the best suggestion. Returns not_found when the address produces no suggestion. - Instructions: Start here when you have an address; every other function takes a coordinate or an id. - Cost: 5 credits per call - Capability file: [Geocode address](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/geocode_address) Accepted options: - `address` (string, required): US street address, e.g. "100 N Carroll St, Madison, WI 53703". Example: `
` Response schema example: ```json { "address": "100 N Carroll St, Madison, WI, 53703, USA", "data_source": "Esri", "lat": 43.07545298388, "long": -89.388080960786, "observed_at_ms": 1790230417265, "query": "100 N Carroll St, Madison, WI 53703", "suggestions": [ "100 N Carroll St, Madison, WI, 53703, USA" ] } ``` ### Latest - Capability: `districts/latest` - Description: The newest Ballotpedia News posts (news.ballotpedia.org: election coverage, 2026 election analysis, ballot measures, federal, state and local politics, the Daily Brew newsletter) in the shared latest-feed shape: canonical url, publishedAt (RFC 3339 UTC, from the post's WordPress date_gmt publish instant, to the second), title and source "ballotpedia", plus category, the post's Ballotpedia News section. Newest first and de-duplicated by url. Reads the 100 newest posts of the site or of one section, so at most 100 items come back. Without a filter no section contributes more than a third of limit (at least 5), so the daily newsletter cannot crowd out election coverage. since (or its alias publishedSince) keeps only items published at or after that instant; nothing new since then is an empty list, not an error. The ballotpedia.org wiki itself (results pages such as Election_results,_2026) sits behind an AWS WAF JavaScript challenge and is not read. - Instructions: Polling Ballotpedia for new election coverage around the 2026 midterms: results write-ups, battleground and race analysis, ballot measure news. filter narrows to one section, e.g. "2026-elections" or "ballot-measures". The url opens the full article. - Cost: 1 credit per call - Capability file: [Latest](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/latest) Accepted options: - `filter` (string): One Ballotpedia News section (WordPress category). Omit for every section with the per-section cap. "2026-elections": 2026 election coverage; "ballot-measures": ballot measure news; "breaking-news"; "on-the-ballot": the On the Ballot series; "federal", "state", "local": government and politics by level; "newsletters": the Daily Brew and other newsletters. A filtered call has no per-section cap. Example: `2026-elections` - `limit` (number): Maximum items (1-100). Example: `50` - `publishedSince` (string): Alias of since. When both are given the later instant applies. Example: `` - `since` (string): RFC 3339 date-time; return only items with publishedAt at or after it. Example: `` Response schema example: ```json { "items": [ { "category": "newsletters", "publishedAt": "2026-10-28T09:30:00Z", "source": "ballotpedia", "title": "Fifteen of the 100 most populous U.S. cities are holding elections for mayor on Nov. 3", "url": "https://news.ballotpedia.org/2026/10/28/fifteen-of-the-100-most-populous-u-s-cities-are-holding-elections-for-mayor-on-nov-3/" }, { "category": "2026-elections", "publishedAt": "2026-10-27T23:38:55Z", "source": "ballotpedia", "title": "Fifteen of the 100 most populous U.S. cities are holding mayoral elections on Nov. 3", "url": "https://news.ballotpedia.org/2026/10/27/fifteen-of-the-100-most-populous-u-s-cities-are-holding-mayoral-elections-on-nov-3/" }, { "category": "2026-elections", "publishedAt": "2026-10-27T23:35:03Z", "source": "ballotpedia", "title": "Ballotpedia identifies 23 battleground districts in 2026 Georgia House elections", "url": "https://news.ballotpedia.org/2026/10/27/ballotpedia-identifies-23-battleground-districts-in-2026-georgia-house-elections/" }, { "category": "ballot-measures", "publishedAt": "2026-10-27T23:21:29Z", "source": "ballotpedia", "title": "Ballot measure campaigns raised more than $1.2 billion so far in 2026 and spent a record-high $193 million on signature drives", "url": "https://news.ballotpedia.org/2026/10/27/ballot-measure-campaigns-raised-more-than-1-2-billion-so-far-in-2026-and-spent-a-record-high-193-million-on-signature-drives/" }, { "category": "ballot-measures", "publishedAt": "2026-10-27T23:15:31Z", "source": "ballotpedia", "title": "Voters in Maine and Texas to decide local Flock camera measures on Nov. 3", "url": "https://news.ballotpedia.org/2026/10/27/voters-in-maine-and-texas-to-decide-local-flock-camera-measures-on-nov-3/" }, { "category": "ballot-measures", "publishedAt": "2026-10-27T23:09:59Z", "source": "ballotpedia", "title": "Voters will determine 15 election policy ballot measures on Nov. 3", "url": "https://news.ballotpedia.org/2026/10/27/voters-will-determine-15-election-policy-ballot-measures-on-nov-3-2/" }, { "category": "newsletters", "publishedAt": "2026-10-27T20:00:00Z", "source": "ballotpedia", "title": "Voters will determine 15 election policy ballot measures on Nov. 3", "url": "https://news.ballotpedia.org/2026/10/27/voters-will-determine-15-election-policy-ballot-measures-on-nov-3/" }, { "category": "2026-elections", "publishedAt": "2026-10-27T10:23:52Z", "source": "ballotpedia", "title": "Incumbent Diana Moreno and Edward Lee are running to represent District 36 in the New York Assembly, one of 11 districts in New York with a candidate backed by the Democratic Socialists of America on the ballot", "url": "https://news.ballotpedia.org/2026/10/27/incumbent-diana-moreno-and-edward-lee-are-running-to-represent-district-36-in-the-new-york-assembly-one-of-11-districts-in-new-york-with-a-candidate-backed-by-the-democratic-socialists-of-america-on/" }, { "category": "newsletters", "publishedAt": "2026-10-27T09:30:00Z", "source": "ballotpedia", "title": "Twenty-three states are holding state supreme court elections in November. Six are battlegrounds.", "url": "https://news.ballotpedia.org/2026/10/27/twenty-three-states-are-holding-state-supreme-court-elections-in-november-six-are-battlegrounds/" }, { "category": "2026-elections", "publishedAt": "2026-10-26T16:12:52Z", "source": "ballotpedia", "title": "Democratic Socialists of America backs 131 candidates in 30 states ahead of Nov. 3 elections", "url": "https://news.ballotpedia.org/2026/10/26/democratic-socialists-of-america-backs-131-candidates-in-30-states-ahead-of-nov-3-elections/" } ] } ``` ### Officeholders for coordinate - Capability: `districts/officeholders_for_coordinate` - Description: Current officeholders for a coordinate from Ballotpedia's Who Represents Me: districts (congressional, state legislative, state, and local where Ballotpedia covers it) with their offices and the people currently holding them, with party, Ballotpedia article URL and photo. Returns not_found for a coordinate outside Ballotpedia's US coverage. - Instructions: Who represents this location right now. For districts and elections use districts_for_coordinate. - Cost: 5 credits per call - Capability file: [Officeholders for coordinate](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/officeholders_for_coordinate) Accepted options: - `lat` (number, required): lat Example: `10` - `long` (number, required): long Example: `10` Response schema example: ```json { "district_count": 4, "districts": [ { "id": 430, "name": "Wisconsin District 2", "offices": [ { "branch": "Legislative", "id": 10859, "level": "Federal", "name": "U.S. House Wisconsin District 2", "officeholders": [ { "last_name": "Pocan", "name": "Mark Pocan", "partisan_affiliation_code": 2, "party": "Democratic Party", "person_id": 37193, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/400px-Mark_Pocan_official_photo.jpg", "status": "Current", "url": "https://ballotpedia.org/Mark_Pocan" } ] } ], "precise_boundary": true, "state": "WI", "type": "Congress" }, { "id": 2452, "name": "Wisconsin State Senate District 26", "offices": [ { "branch": "Legislative", "id": 28870, "level": "State", "name": "Wisconsin State Senate District 26", "officeholders": [ { "last_name": "Roys", "name": "Kelda Roys", "partisan_affiliation_code": 2, "party": "Democratic Party", "person_id": 31647, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/KHR-headshot-as-of-feb-2025-lite_20260625_190523_42508_1.jpg", "status": "Current", "url": "https://ballotpedia.org/Kelda_Roys" } ] } ], "precise_boundary": true, "state": "WI", "type": "State Legislative (Upper)" }, { "id": 7302, "name": "Wisconsin State Assembly District 76", "offices": [ { "branch": "Legislative", "id": 11319, "level": "State", "name": "Wisconsin State Assembly District 76", "officeholders": [ { "last_name": "Hong", "name": "Francesca Hong", "partisan_affiliation_code": 2, "party": "Democratic Party", "person_id": 330225, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/Francesca_Hong_20230521_075010.jpg", "status": "Current", "url": "https://ballotpedia.org/Francesca_Hong" } ] } ], "precise_boundary": true, "state": "WI", "type": "State Legislative (Lower)" }, { "id": 562, "name": "Wisconsin", "offices": [ { "branch": "Executive", "id": 9723, "level": "State", "name": "Attorney General of Wisconsin", "officeholders": [ { "last_name": "Kaul", "name": "Josh Kaul", "partisan_affiliation_code": 2, "party": "Democratic Party", "person_id": 294103, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/Josh_Kaul_for_Attorney_General.jpg", "status": "Current", "url": "https://ballotpedia.org/Josh_Kaul" } ] }, { "branch": "Legislative", "id": 11813, "level": "Federal", "name": "U.S. Senate Wisconsin", "officeholders": [ { "last_name": "Baldwin", "name": "Tammy Baldwin", "partisan_affiliation_code": 2, "party": "Democratic Party", "person_id": 53821, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/Tammy_Baldwin.jpg", "status": "Current", "url": "https://ballotpedia.org/Tammy_Baldwin" }, { "last_name": "Johnson", "name": "Ronald Harold Johnson", "partisan_affiliation_code": 1, "party": "Republican Party", "person_id": 48568, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/Ron_Johnson.jpg", "status": "Current", "url": "https://ballotpedia.org/Ron_Johnson_(Wisconsin)" } ] }, { "branch": "Executive", "id": 14513, "level": "State", "name": "Lieutenant Governor of Wisconsin", "officeholders": [ { "last_name": "Rodriguez", "name": "Sara Rodriguez", "partisan_affiliation_code": 2, "party": "Democratic Party", "person_id": 329836, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/Sara_Rodriguez.PNG", "status": "Current", "url": "https://ballotpedia.org/Sara_Rodriguez" } ] }, { "branch": "Executive", "id": 20865, "level": "State", "name": "Wisconsin Superintendent of Public Instruction", "officeholders": [ { "last_name": "Underly", "name": "Jill Underly", "partisan_affiliation_code": 7, "party": "Nonpartisan", "person_id": 335652, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/JillUnderly2024.jpg", "status": "Current", "url": "https://ballotpedia.org/Jill_Underly" } ] }, { "branch": "Judicial", "id": 10347, "level": "State", "name": "Wisconsin Supreme Court", "officeholders": [ { "last_name": "Crawford", "name": "Susan Crawford", "partisan_affiliation_code": 7, "party": "Nonpartisan", "person_id": 293382, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/scrawford.jpg", "status": "Current", "url": "https://ballotpedia.org/Susan_Crawford_(Wisconsin)" }, { "last_name": "Dallet", "name": "Rebecca Dallet", "partisan_affiliation_code": 7, "party": "Nonpartisan", "person_id": 293943, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/Rebecca-Dallet.png", "status": "Current", "url": "https://ballotpedia.org/Rebecca_Dallet" }, { "last_name": "Hagedorn", "name": "Brian Hagedorn", "partisan_affiliation_code": 7, "party": "Nonpartisan", "person_id": 61839, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/Brian-Hagedorn.jpg", "status": "Current", "url": "https://ballotpedia.org/Brian_Hagedorn" }, { "last_name": "Karofsky", "name": "Jill Karofsky", "partisan_affiliation_code": 7, "party": "Nonpartisan", "person_id": 96029, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/jkarofsky_2026-06-02_211145.png", "status": "Current", "url": "https://ballotpedia.org/Jill_Karofsky" }, { "last_name": "Protasiewicz", "name": "Janet Claire Protasiewicz", "partisan_affiliation_code": 7, "party": "Nonpartisan", "person_id": 73085, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/JanetProtasiewicz.jpg", "status": "Current", "url": "https://ballotpedia.org/Janet_Claire_Protasiewicz" }, { "last_name": "Taylor", "name": "Chris Taylor", "partisan_affiliation_code": 7, "party": "Nonpartisan", "person_id": 8994, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/Chris_Taylor.jpg", "status": "Current", "url": "https://ballotpedia.org/Chris_Taylor_(Wisconsin)" }, { "last_name": "Ziegler", "name": "Annette Ziegler", "partisan_affiliation_code": 7, "party": "Nonpartisan", "person_id": 60263, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/Annette-Ziegler.jpg", "status": "Current", "url": "https://ballotpedia.org/Annette_Ziegler" } ] }, { "branch": "Executive", "id": 401, "level": "State", "name": "Governor of Wisconsin", "officeholders": [ { "last_name": "Evers", "name": "Tony Evers", "partisan_affiliation_code": 2, "party": "Democratic Party", "person_id": 56270, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/Tony-Evers.jpg", "status": "Current", "url": "https://ballotpedia.org/Tony_Evers" } ] }, { "branch": "Executive", "id": 7210, "level": "State", "name": "Wisconsin Treasurer", "officeholders": [ { "last_name": "Leiber", "name": "John Leiber", "partisan_affiliation_code": 1, "party": "Republican Party", "person_id": 304582, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/State-Treasurer-John-Leiber-x-small_2__20260922_152253_34839_1.jpg", "status": "Current", "url": "https://ballotpedia.org/John_Leiber" } ] }, { "branch": "Executive", "id": 21638, "level": "State", "name": "Wisconsin Secretary of State", "officeholders": [ { "last_name": "Godlewski", "name": "Sarah Godlewski", "partisan_affiliation_code": 2, "party": "Democratic Party", "person_id": 298061, "photo_url": "https://s3.amazonaws.com/ballotpedia-api4/files/thumbs/200/300/SarahGodlewski.png", "status": "Current", "url": "https://ballotpedia.org/Sarah_Godlewski" } ] } ], "precise_boundary": true, "state": "WI", "type": "State" } ], "lat": 43.07545298388, "long": -89.388080960786, "observed_at_ms": 1790230423973, "office_count": 11, "officeholder_count": 18, "source_url": "https://api4.ballotpedia.org/wrm_redistricting?long=-89.388080960786&lat=43.07545298388" } ``` ### Statewide races - Capability: `districts/statewide_races` - Description: Statewide races and candidates for a US state by two-letter code, no address needed: governor, U.S. Senate, lieutenant governor, attorney general, secretary of state and other statewide offices, plus statewide ballot measures, for one election date (default: the next upcoming election). Each race lists its candidates with party, incumbency and ballot status and links to Ballotpedia's election article, e.g. the 2026 New Hampshire gubernatorial election (Democratic nominee, Republican incumbent, Libertarian). Elections since 2022 work. Returns not_found when Ballotpedia lists no statewide race or measure in the state on that date. - Instructions: Questions like 'who is running for governor of New Hampshire', 'who is the Democratic nominee for NH governor', 'which candidates are on the 2026 U.S. Senate ballot in Maine'. Candidate ids feed candidate_details (background, prior offices, endorsements, campaign website); ballot measure ids feed ballot_measure_details. For district, county and local races use geocode_address then ballot_for_date. - Cost: 5 credits per call - Capability file: [Statewide races](https://firecrawl.dev/alexandria/agents/providers/ballotpedia-org/districts/statewide_races) Accepted options: - `election` (string): Election date, YYYY-MM-DD, e.g. 2026-11-03 (general) or a primary date. Omit for the next upcoming election in the state. Pattern: ^[0-9]{4}-[0-9]{2}-[0-9]{2}$. Example: `` - `state` (string, required): Two-letter US state or DC postal code, e.g. NH for New Hampshire. Pattern: ^[A-Za-z]{2}$. Example: `` Response schema example: ```json { "ballot_measure_count": 1, "candidate_count": 6, "candidate_lists_complete": true, "district_count": 1, "districts": [ { "ballot_measures": [ { "district_type": "State", "id": 29252, "name": "New Hampshire Eliminate Office of Register of Probate Amendment (2026)" } ], "id": 541, "name": "New Hampshire", "precise_boundary": true, "races": [ { "candidates": [ { "id": 347484, "image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/CHRIS_PAPPAS.jpg", "is_incumbent": false, "is_write_in": false, "name": "Chris Pappas", "parties": [ { "id": 2, "name": "Democratic Party", "url": "https://ballotpedia.org/Democratic_Party" } ], "person_id": 95287, "running_mate": null, "status": "On the Ballot", "survey_exists": false, "url": "https://ballotpedia.org/Chris_Pappas", "withdrew_still_on_ballot": false }, { "id": 387979, "image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/2d1ee27058dab074de7ae6b2d7e94d6f.jpg", "is_incumbent": false, "is_write_in": false, "name": "John Sununu", "parties": [ { "id": 1, "name": "Republican Party", "url": "https://ballotpedia.org/Republican_Party" } ], "person_id": 709908, "running_mate": null, "status": "On the Ballot", "survey_exists": false, "url": "https://ballotpedia.org/John_E._Sununu", "withdrew_still_on_ballot": false }, { "id": 458749, "image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/Edmond_Laplante.jpg", "is_incumbent": false, "is_write_in": false, "name": "Edmond Laplante", "parties": [ { "id": 6, "name": "Constitution Party", "url": "https://ballotpedia.org/Constitution_Party" } ], "person_id": 343067, "running_mate": null, "status": "On the Ballot", "survey_exists": true, "url": "https://ballotpedia.org/Edmond_Laplante", "withdrew_still_on_ballot": false } ], "id": 62972, "number_of_seats": 1, "office": { "branch": "Legislative", "chamber": "Upper", "id": 3526, "is_partisan": "Partisan all", "level": "Federal", "name": "U.S. Senate New Hampshire", "type": "Senator", "url": "https://ballotpedia.org/List_of_United_States_Senators_from_New_Hampshire" }, "office_position": null, "race_type": "Regular", "stage_type": "General", "url": "https://ballotpedia.org/United_States_Senate_election_in_New_Hampshire,_2026" }, { "candidates": [ { "id": 406056, "image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/Cinde_Warmington.jpg", "is_incumbent": false, "is_write_in": false, "name": "Cinde Warmington", "parties": [ { "id": 2, "name": "Democratic Party", "url": "https://ballotpedia.org/Democratic_Party" } ], "person_id": 330453, "running_mate": null, "status": "On the Ballot", "survey_exists": false, "url": "https://ballotpedia.org/Cinde_Warmington", "withdrew_still_on_ballot": false }, { "id": 447342, "image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/Kelly_Ayotte.jpg", "is_incumbent": true, "is_write_in": false, "name": "Kelly Ayotte", "parties": [ { "id": 1, "name": "Republican Party", "url": "https://ballotpedia.org/Republican_Party" } ], "person_id": 31679, "running_mate": null, "status": "On the Ballot", "survey_exists": false, "url": "https://ballotpedia.org/Kelly_Ayotte", "withdrew_still_on_ballot": false }, { "id": 461251, "image_url": "https://ballotpedia-api4.s3.amazonaws.com/files/Stephen-Villee-Headshots-_4-of-10_-2_20260906_183208_53895_1.jpg", "is_incumbent": false, "is_write_in": false, "name": "Stephen Villee", "parties": [ { "id": 3, "name": "Libertarian Party", "url": "https://ballotpedia.org/Libertarian_Party" } ], "person_id": 560315, "running_mate": null, "status": "On the Ballot", "survey_exists": true, "url": "https://ballotpedia.org/Stephen_Villee", "withdrew_still_on_ballot": false } ], "id": 76772, "number_of_seats": 1, "office": { "branch": "Executive", "chamber": null, "id": 8139, "is_partisan": "Partisan all", "level": "State", "name": "Governor of New Hampshire", "type": "Governor", "url": "https://ballotpedia.org/Governor_of_New_Hampshire" }, "office_position": null, "race_type": "Regular", "stage_type": "General", "url": "https://ballotpedia.org/New_Hampshire_gubernatorial_election,_2026" } ], "type": "State" } ], "election_date": "2026-11-03", "lat": 43.2067, "long": -71.5381, "observed_at_ms": 1793746791875, "polling_place_locator_url": "https://app.sos.nh.gov/pollingplacesampleballot", "race_count": 2, "source_url": "https://api4.ballotpedia.org/test", "state": { "abbreviation": "NH", "id": 541, "name": "New Hampshire" }, "state_code": "NH" } ```