What it returns
Every published poll for the 2026 US Senate and Governor races plus presidential approval, with pollster, dates, sample, LV/RV and results, a link to each poll release, rolling averages per matchup, and the major aggregators' averages incl. the House generic ballot.
Request
POST https://api.pushbuild.com/political-polls/run with a JSON body. Send your key in the X-API-Key header.
| Field | Type | Description |
|---|---|---|
states | string | Comma-separated state codes, e.g. GA,ME,MI. Empty = all 50. |
offices | string | Any of senate, governor, generic-ballot, approval (comma-separated). generic-ballot has aggregator averages only. Default: "senate,governor,generic-ballot,approval". |
output | string: polls, averages, aggregators | polls = one row per poll; averages = our rolling average per race and matchup; aggregators = averages published by RealClearPolitics, Decision Desk HQ, Silver Bulletin and others as listed on Wikipedia. Default: "polls". |
stage | string: general, primary, runoff, all | Which part of the race the polls are for. Default: "general". |
dateFrom | string | YYYY-MM-DD. Empty = all. |
averageDays | integer | For output=averages: each pollster's latest poll ending within this many days of the newest poll. Default: 30. |
maxItems | integer | Maximum items to return (1-500). Default: 100. |
offset | integer | Skip this many rows first; use with maxItems to page through large results (the HTTP API returns at most 500 rows per call). Default: 0. |
Example
curl -X POST https://api.pushbuild.com/political-polls/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"states": "GA,ME,MI,NC", "maxItems": 20}'Response
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Each call returns up to 500 items. Records that fail validation or are not found are flagged in the items and not charged.
Pricing
Pay only for results returned: $0.08 per 1,000 rows. No charge for errors or empty searches.
Related APIs
Asteroid Close Approach API
NASA JPL data on near-Earth asteroids and comets: upcoming and past close approaches to Earth (distance in km and lunar distances, velocity, size estimate), the Sentry impact-risk list with probability and Palermo/Torino scales, and orbit and physical data for any object..
Bulk SEO Audit & PageSpeed / Core Web Vitals Checker API
Audit any list of URLs: Lighthouse performance, SEO, accessibility and best-practice scores, real-user Core Web Vitals (LCP, INP, CLS), speed opportunities, and on-page SEO checks (title, meta description, H1, canonical, alt text, sitemap, robots, schema)..
Canada Weather Alerts API
Public weather alerts for Canada from Environment and Climate Change Canada: warnings, watches, advisories and statements with alert name, type, risk colour, area, province, issue, validity, end and expiry times, confidence, impact and full text, in English or French..
CDC Notifiable Diseases API
CDC National Notifiable Diseases Surveillance System weekly tables: cases this week, 52-week maximum and year-to-date counts this and last year for measles, pertussis, Lyme disease, hepatitis, salmonellosis, tuberculosis and 100+ conditions by state, region and US total..
CDC PLACES API
CDC PLACES model-based local health estimates for every US county, city, ZIP code area and census tract: obesity, diabetes, high blood pressure, smoking, depression, insurance, checkups, disability, food insecurity and 40+ measures with confidence intervals and population..
Election Night Results API
Live election results straight from official state election-night feeds (Clarity ENR states and North Carolina): candidate votes, percent, party and precincts reporting for US Senate and Governor races or any contest you match, timestamped on every call..
Tell us what you need built.
Questions about this API, higher volumes, or a data source you need that we don't cover yet.
hello@pushbuild.com