Nationwide endorsement data, as an API

What every endorsement record includes

Election and contest

The election, the office or measure, its district, and its voting rules: vote for one, vote for several, ranked choice, or Yes or No.

Ballot choice

The candidate or answer as it appears on the printed ballot, with party labels where the state prints them.

Endorser

Who endorsed, with a category (party, labor, newspaper, advocacy group, official and more) you can filter on.

Source

The link the endorsement came from, the date it was published and, where there is one, the endorser’s own statement.

The same fields in every state, so one query can span the country. Officeholders and district boundaries are in the API too.

A first request

curl -H "Authorization: Bearer $BALLOTDATA_KEY" \
  "https://api.ballotdata.ai/v1/endorsements?states=CA&categories=labor"

Or from Python, with the ballotdata package:

from ballotdata import BallotData

client = BallotData()  # reads BALLOTDATA_API_KEY
for e in client.endorsements.list(states="CA,TX", categories="newspaper", limit=500):
    print(e["endorser"]["name"], e["contest"]["title"], e["choice"]["label"])

Choose your API password at checkout. Once you’ve paid, your API account opens on its own: confirm your email address, sign in and create keys, which read the states you bought. The reference at api.ballotdata.ai lists every endpoint, its parameters and its responses, and the libraries page covers Python and JavaScript.