---
type: "firecrawl-provider"
description: "Harvard Dataverse (dataverse.harvard.edu), where the MIT Election Data and Science Lab (MEDSL) publishes its cleaned US election returns: search datasets in the MEDSL dataverse (or any Harvard dataverse alias), read a dataset's metadata, licence, citation and file list from the native API, and filter one race's rows (year, state, office, district, county, candidate, party, stage, mode) out of a CSV/TSV return file with HTTP range reads. Every record carries the dataset DOI and citation. All 55 MEDSL datasets are CC0 1.0. Datasets behind a Dataverse guestbook (U.S. House 1976-2024, County Presidential 2000-2024, the 2018 and 2020 precinct releases and others) are metadata-only: the program never submits a guestbook response."
use_when: "Harvard Dataverse (dataverse.harvard.edu), where the MIT Election Data and Science Lab (MEDSL) publishes its cleaned US election returns: search datasets in the MEDSL dataverse (or any Harvard dataverse alias), read a dataset's metadata, licence, citation and file list from the native API, and filter one race's rows (year, state, office, district, county, candidate, party, stage, mode) out of a CSV/TSV return file with HTTP range reads. Every record carries the dataset DOI and citation. All 55 MEDSL datasets are CC0 1.0. Datasets behind a Dataverse guestbook (U.S. House 1976-2024, County Presidential 2000-2024, the 2018 and 2020 precinct releases and others) are metadata-only: the program never submits a guestbook response."
categories: "Research"
capabilities: 3
credits_per_call: 5
---
# Harvard Dataverse: MIT Election Data and Science Lab returns on Firecrawl Alexandria

Harvard Dataverse (dataverse.harvard.edu), where the MIT Election Data and Science Lab (MEDSL) publishes its cleaned US election returns: search datasets in the MEDSL dataverse (or any Harvard dataverse alias), read a dataset's metadata, licence, citation and file list from the native API, and filter one race's rows (year, state, office, district, county, candidate, party, stage, mode) out of a CSV/TSV return file with HTTP range reads. Every record carries the dataset DOI and citation. All 55 MEDSL datasets are CC0 1.0. Datasets behind a Dataverse guestbook (U.S. House 1976-2024, County Presidential 2000-2024, the 2018 and 2020 precinct releases and others) are metadata-only: the program never submits a guestbook response.

- Categories: Research
- Category index: [Research category](https://firecrawl.dev/alexandria/agents/categories/research)
- Provider key: `dataverse-harvard-edu`
- Access: Firecrawl credits
- Cost: 5 credits per call

## More

- [Human guide](https://firecrawl.dev/app/alexandria/dataverse-harvard-edu)
- [OpenAPI spec](https://firecrawl.dev/alexandria/agents/providers/dataverse-harvard-edu/openapi.json)

## Capabilities

- [Get dataset](https://firecrawl.dev/alexandria/agents/providers/dataverse-harvard-edu/elections/get_dataset): One published dataset from the Harvard Dataverse native API by DOI or dataset page URL: title, description, authors, keywords, topics, related datasets, version and release time, licence (name, URI, SPDX id), terms, whether a guestbook gates downloads, a citation with DOI and version, and every file with id, size, content type, tabular/original format, MD5, whether `query_returns` can read it and its bytes. Unknown DOIs are `not_found`.
- [Query returns](https://firecrawl.dev/alexandria/agents/providers/dataverse-harvard-edu/elections/query_returns): Rows of one CSV/TSV file of a dataset that match the filters: year, state (name or postal code), office (substring, e.g. SENATE), district (numeric match, `001` = `1`), county (name or FIPS), candidate (substring), party (substring of party_detailed/simplified), stage (gen/pri) and mode. Each row has MEDSL's common columns normalized (candidate, party, votes, total votes, writein, special, mode, county, precinct) plus every column as published, and the dataset DOI and citation. The file is read with HTTP range requests from Dataverse's signed storage URL, at most 24 MiB per call: statewide files (Senate 1976-2024 ~0.5 MB, President 1976-2024 ~0.5 MB) finish in one call; precinct files (2-420 MB) continue with `next_offset`, so prefer the per-state files of the `Precinct-Level Returns <year> by Individual State` datasets. Guestbook-gated, restricted and non-delimited files are `invalid_input`; an unknown file is `not_found`.
- [Search datasets](https://firecrawl.dev/alexandria/agents/providers/dataverse-harvard-edu/elections/search_datasets): Search published datasets in a Harvard Dataverse collection and its sub-dataverses through the public search API. Defaults to the MEDSL dataverse (`medsl`: U.S. House, Senate and President returns, county presidential returns, precinct-level returns 2016-2024 by office and by state, election night returns, Elections Performance Index). Returns DOI, title, description, dataverse, citation, authors, keywords, file count and version, 1-100 per page. An unknown dataverse alias is `not_found`.

## 1. Choose this provider when

Harvard Dataverse (dataverse.harvard.edu), where the MIT Election Data and Science Lab (MEDSL) publishes its cleaned US election returns: search datasets in the MEDSL dataverse (or any Harvard dataverse alias), read a dataset's metadata, licence, citation and file list from the native API, and filter one race's rows (year, state, office, district, county, candidate, party, stage, mode) out of a CSV/TSV return file with HTTP range reads. Every record carries the dataset DOI and citation. All 55 MEDSL datasets are CC0 1.0. Datasets behind a Dataverse guestbook (U.S. House 1976-2024, County Presidential 2000-2024, the 2018 and 2020 precinct releases and others) are metadata-only: the program never submits a guestbook response.

## 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": "dataverse-harvard-edu",
  "capability": "elections/get_dataset",
  "options": {
    "doi": "doi:10.7910/DVN/PEJ5QU"
  }
}
```

## 3. Add provider options

Use only the options needed for the task:

- `doi` (string): Dataset DOI: doi:10.7910/DVN/PEJ5QU, 10.7910/DVN/PEJ5QU or https://doi.org/10.7910/DVN/PEJ5QU. Example: `<doi>`
- `url` (string): Dataset page URL, e.g. https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/PEJ5QU. Pattern: ^https?://. Example: `<url>`

## 4. Request through your preferred interface

### JavaScript

```javascript
const result = await firecrawl.scrape({
  alexandria: {
    provider: "dataverse-harvard-edu",
    capability: "elections/get_dataset",
    options: {
      doi: "doi:10.7910/DVN/PEJ5QU",
    },
  },
});
```

### Python

```python
result = firecrawl.scrape_alexandria({
  "provider": "dataverse-harvard-edu",
  "capability": "elections/get_dataset",
  "options": {
    "doi": "doi:10.7910/DVN/PEJ5QU"
  }
})
```

### cURL

```sh
curl https://api.firecrawl.dev/v2/scrape \
  -H "Authorization: Bearer $FIRECRAWL_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "alexandria": {
    "provider": "dataverse-harvard-edu",
    "capability": "elections/get_dataset",
    "options": {
      "doi": "doi:10.7910/DVN/PEJ5QU"
    }
  }
}'
```

### CLI

```sh
firecrawl scrape 'dataverse-harvard-edu/elections/get_dataset' \
  --options '{"doi":"doi:10.7910/DVN/PEJ5QU"}'
```


### MCP

Call the FCX MCP retrieve tool with this object:

```json
{
  "provider": "dataverse-harvard-edu",
  "capability": "elections/get_dataset",
  "options": {
    "doi": "doi:10.7910/DVN/PEJ5QU"
  }
}
```

Ask for only the returned fields needed by the task.

## 5. Full request shape

```json
{
  "provider": "dataverse-harvard-edu",
  "capability": "elections/get_dataset",
  "options": {
    "doi": "doi:10.7910/DVN/PEJ5QU"
  }
}
```

## 6. Response data

The response includes `success`, `provider`, `capability`, `creditsCost` and `data`. This example shows the provider payload in `data`:

```json
{
  "authors": [
    "MIT Election Data and Science Lab"
  ],
  "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
  "description": "This data file contains constituency (state-level) returns for elections to the U.S. Senate from 1976 to 2024.",
  "doi": "doi:10.7910/DVN/PEJ5QU",
  "file_count": 3,
  "files": [
    {
      "content_type": "text/tab-separated-values",
      "description": "Elections returns data for US Senate at the statewide level ",
      "directory": null,
      "download_url": "https://dataverse.harvard.edu/api/access/datafile/13887039?format=original",
      "file_id": 13887039,
      "md5": "0f8b51cf0f77a2ef0bff992f7a64d1b4",
      "name": "1976-2024-senate-state.tab",
      "original_format": "text/comma-separated-values",
      "original_name": "1976-2024-senate-state.csv",
      "original_size_bytes": 530501,
      "query_size_bytes": 530501,
      "queryable": true,
      "restricted": false,
      "size_bytes": 632787,
      "tabular": true
    },
    {
      "content_type": "text/markdown",
      "description": "Codebook for the Senate elections returns data ",
      "directory": null,
      "download_url": "https://dataverse.harvard.edu/api/access/datafile/6708560",
      "file_id": 6708560,
      "md5": "1cab4bc42b0ca632223b9b9a90c65f30",
      "name": "codebook-us-senate-1976–2024.md",
      "original_format": null,
      "original_name": null,
      "original_size_bytes": null,
      "query_size_bytes": null,
      "queryable": false,
      "restricted": false,
      "size_bytes": 3700,
      "tabular": false
    },
    {
      "content_type": "text/tab-separated-values",
      "description": "sources for elections data",
      "directory": null,
      "download_url": "https://dataverse.harvard.edu/api/access/datafile/4304792?format=original",
      "file_id": 4304792,
      "md5": "d92c44441367c4acda59e8779dc62155",
      "name": "sources-senate.tab",
      "original_format": "text/csv",
      "original_name": "sources-senate.csv",
      "original_size_bytes": 3049,
      "query_size_bytes": 3049,
      "queryable": true,
      "restricted": false,
      "size_bytes": 3354,
      "tabular": true
    }
  ],
  "guestbook_required": false,
  "keywords": [
    "Elections"
  ],
  "license": {
    "name": "CC0 1.0",
    "spdx": "CC0-1.0",
    "uri": "http://creativecommons.org/publicdomain/zero/1.0"
  },
  "observed_at_ms": 1793105759387,
  "persistent_url": "https://doi.org/10.7910/DVN/PEJ5QU",
  "publication_date": "2017-11-01",
  "publisher": "Harvard Dataverse",
  "related_datasets": [
    "U.S. House 1976–2024",
    "U.S. President 1976–2024"
  ],
  "release_time": "2026-05-11T16:13:52Z",
  "source_url": "https://dataverse.harvard.edu/api/datasets/:persistentId/?persistentId=doi%3A10.7910%2FDVN%2FPEJ5QU",
  "subjects": [
    "Social Sciences"
  ],
  "terms_of_use": null,
  "title": "U.S. Senate statewide 1976–2024",
  "topics": [
    "Election Returns"
  ],
  "url": "https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/PEJ5QU",
  "version": "V8",
  "version_state": "RELEASED"
}
```

## API reference-derived contract

The following capability contract is generated from the same normalized Alexandria API reference exposed in the API spec.

### Get dataset

- Capability: `elections/get_dataset`
- Description: One published dataset from the Harvard Dataverse native API by DOI or dataset page URL: title, description, authors, keywords, topics, related datasets, version and release time, licence (name, URI, SPDX id), terms, whether a guestbook gates downloads, a citation with DOI and version, and every file with id, size, content type, tabular/original format, MD5, whether `query_returns` can read it and its bytes. Unknown DOIs are `not_found`.
- Instructions: Pick the file (`file_id`) to query, check the licence and citation, or see which state files a precinct release has.
- Cost: 5 credits per call
- Capability file: [Get dataset](https://firecrawl.dev/alexandria/agents/providers/dataverse-harvard-edu/elections/get_dataset)

Accepted options:
- `doi` (string): Dataset DOI: doi:10.7910/DVN/PEJ5QU, 10.7910/DVN/PEJ5QU or https://doi.org/10.7910/DVN/PEJ5QU. Example: `<doi>`
- `url` (string): Dataset page URL, e.g. https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/PEJ5QU. Pattern: ^https?://. Example: `<url>`

Response schema example:
```json
{
  "authors": [
    "MIT Election Data and Science Lab"
  ],
  "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
  "description": "This data file contains constituency (state-level) returns for elections to the U.S. Senate from 1976 to 2024.",
  "doi": "doi:10.7910/DVN/PEJ5QU",
  "file_count": 3,
  "files": [
    {
      "content_type": "text/tab-separated-values",
      "description": "Elections returns data for US Senate at the statewide level ",
      "directory": null,
      "download_url": "https://dataverse.harvard.edu/api/access/datafile/13887039?format=original",
      "file_id": 13887039,
      "md5": "0f8b51cf0f77a2ef0bff992f7a64d1b4",
      "name": "1976-2024-senate-state.tab",
      "original_format": "text/comma-separated-values",
      "original_name": "1976-2024-senate-state.csv",
      "original_size_bytes": 530501,
      "query_size_bytes": 530501,
      "queryable": true,
      "restricted": false,
      "size_bytes": 632787,
      "tabular": true
    },
    {
      "content_type": "text/markdown",
      "description": "Codebook for the Senate elections returns data ",
      "directory": null,
      "download_url": "https://dataverse.harvard.edu/api/access/datafile/6708560",
      "file_id": 6708560,
      "md5": "1cab4bc42b0ca632223b9b9a90c65f30",
      "name": "codebook-us-senate-1976–2024.md",
      "original_format": null,
      "original_name": null,
      "original_size_bytes": null,
      "query_size_bytes": null,
      "queryable": false,
      "restricted": false,
      "size_bytes": 3700,
      "tabular": false
    },
    {
      "content_type": "text/tab-separated-values",
      "description": "sources for elections data",
      "directory": null,
      "download_url": "https://dataverse.harvard.edu/api/access/datafile/4304792?format=original",
      "file_id": 4304792,
      "md5": "d92c44441367c4acda59e8779dc62155",
      "name": "sources-senate.tab",
      "original_format": "text/csv",
      "original_name": "sources-senate.csv",
      "original_size_bytes": 3049,
      "query_size_bytes": 3049,
      "queryable": true,
      "restricted": false,
      "size_bytes": 3354,
      "tabular": true
    }
  ],
  "guestbook_required": false,
  "keywords": [
    "Elections"
  ],
  "license": {
    "name": "CC0 1.0",
    "spdx": "CC0-1.0",
    "uri": "http://creativecommons.org/publicdomain/zero/1.0"
  },
  "observed_at_ms": 1793105759387,
  "persistent_url": "https://doi.org/10.7910/DVN/PEJ5QU",
  "publication_date": "2017-11-01",
  "publisher": "Harvard Dataverse",
  "related_datasets": [
    "U.S. House 1976–2024",
    "U.S. President 1976–2024"
  ],
  "release_time": "2026-05-11T16:13:52Z",
  "source_url": "https://dataverse.harvard.edu/api/datasets/:persistentId/?persistentId=doi%3A10.7910%2FDVN%2FPEJ5QU",
  "subjects": [
    "Social Sciences"
  ],
  "terms_of_use": null,
  "title": "U.S. Senate statewide 1976–2024",
  "topics": [
    "Election Returns"
  ],
  "url": "https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/PEJ5QU",
  "version": "V8",
  "version_state": "RELEASED"
}
```

### Query returns

- Capability: `elections/query_returns`
- Description: Rows of one CSV/TSV file of a dataset that match the filters: year, state (name or postal code), office (substring, e.g. SENATE), district (numeric match, `001` = `1`), county (name or FIPS), candidate (substring), party (substring of party_detailed/simplified), stage (gen/pri) and mode. Each row has MEDSL's common columns normalized (candidate, party, votes, total votes, writein, special, mode, county, precinct) plus every column as published, and the dataset DOI and citation. The file is read with HTTP range requests from Dataverse's signed storage URL, at most 24 MiB per call: statewide files (Senate 1976-2024 ~0.5 MB, President 1976-2024 ~0.5 MB) finish in one call; precinct files (2-420 MB) continue with `next_offset`, so prefer the per-state files of the `Precinct-Level Returns <year> by Individual State` datasets. Guestbook-gated, restricted and non-delimited files are `invalid_input`; an unknown file is `not_found`.
- Instructions: Historical baselines for one race: how a state or district voted, candidate and party totals, turnout (total votes), vote mode splits, and precinct or county detail from MEDSL files.
- Cost: 5 credits per call
- Capability file: [Query returns](https://firecrawl.dev/alexandria/agents/providers/dataverse-harvard-edu/elections/query_returns)

Accepted options:
- `candidate` (string): Substring of the candidate name as MEDSL prints it (upper case, e.g. OSSOFF). Example: `<candidate>`
- `county` (string): County name (exact, case-insensitive) or county FIPS code. Example: `<county>`
- `district` (string): District; numbers compare numerically (5 = 005), otherwise exact (statewide). Example: `<district>`
- `doi` (string, required): Dataset DOI: doi:10.7910/DVN/PEJ5QU, 10.7910/DVN/PEJ5QU or https://doi.org/10.7910/DVN/PEJ5QU. Example: `<doi>`
- `file_id` (number): File id from `get_dataset`. Example: `10`
- `file_name` (string): File name (label or original name) from `get_dataset`, e.g. 1976-2024-senate-state.tab. Example: `get_dataset`
- `limit` (number): Maximum rows, default 200. Example: `10`
- `mode` (string): Vote mode, e.g. TOTAL, ELECTION DAY, ABSENTEE. Example: `<mode>`
- `office` (string): Substring of the office column, e.g. SENATE, US HOUSE, GOVERNOR. Example: `<office>`
- `offset` (number): Byte offset to resume at: the previous answer's `next_offset`. Default 0. Example: `10`
- `party` (string): Substring of party_detailed, party_simplified or party, e.g. DEMOCRAT. Example: `<party>`
- `stage` (string): Election stage, e.g. gen or pri. Example: `<stage>`
- `state` (string): State name (GEORGIA) or postal code (GA), case-insensitive exact match. Example: `<state>`
- `year` (number): year Example: `1789`

Response schema example:
```json
{
  "bytes_scanned": 530501,
  "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
  "columns": [
    "year",
    "state",
    "state_po",
    "state_fips",
    "state_cen",
    "state_ic",
    "office",
    "district",
    "stage",
    "special",
    "candidate",
    "party_detailed",
    "writein",
    "mode",
    "candidatevotes",
    "totalvotes",
    "unofficial",
    "version",
    "party_simplified"
  ],
  "count": 23,
  "dataset_title": "U.S. Senate statewide 1976–2024",
  "doi": "doi:10.7910/DVN/PEJ5QU",
  "file": {
    "download_url": "https://dataverse.harvard.edu/api/access/datafile/13887039?format=original",
    "file_id": 13887039,
    "format": "original",
    "name": "1976-2024-senate-state.tab",
    "size_bytes": 530501
  },
  "filters": {
    "candidate": null,
    "county": null,
    "district": null,
    "mode": null,
    "office": null,
    "party": null,
    "stage": null,
    "state": "GA",
    "year": 2020
  },
  "license": {
    "name": "CC0 1.0",
    "spdx": "CC0-1.0",
    "uri": "http://creativecommons.org/publicdomain/zero/1.0"
  },
  "next_offset": null,
  "observed_at_ms": 1793105759844,
  "offset": 0,
  "rows": [
    {
      "candidate": "DAVID A. PERDUE",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "REPUBLICAN",
      "party_simplified": "REPUBLICAN",
      "precinct": null,
      "special": false,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4952175,
      "values": {
        "candidate": "DAVID A. PERDUE",
        "candidatevotes": "2462617.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "REPUBLICAN",
        "party_simplified": "REPUBLICAN",
        "special": "False",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4952175.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 2462617,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "JON OSSOFF",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "DEMOCRAT",
      "party_simplified": "DEMOCRAT",
      "precinct": null,
      "special": false,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4952175,
      "values": {
        "candidate": "JON OSSOFF",
        "candidatevotes": "2374519.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "DEMOCRAT",
        "party_simplified": "DEMOCRAT",
        "special": "False",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4952175.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 2374519,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "SHANE HAZEL",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "LIBERTARIAN",
      "party_simplified": "LIBERTARIAN",
      "precinct": null,
      "special": false,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4952175,
      "values": {
        "candidate": "SHANE HAZEL",
        "candidatevotes": "115039.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "LIBERTARIAN",
        "party_simplified": "LIBERTARIAN",
        "special": "False",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4952175.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 115039,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "A. WAYNE JOHNSON",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "REPUBLICAN",
      "party_simplified": "REPUBLICAN",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "A. WAYNE JOHNSON",
        "candidatevotes": "36176.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "REPUBLICAN",
        "party_simplified": "REPUBLICAN",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 36176,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "AL BARTELL",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "INDEPENDENT",
      "party_simplified": "OTHER",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "AL BARTELL",
        "candidatevotes": "14640.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "INDEPENDENT",
        "party_simplified": "OTHER",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 14640,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "ALLEN BUCKLEY",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "INDEPENDENT",
      "party_simplified": "OTHER",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "ALLEN BUCKLEY",
        "candidatevotes": "17954.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "INDEPENDENT",
        "party_simplified": "OTHER",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 17954,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "ANNETTE DAVIS JACKSON",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "REPUBLICAN",
      "party_simplified": "REPUBLICAN",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "ANNETTE DAVIS JACKSON",
        "candidatevotes": "44335.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "REPUBLICAN",
        "party_simplified": "REPUBLICAN",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 44335,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "BRIAN SLOWINSKI",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "LIBERTARIAN",
      "party_simplified": "LIBERTARIAN",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "BRIAN SLOWINSKI",
        "candidatevotes": "35431.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "LIBERTARIAN",
        "party_simplified": "LIBERTARIAN",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 35431,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "DEBORAH JACKSON",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "DEMOCRAT",
      "party_simplified": "DEMOCRAT",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "DEBORAH JACKSON",
        "candidatevotes": "324118.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "DEMOCRAT",
        "party_simplified": "DEMOCRAT",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 324118,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "DERRICK E. GRAYSON",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "REPUBLICAN",
      "party_simplified": "REPUBLICAN",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "DERRICK E. GRAYSON",
        "candidatevotes": "51592.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "REPUBLICAN",
        "party_simplified": "REPUBLICAN",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 51592,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "DOUG COLLINS",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "REPUBLICAN",
      "party_simplified": "REPUBLICAN",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "DOUG COLLINS",
        "candidatevotes": "980454.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "REPUBLICAN",
        "party_simplified": "REPUBLICAN",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 980454,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "ED TARVER",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "DEMOCRAT",
      "party_simplified": "DEMOCRAT",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "ED TARVER",
        "candidatevotes": "26333.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "DEMOCRAT",
        "party_simplified": "DEMOCRAT",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 26333,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "JAMESIA JAMES",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "DEMOCRAT",
      "party_simplified": "DEMOCRAT",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "JAMESIA JAMES",
        "candidatevotes": "94406.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "DEMOCRAT",
        "party_simplified": "DEMOCRAT",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 94406,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "JOHN FORTUIN",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "GREEN",
      "party_simplified": "OTHER",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "JOHN FORTUIN",
        "candidatevotes": "15293.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "GREEN",
        "party_simplified": "OTHER",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 15293,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "JOY FELICIA SLADE",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "DEMOCRAT",
      "party_simplified": "DEMOCRAT",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "JOY FELICIA SLADE",
        "candidatevotes": "44945.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "DEMOCRAT",
        "party_simplified": "DEMOCRAT",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 44945,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "KANDISS TAYLOR",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "REPUBLICAN",
      "party_simplified": "REPUBLICAN",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "KANDISS TAYLOR",
        "candidatevotes": "40349.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "REPUBLICAN",
        "party_simplified": "REPUBLICAN",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 40349,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "KELLY LOEFFLER",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "REPUBLICAN",
      "party_simplified": "REPUBLICAN",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "KELLY LOEFFLER",
        "candidatevotes": "1273214.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "REPUBLICAN",
        "party_simplified": "REPUBLICAN",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 1273214,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "MATT LIEBERMAN",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "DEMOCRAT",
      "party_simplified": "DEMOCRAT",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "MATT LIEBERMAN",
        "candidatevotes": "136021.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "DEMOCRAT",
        "party_simplified": "DEMOCRAT",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 136021,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "MICHAEL TODD GREENE",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "INDEPENDENT",
      "party_simplified": "OTHER",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "MICHAEL TODD GREENE",
        "candidatevotes": "13293.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "INDEPENDENT",
        "party_simplified": "OTHER",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 13293,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "RAPHAEL WARNOCK",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "DEMOCRAT",
      "party_simplified": "DEMOCRAT",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "RAPHAEL WARNOCK",
        "candidatevotes": "1617035.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "DEMOCRAT",
        "party_simplified": "DEMOCRAT",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 1617035,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "RICHARD DIEN WINFIELD",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "DEMOCRAT",
      "party_simplified": "DEMOCRAT",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "RICHARD DIEN WINFIELD",
        "candidatevotes": "28687.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "DEMOCRAT",
        "party_simplified": "DEMOCRAT",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 28687,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "TAMARA JOHNSON-SHEALEY",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "DEMOCRAT",
      "party_simplified": "DEMOCRAT",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "TAMARA JOHNSON-SHEALEY",
        "candidatevotes": "106767.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "DEMOCRAT",
        "party_simplified": "DEMOCRAT",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 106767,
      "writein": false,
      "year": 2020
    },
    {
      "candidate": "VALENCIA STOVALL",
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8",
      "county": null,
      "county_fips": null,
      "district": "statewide",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "jurisdiction": null,
      "mode": "total",
      "office": "US SENATE",
      "party": "INDEPENDENT",
      "party_simplified": "OTHER",
      "precinct": null,
      "special": true,
      "stage": "gen",
      "state": "GEORGIA",
      "state_po": "GA",
      "total_votes": 4914361,
      "values": {
        "candidate": "VALENCIA STOVALL",
        "candidatevotes": "13318.0",
        "district": "statewide",
        "mode": "total",
        "office": "US SENATE",
        "party_detailed": "INDEPENDENT",
        "party_simplified": "OTHER",
        "special": "True",
        "stage": "gen",
        "state": "GEORGIA",
        "state_cen": "58.0",
        "state_fips": "13",
        "state_ic": "44",
        "state_po": "GA",
        "totalvotes": "4914361.0",
        "unofficial": "False",
        "version": "20210114",
        "writein": "False",
        "year": "2020"
      },
      "votes": 13318,
      "writein": false,
      "year": 2020
    }
  ],
  "scan_complete": true,
  "skipped_rows": 0,
  "source_url": "https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/PEJ5QU"
}
```

### Search datasets

- Capability: `elections/search_datasets`
- Description: Search published datasets in a Harvard Dataverse collection and its sub-dataverses through the public search API. Defaults to the MEDSL dataverse (`medsl`: U.S. House, Senate and President returns, county presidential returns, precinct-level returns 2016-2024 by office and by state, election night returns, Elections Performance Index). Returns DOI, title, description, dataverse, citation, authors, keywords, file count and version, 1-100 per page. An unknown dataverse alias is `not_found`.
- Instructions: Find the MEDSL dataset for a question (e.g. `senate`, `precinct 2024`, `county presidential`) before `get_dataset` and `query_returns`.
- Cost: 5 credits per call
- Capability file: [Search datasets](https://firecrawl.dev/alexandria/agents/providers/dataverse-harvard-edu/elections/search_datasets)

Accepted options:
- `dataverse` (string): Dataverse alias to search under, sub-dataverses included. Default `medsl`; e.g. `2024_precincts`, `medsl_house`. Pattern: ^[A-Za-z0-9_-]+$. Example: `<dataverse>`
- `order` (string): order Example: `asc`
- `page` (number): 1-based page. Example: `10`
- `per_page` (number): Results per page, default 20. Example: `10`
- `query` (string): Search terms (Solr syntax); omitted or `*` lists every dataset. Example: `*`
- `sort` (string): Sort by name or date instead of relevance. Example: `name`

Response schema example:
```json
{
  "count": 10,
  "datasets": [
    {
      "authors": [
        "MIT Election Data and Science Lab"
      ],
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. Senate statewide 1976–2024\", https://doi.org/10.7910/DVN/PEJ5QU, Harvard Dataverse, V8, UNF:6:jRgjMTzXKaB+psjQ9tTqMQ== [fileUNF]",
      "dataverse_alias": "medsl_senate",
      "dataverse_name": "U.S. Senate Elections",
      "description": "This data file contains constituency (state-level) returns for elections to the U.S. Senate from 1976 to 2024.",
      "doi": "doi:10.7910/DVN/PEJ5QU",
      "file_count": 3,
      "keywords": [
        "Elections"
      ],
      "published_at": "2026-05-11T16:13:52Z",
      "title": "U.S. Senate statewide 1976–2024",
      "updated_at": "2026-05-11T16:13:52Z",
      "url": "https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/PEJ5QU",
      "version": "V8"
    },
    {
      "authors": [
        "MIT Election Data and Science Lab"
      ],
      "citation": "MIT Election Data and Science Lab, 2018, \"U.S. Senate Precinct-Level Returns 2016\", https://doi.org/10.7910/DVN/NLTQAD, Harvard Dataverse, V11, UNF:6:A+p0f16nhvXGTW10ThPX2w== [fileUNF]",
      "dataverse_alias": "medsl_senate",
      "dataverse_name": "U.S. Senate Elections",
      "description": "This dataset contains precinct-level returns for elections to the U.S. Senate on November 8, 2016.",
      "doi": "doi:10.7910/DVN/NLTQAD",
      "file_count": 5,
      "keywords": [
        "Elections"
      ],
      "published_at": "2019-01-17T20:38:53Z",
      "title": "U.S. Senate Precinct-Level Returns 2016",
      "updated_at": "2022-01-27T02:39:13Z",
      "url": "https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/NLTQAD",
      "version": "V11.1"
    },
    {
      "authors": [
        "MIT Election Data and Science Lab"
      ],
      "citation": "MIT Election Data and Science Lab, 2023, \"U.S. Senate county-level results 2022\", https://doi.org/10.7910/DVN/YB60EJ, Harvard Dataverse, V3, UNF:6:bTKVoxZCrClg9pqtRfqg0w== [fileUNF]",
      "dataverse_alias": "medsl_senate",
      "dataverse_name": "U.S. Senate Elections",
      "description": "U.S. Senate election results at the county level, 2022. Dataset created by Fernanda Gonzalez, Samuel Baltz, and Charles Stewart III for the MIT Election Data and Science Lab.",
      "doi": "doi:10.7910/DVN/YB60EJ",
      "file_count": 2,
      "keywords": [],
      "published_at": "2023-09-20T13:42:40Z",
      "title": "U.S. Senate county-level results 2022",
      "updated_at": "2023-09-20T13:42:40Z",
      "url": "https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/YB60EJ",
      "version": "V3"
    },
    {
      "authors": [
        "MIT Election Data + Science Lab"
      ],
      "citation": "MIT Election Data + Science Lab, 2025, \"U.S. Senate Precinct-Level Returns 2022\", https://doi.org/10.7910/DVN/IAD3XR, Harvard Dataverse, V3, UNF:6:apXO2mbiOZCxVZaDhEqfRw== [fileUNF]",
      "dataverse_alias": "2022_precincts",
      "dataverse_name": "2022 precinct data",
      "description": "This dataset contains precinct-level returns for US Senate elections on November 8, 2022.",
      "doi": "doi:10.7910/DVN/IAD3XR",
      "file_count": 3,
      "keywords": [],
      "published_at": "2026-06-10T15:48:40Z",
      "title": "U.S. Senate Precinct-Level Returns 2022",
      "updated_at": "2026-06-10T15:48:40Z",
      "url": "https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/IAD3XR",
      "version": "V3"
    },
    {
      "authors": [
        "MIT Election Data and Science Lab"
      ],
      "citation": "MIT Election Data and Science Lab, 2026, \"U.S. Senate Precinct-Level Returns 2024\", https://doi.org/10.7910/DVN/ZCM3BN, Harvard Dataverse, V1",
      "dataverse_alias": "2024_precincts",
      "dataverse_name": "2024 precinct data",
      "description": "This dataset contains precinct-level returns for US Senate elections on November 5, 2024.",
      "doi": "doi:10.7910/DVN/ZCM3BN",
      "file_count": 3,
      "keywords": [],
      "published_at": "2026-05-01T14:12:55Z",
      "title": "U.S. Senate Precinct-Level Returns 2024",
      "updated_at": "2026-05-01T14:12:55Z",
      "url": "https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/ZCM3BN",
      "version": "V1"
    },
    {
      "authors": [
        "MIT Election Data and Science Lab"
      ],
      "citation": "MIT Election Data and Science Lab, 2022, \"U.S. Senate Precinct-Level Returns 2018\", https://doi.org/10.7910/DVN/DGNAFS, Harvard Dataverse, V1, UNF:6:dr9zFvbjKX1uuiHEwwj1JQ== [fileUNF]",
      "dataverse_alias": "2018_precincts",
      "dataverse_name": "2018 precinct data",
      "description": "This dataset contains precinct-level returns for US Senate elections on November 6, 2018.",
      "doi": "doi:10.7910/DVN/DGNAFS",
      "file_count": 3,
      "keywords": [],
      "published_at": "2022-11-03T16:17:44Z",
      "title": "U.S. Senate Precinct-Level Returns 2018",
      "updated_at": "2022-11-03T16:53:01Z",
      "url": "https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/DGNAFS",
      "version": "V1.1"
    },
    {
      "authors": [
        "MIT Election Data and Science Lab"
      ],
      "citation": "MIT Election Data and Science Lab, 2022, \"U.S. Senate Precinct-Level Returns 2020\", https://doi.org/10.7910/DVN/ER9XTV, Harvard Dataverse, V1",
      "dataverse_alias": "2020_precincts",
      "dataverse_name": "2020 precinct data",
      "description": "This dataset contains precinct-level returns for US Senate elections on November 3, 2020.",
      "doi": "doi:10.7910/DVN/ER9XTV",
      "file_count": 3,
      "keywords": [
        "Elections"
      ],
      "published_at": "2022-03-17T13:47:57Z",
      "title": "U.S. Senate Precinct-Level Returns 2020",
      "updated_at": "2022-11-03T16:57:09Z",
      "url": "https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/ER9XTV",
      "version": "V1.2"
    },
    {
      "authors": [
        "MIT Election Data and Science Lab"
      ],
      "citation": "MIT Election Data and Science Lab, 2022, \"Senate constituency elections 1976 - 2020\", https://doi.org/10.7910/DVN/3CNSWO, Harvard Dataverse, V1, UNF:6:cIUB3CEIKhMi9tiY4BffLg== [fileUNF]",
      "dataverse_alias": "time_series",
      "dataverse_name": "Time Series Cross Sectional Elections Returns",
      "description": "This data set comprises of election returns gathered for the office of xxx at the constituency level for the years 1976 - 2020. Please see the associated readme file and meta-csv file for source information and important notes on accuracy and the nature of the fields.",
      "doi": "doi:10.7910/DVN/3CNSWO",
      "file_count": 2,
      "keywords": [
        "Elections"
      ],
      "published_at": "2022-01-24T04:26:21Z",
      "title": "Senate constituency elections 1976 - 2020",
      "updated_at": "2022-01-24T04:26:21Z",
      "url": "https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/3CNSWO",
      "version": "V1"
    },
    {
      "authors": [
        "MIT Election Data and Science Lab"
      ],
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. House 1976–2024\", https://doi.org/10.7910/DVN/IG0UN2, Harvard Dataverse, V15, UNF:6:cIJWG41N8qe3Kyf7oKuPdw== [fileUNF]",
      "dataverse_alias": "medsl_house",
      "dataverse_name": "U.S. House Elections",
      "description": "This data file contains constituency (district) returns for elections to the U.S. House of Representatives from 1976 to 2024.",
      "doi": "doi:10.7910/DVN/IG0UN2",
      "file_count": 2,
      "keywords": [
        "Elections"
      ],
      "published_at": "2026-03-09T17:49:25Z",
      "title": "U.S. House 1976–2024",
      "updated_at": "2026-03-09T17:49:25Z",
      "url": "https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/IG0UN2",
      "version": "V15"
    },
    {
      "authors": [
        "MIT Election Data and Science Lab"
      ],
      "citation": "MIT Election Data and Science Lab, 2017, \"U.S. President 1976–2024\", https://doi.org/10.7910/DVN/42MVDX, Harvard Dataverse, V10, UNF:6:xpBppxfswpr+u9xZe7/u7w== [fileUNF]",
      "dataverse_alias": "medsl_president",
      "dataverse_name": "U.S. Presidential Elections ",
      "description": "This data file contains constituency (state-level) returns for elections to the U.S. presidency from 1976 to 2024.",
      "doi": "doi:10.7910/DVN/42MVDX",
      "file_count": 3,
      "keywords": [
        "Elections"
      ],
      "published_at": "2026-05-11T16:13:47Z",
      "title": "U.S. President 1976–2024",
      "updated_at": "2026-09-04T16:15:49Z",
      "url": "https://dataverse.harvard.edu/dataset.xhtml?persistentId=doi:10.7910/DVN/42MVDX",
      "version": "V10.1"
    }
  ],
  "dataverse": "medsl",
  "next_page": null,
  "observed_at_ms": 1793105759186,
  "page": 1,
  "per_page": 20,
  "query": "senate",
  "source_url": "https://dataverse.harvard.edu/api/search?q=senate&type=dataset&subtree=medsl&start=0&per_page=20",
  "total_count": 10
}
```
