Endorser
An organization or person that endorses: a union, a newspaper, a party, an advocacy group or an elected official.
- Returned by
GET /v1/endorsers,GET /v1/endorsers/{slug}- Found in
- Position (
endorser) - Shapes
- The full record is in GET /v1/endorsers/{slug}. The shorter forms in GET /v1/endorsers and positions and a candidate’s endorsements leave some fields out; a field that isn’t in every form says where it is.
How it connects
- An endorser has many endorsements across elections; filter any endorsement list with
endorsers={slug}. categoryis one ofGET /v1/endorser-categories.
Good to know
- We collect every endorser, however few endorsements they make.
endorsement_countcounts contests, so a ranked-choice ranking or a slate counts once. stateisnullfor national endorsers; filter them withendorser_states=national.
Fields
| Field | Type | Meaning | Example |
|---|---|---|---|
id | integer | Endorser id. | 1 |
slug | string | Endorser slug. | sf-chronicle |
name | string | Endorser name. | San Francisco Chronicle |
category | Endorser category | The kind of endorser. | — |
description | stringor null | About the endorser.Not in positions and a candidate’s endorsements. | Daily newspaper editorial board |
website_url | stringor nullURL | Endorser’s website.Not in positions and a candidate’s endorsements. | https://www.sfchronicle.com/opinion/ |
logo_url | stringor nullURL | The endorser’s logo image.Not in positions and a candidate’s endorsements. | — |
state | stringor nullTwo capital letters (USPS code) | Home state; null for national endorsers. | CA |
party | Partyor null | The party, for a party or party club.Not in positions and a candidate’s endorsements. | — |
endorsement_count | integer | Contests this endorser takes a position in, across every election you can read. A ranked-choice order or a vote-for-N slate counts once.Not in positions and a candidate’s endorsements. | 18 |
elections | array of object | Elections the endorser has endorsed in, newest first.Only in GET /v1/endorsers/{slug}. | — |
elections[].election | string | Election slug.Only in GET /v1/endorsers/{slug}. | — |
elections[].name | string | Election name.Only in GET /v1/endorsers/{slug}. | — |
elections[].date | stringYYYY-MM-DD | Election day.Only in GET /v1/endorsers/{slug}. | — |
elections[].contests | integer | Contests this endorser took a position in.Only in GET /v1/endorsers/{slug}. | — |