--- type: "firecrawl-provider" description: "Clarity Election Night Reporting (results.enr.clarityelections.com), the results site that hundreds of US county election offices and several state election offices (for example Iowa, Kentucky, West Virginia and Arkansas statewide, and many New Jersey, Michigan, Colorado and other counties) publish official election-night and canvass results on. Lists a jurisdiction's elections, returns every contest of an election (federal, state, county, municipal, school and judicial races and ballot questions) with candidates, parties, votes, percentages, precincts reporting and winner flags, and breaks one contest down by precinct (county sites) or county (state sites). Reads the anonymous JSON files behind the ENR web app; results are unofficial until certified. Jurisdictions that run their own systems (statewide sites of Georgia, Pennsylvania, Arizona, Texas, California, Florida and others) are not on Clarity; a county there may still be." use_when: "Clarity Election Night Reporting (results.enr.clarityelections.com), the results site that hundreds of US county election offices and several state election offices (for example Iowa, Kentucky, West Virginia and Arkansas statewide, and many New Jersey, Michigan, Colorado and other counties) publish official election-night and canvass results on. Lists a jurisdiction's elections, returns every contest of an election (federal, state, county, municipal, school and judicial races and ballot questions) with candidates, parties, votes, percentages, precincts reporting and winner flags, and breaks one contest down by precinct (county sites) or county (state sites). Reads the anonymous JSON files behind the ENR web app; results are unofficial until certified. Jurisdictions that run their own systems (statewide sites of Georgia, Pennsylvania, Arizona, Texas, California, Florida and others) are not on Clarity; a county there may still be." categories: "Public records" capabilities: 3 credits_per_call: 5 --- # Clarity Elections ENR official election results on Firecrawl Alexandria Clarity Election Night Reporting (results.enr.clarityelections.com), the results site that hundreds of US county election offices and several state election offices (for example Iowa, Kentucky, West Virginia and Arkansas statewide, and many New Jersey, Michigan, Colorado and other counties) publish official election-night and canvass results on. Lists a jurisdiction's elections, returns every contest of an election (federal, state, county, municipal, school and judicial races and ballot questions) with candidates, parties, votes, percentages, precincts reporting and winner flags, and breaks one contest down by precinct (county sites) or county (state sites). Reads the anonymous JSON files behind the ENR web app; results are unofficial until certified. Jurisdictions that run their own systems (statewide sites of Georgia, Pennsylvania, Arizona, Texas, California, Florida and others) are not on Clarity; a county there may still be. - Categories: Public records - Category index: [Public records category](https://firecrawl.dev/alexandria/agents/categories/public-records) - Provider key: `results-enr-clarityelections-com` - Access: Firecrawl credits - Cost: 5 credits per call ## More - [Human guide](https://firecrawl.dev/app/alexandria/results-enr-clarityelections-com) - [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/results-enr-clarityelections-com/openapi.json) ## Capabilities - [Get contest details](https://firecrawl.dev/alexandria/agents/providers/results-enr-clarityelections-com/elections/get_contest_details): One contest broken down by reporting area: per-precinct votes on county sites, per-county votes with precincts reporting on state sites, each with every choice's votes and the area total, plus the contest's summary totals. Four GETs (version, summary, settings, details.json). - [Get results](https://firecrawl.dev/alexandria/agents/providers/results-enr-clarityelections-com/elections/get_results): Every contest of one election with candidates, parties, votes, percentages, vote-for count, precincts reporting, registered voters and ballots cast where published, and the winner, recount and runoff flags the office sets; optional contest-name and category filters. State sites also list each participating county's election id, upload version and last update time. Reads the newest upload (current_ver.txt) unless version is pinned; three GETs. - [List elections](https://firecrawl.dev/alexandria/agents/providers/results-enr-clarityelections-com/elections/list_elections): Elections a Clarity ENR site lists, newest first: election id, name, date and results URL. A state site (state only, e.g. IA) or a county site (state plus county, e.g. NJ + Cumberland). One GET of elections.json. ## 1. Choose this provider when Clarity Election Night Reporting (results.enr.clarityelections.com), the results site that hundreds of US county election offices and several state election offices (for example Iowa, Kentucky, West Virginia and Arkansas statewide, and many New Jersey, Michigan, Colorado and other counties) publish official election-night and canvass results on. Lists a jurisdiction's elections, returns every contest of an election (federal, state, county, municipal, school and judicial races and ballot questions) with candidates, parties, votes, percentages, precincts reporting and winner flags, and breaks one contest down by precinct (county sites) or county (state sites). Reads the anonymous JSON files behind the ENR web app; results are unofficial until certified. Jurisdictions that run their own systems (statewide sites of Georgia, Pennsylvania, Arizona, Texas, California, Florida and others) are not on Clarity; a county there may still be. ## 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": "results-enr-clarityelections-com", "capability": "elections/get_contest_details", "options": { "contest_id": "9", "url": "https://results.enr.clarityelections.com/NJ/Cumberland/127562/web.345435/#/summary" } } ``` ## 3. Add provider options Use only the options needed for the task: - `contest_id` (string, required): contest_id from get_results, e.g. 1. Pattern: ^[0-9]{1,12}$. Example: `` - `county` (string): County path segment exactly as the site writes it after the state (case-sensitive), e.g. Cumberland, Black_Hawk; spaces become underscores. Omit for a state-level site. Example: `` - `election_id` (string): Clarity election id (EID) from list_elections or from the site URL, e.g. 127562. Pattern: ^[0-9]{1,12}$. Example: `` - `state` (string): Two-letter US state code of the Clarity site, e.g. IA (a state site) or NJ with county Cumberland (a county site). Case-insensitive. Pattern: ^[A-Za-z]{2}$. Example: `` - `url` (string): A pasted results.enr.clarityelections.com URL such as https://results.enr.clarityelections.com/NJ/Cumberland/127562/web.345435/#/summary; state, county and election id are read from its path. Takes precedence over state and county. Example: `` - `version` (string): Pin one published upload (the number current_ver.txt returns, echoed as election.version). Omit for the newest upload. Pattern: ^[0-9]{1,12}$. Example: `` ## 4. Request through your preferred interface ### JavaScript ```javascript const result = await firecrawl.scrape({ alexandria: { provider: "results-enr-clarityelections-com", capability: "elections/get_contest_details", options: { contest_id: "9", url: "https://results.enr.clarityelections.com/NJ/Cumberland/127562/web.345435/#/summary", }, }, }); ``` ### Python ```python result = firecrawl.scrape_alexandria({ "provider": "results-enr-clarityelections-com", "capability": "elections/get_contest_details", "options": { "contest_id": "9", "url": "https://results.enr.clarityelections.com/NJ/Cumberland/127562/web.345435/#/summary" } }) ``` ### cURL ```sh curl https://api.firecrawl.dev/v2/scrape \ -H "Authorization: Bearer $FIRECRAWL_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "alexandria": { "provider": "results-enr-clarityelections-com", "capability": "elections/get_contest_details", "options": { "contest_id": "9", "url": "https://results.enr.clarityelections.com/NJ/Cumberland/127562/web.345435/#/summary" } } }' ``` ### CLI ```sh firecrawl scrape 'results-enr-clarityelections-com/elections/get_contest_details' \ --options '{"contest_id":"9","url":"https://results.enr.clarityelections.com/NJ/Cumberland/127562/web.345435/#/summary"}' ``` ### MCP Call the FCX MCP retrieve tool with this object: ```json { "provider": "results-enr-clarityelections-com", "capability": "elections/get_contest_details", "options": { "contest_id": "9", "url": "https://results.enr.clarityelections.com/NJ/Cumberland/127562/web.345435/#/summary" } } ``` Ask for only the returned fields needed by the task. ## 5. Full request shape ```json { "provider": "results-enr-clarityelections-com", "capability": "elections/get_contest_details", "options": { "contest_id": "9", "url": "https://results.enr.clarityelections.com/NJ/Cumberland/127562/web.345435/#/summary" } } ``` ## 6. Response data The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`: ```json { "area_level": "precinct", "areas": [ { "choices": [ { "name": "Dominick A. PATITUCCI", "votes": 0 }, { "name": "John A. WOLBERT, Jr.", "votes": 0 }, { "name": "Write-In", "votes": 0 } ], "level": "precinct", "name": "Deerfield 1", "precincts_reporting": null, "precincts_total": null, "total_votes": 0 }, { "choices": [ { "name": "Dominick A. PATITUCCI", "votes": 0 }, { "name": "John A. WOLBERT, Jr.", "votes": 0 }, { "name": "Write-In", "votes": 0 } ], "level": "precinct", "name": "Deerfield Prov", "precincts_reporting": null, "precincts_total": null, "total_votes": 0 } ], "contest": { "ballots_cast": null, "category": "Municipal", "choices": [ { "name": "Dominick A. PATITUCCI", "party": "REP", "percent": 0, "recount": false, "runoff": false, "votes": 0, "winner": false }, { "name": "John A. WOLBERT, Jr.", "party": "REP", "percent": 0, "recount": false, "runoff": false, "votes": 0, "winner": false }, { "name": "Write-In", "party": null, "percent": 0, "recount": false, "runoff": false, "votes": 0, "winner": false } ], "contest_id": "9", "name": "Deerfield Township Committee", "precincts_reporting": 0, "precincts_total": 2, "ranked_choice": false, "registered_voters": null, "total_votes": 0, "vote_for": 2 }, "count": 2, "election": { "county": "Cumberland", "date": "2026-11-03", "election_id": "127562", "name": "2026 GENERAL ELECTION", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/127562/", "site_level": "county", "state": "NJ", "version": "381805" }, "observed_at_ms": 1793104503743, "source_url": "https://results.enr.clarityelections.com/NJ/Cumberland/127562/381805/json/details.json", "status_note": "Election-night results are unofficial until the election office certifies them; vote totals change with each upload (see election.version)." } ``` ## API reference-derived contract The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec. ### Get contest details - Capability: `elections/get_contest_details` - Description: One contest broken down by reporting area: per-precinct votes on county sites, per-county votes with precincts reporting on state sites, each with every choice's votes and the area total, plus the contest's summary totals. Four GETs (version, summary, settings, details.json). - Instructions: Where a candidate or ballot question is winning or losing inside a county or state, precinct-level margins, or which counties have not finished reporting. - Cost: 5 credits per call - Capability file: [Get contest details](https://firecrawl.dev/alexandria/agents/providers/results-enr-clarityelections-com/elections/get_contest_details) Accepted options: - `contest_id` (string, required): contest_id from get_results, e.g. 1. Pattern: ^[0-9]{1,12}$. Example: `` - `county` (string): County path segment exactly as the site writes it after the state (case-sensitive), e.g. Cumberland, Black_Hawk; spaces become underscores. Omit for a state-level site. Example: `` - `election_id` (string): Clarity election id (EID) from list_elections or from the site URL, e.g. 127562. Pattern: ^[0-9]{1,12}$. Example: `` - `state` (string): Two-letter US state code of the Clarity site, e.g. IA (a state site) or NJ with county Cumberland (a county site). Case-insensitive. Pattern: ^[A-Za-z]{2}$. Example: `` - `url` (string): A pasted results.enr.clarityelections.com URL such as https://results.enr.clarityelections.com/NJ/Cumberland/127562/web.345435/#/summary; state, county and election id are read from its path. Takes precedence over state and county. Example: `` - `version` (string): Pin one published upload (the number current_ver.txt returns, echoed as election.version). Omit for the newest upload. Pattern: ^[0-9]{1,12}$. Example: `` Response schema example: ```json { "area_level": "precinct", "areas": [ { "choices": [ { "name": "Dominick A. PATITUCCI", "votes": 0 }, { "name": "John A. WOLBERT, Jr.", "votes": 0 }, { "name": "Write-In", "votes": 0 } ], "level": "precinct", "name": "Deerfield 1", "precincts_reporting": null, "precincts_total": null, "total_votes": 0 }, { "choices": [ { "name": "Dominick A. PATITUCCI", "votes": 0 }, { "name": "John A. WOLBERT, Jr.", "votes": 0 }, { "name": "Write-In", "votes": 0 } ], "level": "precinct", "name": "Deerfield Prov", "precincts_reporting": null, "precincts_total": null, "total_votes": 0 } ], "contest": { "ballots_cast": null, "category": "Municipal", "choices": [ { "name": "Dominick A. PATITUCCI", "party": "REP", "percent": 0, "recount": false, "runoff": false, "votes": 0, "winner": false }, { "name": "John A. WOLBERT, Jr.", "party": "REP", "percent": 0, "recount": false, "runoff": false, "votes": 0, "winner": false }, { "name": "Write-In", "party": null, "percent": 0, "recount": false, "runoff": false, "votes": 0, "winner": false } ], "contest_id": "9", "name": "Deerfield Township Committee", "precincts_reporting": 0, "precincts_total": 2, "ranked_choice": false, "registered_voters": null, "total_votes": 0, "vote_for": 2 }, "count": 2, "election": { "county": "Cumberland", "date": "2026-11-03", "election_id": "127562", "name": "2026 GENERAL ELECTION", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/127562/", "site_level": "county", "state": "NJ", "version": "381805" }, "observed_at_ms": 1793104503743, "source_url": "https://results.enr.clarityelections.com/NJ/Cumberland/127562/381805/json/details.json", "status_note": "Election-night results are unofficial until the election office certifies them; vote totals change with each upload (see election.version)." } ``` ### Get results - Capability: `elections/get_results` - Description: Every contest of one election with candidates, parties, votes, percentages, vote-for count, precincts reporting, registered voters and ballots cast where published, and the winner, recount and runoff flags the office sets; optional contest-name and category filters. State sites also list each participating county's election id, upload version and last update time. Reads the newest upload (current_ver.txt) unless version is pinned; three GETs. - Instructions: Election-night or canvass results for a county or state on Clarity, including down-ballot and local races (city council, school board, ballot questions) national outlets skip. Poll by re-calling: election.version changes with each upload. - Cost: 5 credits per call - Capability file: [Get results](https://firecrawl.dev/alexandria/agents/providers/results-enr-clarityelections-com/elections/get_results) Accepted options: - `category` (string): Only contests whose ballot section contains this text (case-insensitive), e.g. Federal, County, Municipal. Example: `` - `contest` (string): Only contests whose name contains this text (case-insensitive), e.g. Senator, Mayor, School Board. Example: `` - `county` (string): County path segment exactly as the site writes it after the state (case-sensitive), e.g. Cumberland, Black_Hawk; spaces become underscores. Omit for a state-level site. Example: `` - `election_id` (string): Clarity election id (EID) from list_elections or from the site URL, e.g. 127562. Pattern: ^[0-9]{1,12}$. Example: `` - `state` (string): Two-letter US state code of the Clarity site, e.g. IA (a state site) or NJ with county Cumberland (a county site). Case-insensitive. Pattern: ^[A-Za-z]{2}$. Example: `` - `url` (string): A pasted results.enr.clarityelections.com URL such as https://results.enr.clarityelections.com/NJ/Cumberland/127562/web.345435/#/summary; state, county and election id are read from its path. Takes precedence over state and county. Example: `` - `version` (string): Pin one published upload (the number current_ver.txt returns, echoed as election.version). Omit for the newest upload. Pattern: ^[0-9]{1,12}$. Example: `` Response schema example: ```json { "contests": [ { "ballots_cast": null, "category": "Federal", "choices": [ { "name": "Cory BOOKER", "party": "DEM", "percent": 0, "recount": false, "runoff": false, "votes": 0, "winner": false }, { "name": "Justin MURPHY", "party": "REP", "percent": 0, "recount": false, "runoff": false, "votes": 0, "winner": false }, { "name": "Joanne KUNIANSKY", "party": "SOC", "percent": 0, "recount": false, "runoff": false, "votes": 0, "winner": false }, { "name": "Veronica FERNANDEZ", "party": null, "percent": 0, "recount": false, "runoff": false, "votes": 0, "winner": false }, { "name": "Write-In", "party": null, "percent": 0, "recount": false, "runoff": false, "votes": 0, "winner": false } ], "contest_id": "1", "name": "United States Senator", "precincts_reporting": 0, "precincts_total": 106, "ranked_choice": false, "registered_voters": null, "total_votes": 0, "vote_for": 1 } ], "count": 1, "election": { "county": "Cumberland", "date": "2026-11-03", "election_id": "127562", "name": "2026 GENERAL ELECTION", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/127562/", "site_level": "county", "state": "NJ", "version": "381805" }, "last_modified": null, "observed_at_ms": 1793104503737, "source_url": "https://results.enr.clarityelections.com/NJ/Cumberland/127562/381805/json/en/summary.json", "status_note": "Election-night results are unofficial until the election office certifies them; vote totals change with each upload (see election.version).", "subjurisdictions": [], "total_contests": 43 } ``` ### List elections - Capability: `elections/list_elections` - Description: Elections a Clarity ENR site lists, newest first: election id, name, date and results URL. A state site (state only, e.g. IA) or a county site (state plus county, e.g. NJ + Cumberland). One GET of elections.json. - Instructions: Find the election id of a county's or state's election (e.g. the 2026 General Election) before get_results, or check whether a jurisdiction publishes on Clarity at all (not_found when it has no Clarity site). - Cost: 5 credits per call - Capability file: [List elections](https://firecrawl.dev/alexandria/agents/providers/results-enr-clarityelections-com/elections/list_elections) Accepted options: - `county` (string): County path segment exactly as the site writes it after the state (case-sensitive), e.g. Cumberland, Black_Hawk; spaces become underscores. Omit for a state-level site. Example: `` - `state` (string): Two-letter US state code of the Clarity site, e.g. IA (a state site) or NJ with county Cumberland (a county site). Case-insensitive. Pattern: ^[A-Za-z]{2}$. Example: `` - `url` (string): A pasted results.enr.clarityelections.com URL such as https://results.enr.clarityelections.com/NJ/Cumberland/127562/web.345435/#/summary; state, county and election id are read from its path. Takes precedence over state and county. Example: `` Response schema example: ```json { "count": 25, "county": "Cumberland", "elections": [ { "county": "Cumberland", "date": "2026-11-03", "election_id": "127562", "name": "2026 GENERAL ELECTION", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/127562/", "state": "NJ" }, { "county": "Cumberland", "date": "2026-06-02", "election_id": "126483", "name": "2026 PRIMARY ELECTION", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/126483/", "state": "NJ" }, { "county": "Cumberland", "date": "2025-12-09", "election_id": "125661", "name": "2025 CRHS SPECIAL SCHOOL ELECTION", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/125661/", "state": "NJ" }, { "county": "Cumberland", "date": "2025-11-04", "election_id": "125167", "name": "2025 GENERAL ELECTION", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/125167/", "state": "NJ" }, { "county": "Cumberland", "date": "2025-06-10", "election_id": "123853", "name": "2025 PRIMARY ELECTION", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/123853/", "state": "NJ" }, { "county": "Cumberland", "date": "2024-11-05", "election_id": "122757", "name": "2024 GENERAL ELECTION", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/122757/", "state": "NJ" }, { "county": "Cumberland", "date": "2024-06-04", "election_id": "121724", "name": "2024 PRIMARY ELECTION", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/121724/", "state": "NJ" }, { "county": "Cumberland", "date": "2023-11-07", "election_id": "119033", "name": "2023 GENERAL ELECTION", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/119033/", "state": "NJ" }, { "county": "Cumberland", "date": "2023-06-06", "election_id": "118172", "name": "2023 Primary Election", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/118172/", "state": "NJ" }, { "county": "Cumberland", "date": "2022-11-08", "election_id": "116177", "name": "2022 GENERAL ELECTION", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/116177/", "state": "NJ" }, { "county": "Cumberland", "date": "2022-06-07", "election_id": "114203", "name": "2022 Primary Election", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/114203/", "state": "NJ" }, { "county": "Cumberland", "date": "2021-11-02", "election_id": "111506", "name": "2021 General", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/111506/", "state": "NJ" }, { "county": "Cumberland", "date": "2021-06-08", "election_id": "109582", "name": "2021 PRIMARY ELECTION", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/109582/", "state": "NJ" }, { "county": "Cumberland", "date": "2020-11-03", "election_id": "107141", "name": "2020 General Election", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/107141/", "state": "NJ" }, { "county": "Cumberland", "date": "2020-07-07", "election_id": "104479", "name": "2020 Primary", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/104479/", "state": "NJ" }, { "county": "Cumberland", "date": "2019-11-05", "election_id": "99212", "name": "2019 General Election", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/99212/", "state": "NJ" }, { "county": "Cumberland", "date": "2019-06-04", "election_id": "95927", "name": "2019 Primary Election", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/95927/", "state": "NJ" }, { "county": "Cumberland", "date": "2018-11-06", "election_id": "93016", "name": "2018 General Election", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/93016/", "state": "NJ" }, { "county": "Cumberland", "date": "2018-06-05", "election_id": "75756", "name": "2018 Primary", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/75756/", "state": "NJ" }, { "county": "Cumberland", "date": "2017-11-07", "election_id": "72006", "name": "2017 General", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/72006/", "state": "NJ" }, { "county": "Cumberland", "date": "2017-06-06", "election_id": "70221", "name": "Primary Election 2017", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/70221/", "state": "NJ" }, { "county": "Cumberland", "date": "2016-11-08", "election_id": "64715", "name": "General Election 2016", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/64715/", "state": "NJ" }, { "county": "Cumberland", "date": "2016-06-07", "election_id": "62732", "name": "2016 Primary", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/62732/", "state": "NJ" }, { "county": "Cumberland", "date": "2015-12-21", "election_id": "58625", "name": "Special Electon", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/58625/", "state": "NJ" }, { "county": "Cumberland", "date": "2015-11-03", "election_id": "57844", "name": "2015 General Election", "results_url": "https://results.enr.clarityelections.com/NJ/Cumberland/57844/", "state": "NJ" } ], "observed_at_ms": 1793104503731, "site_level": "county", "source_url": "https://results.enr.clarityelections.com/NJ/Cumberland/elections.json", "state": "NJ" } ```