Lo que devuelve
Resultados electorales en vivo directamente desde las fuentes oficiales de las noches electorales estatales: AZ, CA, CO, CT, FL, IA, ID, IN, LA, MD, MN, NC, NE, NM, NV, NY, OH, PA, RI, SD, UT, VA, VT y WA, más resultados por condado de Michigan de los condados que publican sus propias fuentes (level=county), con más estados a medida que sus fuentes se abran. Votos, porcentaje, partido y distritos reportados para el Senado de EE. UU., Cámara de Representantes, Gobernador o cualquier elección que coincida, a nivel estatal o por condado, con marca de tiempo en cada llamada.
Solicitud
POST https://api.pushbuild.com/election-night-results/run con un cuerpo JSON. Envíe su clave en el encabezado X-API-Key.
| Campo | Tipo | Descripción |
|---|---|---|
states | string | Códigos de dos letras separados por comas. Vacío = todos los estados con una fuente compatible. |
countries | string | Fuera de EE. UU.: códigos de país ISO separados por comas. GB = cada elección en el Reino Unido ese día (elecciones supletorias de consejos, alcaldes, descentralizadas, Westminster) desde los oficiales de devolución a través de Democracy Club; CH = votos federales suizos por cantón y comuna desde la Oficina Federal de Estadísticas. Use con electionDate (el día de votación). Se agregan más países a medida que se encuentran sus fuentes oficiales. |
electionDate | string | YYYY-MM-DD. Por defecto 2026-11-03. Las fechas pasadas devuelven los resultados finales de esa elección donde la fuente aún los tenga. Por defecto: "2026-11-03". |
electionId | string | Opcional, un solo estado: elija una elección específica de Clarity en lugar de coincidir por fecha. |
contestMatch | string | Expresión regular sin distinción de mayúsculas y minúsculas en el nombre del concurso. Por defecto: cada concurso (Senado, Gobernador, distritos de Cámara, legislatura, medidas). Ejemplo: senat|governor|house. Los nombres de cargos se coinciden a través de los estados: Treasurer también encuentra Chief Financial Officer (FL), Auditor también encuentra Comptroller/Controller. Si nada coincide, el mensaje de respuesta enumera los concursos estatales que la fuente sí tiene. |
maxItems | entero | Número máximo de elementos a devolver (1-500). Predeterminado: 100. |
level | cadena: state, county, precinct | state = totales a nivel estatal; county = por condado (estados con Votación Mejorada); precinct = por distrito electoral, un estado a la vez (estados con Votación Mejorada). Por defecto: "state". |
counties | string | Nombres de condados separados por comas opcionales para mantener en el nivel de condado/distrito electoral, p. ej. Fairfax,Loudoun. |
updatedSince | string | marca de tiempo ISO; elimina filas cuya fuente no se haya actualizado desde entonces (cuando la fuente reporta una hora de actualización). |
offset | entero | Filas a omitir, para paginación. Por defecto: 0. |
Ejemplo
curl -X POST https://api.pushbuild.com/election-night-results/run \
-H "X-API-Key: YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"states": "NC,IA,CO", "maxItems": 20}'Respuesta
{"count": 20, "truncated": false, "seconds": 1.4, "items": [ { ... } ]}Cada llamada devuelve hasta 500 elementos. Los registros que no pasan la validación o no se encuentran se marcan en los elementos y no se cobran.
Precios
Pague solo por los resultados devueltos: $0,08 por 1.000 filas. Sin cargo por errores o búsquedas vacías.
Úselo desde Claude, ChatGPT o Cursor
Esta API también es un servidor MCP: https://api.pushbuild.com/mcp/election-night-results. Agréguela a cualquier asistente que soporte servidores MCP remotos, con su clave en el encabezado X-API-Key. Mismos precios. Configuración para cada aplicación.
Díganos qué necesitan construir.
Preguntas sobre esta API, volúmenes más altos, o una fuente de datos que necesiten que aún no cubrimos.
hello@pushbuild.com