Developer API

Public, cited civic data — free to build on

Salt Tab turns inconsistent official sources into a clean, canonical dataset: ingested, human-reviewed, and sourced. That data is available as a read-only JSON API. Only published, approved records are served, and every candidate item carries its source.

Endpoints

Base: /api/v1

Method	Path	Example params	Returns
GET	`/api/v1`	—	Self-describing index of the API.
GET	`/api/v1/races`	`?state=AL&election=2026-11-03`	Races that have a published comparison.
GET	`/api/v1/candidates`	`?state=AL&office=Governor`	Candidates in published races.
GET	`/api/v1/candidates/{id}`	—	One candidate: positions, quotes, endorsements, channels — each cited.
GET	`/api/v1/search`	`?q=nashville`	Search people, races, bodies, places, and pages.

Response shape

Every response wraps data with a meta block carrying the license and attribution, so the citation travels with the data. CORS is open; responses are edge-cached.

{
  "data": [
    {
      "id": "…",
      "name": "…",
      "party": "…",
      "officeTitle": "Governor",
      "state": "AL",
      "electionDate": "2026-11-03",
      "url": "/candidates/…"
    }
  ],
  "meta": {
    "count": 1,
    "license": "CC-BY-4.0",
    "attribution": "Salt Tab — https://www.salt-tab.com",
    "generatedAt": "…"
  }
}

License & terms

CC BY 4.0. Free to use, share, and build on — including commercially — with attribution to Salt Tab (https://www.salt-tab.com). Data is sourced and human-reviewed; corrections are versioned and public. It is provided as-is, without warranty. See the license ↗.

Guarantees

Approved-only: drafts and unverified AI output are never served.
Sourced: candidate positions, quotes, and endorsements include their source.
Honest about change: corrections are public and versioned.
No ratings: Salt Tab records what sources say; it never scores, ranks, or predicts.