api.vzlapi.com

Objetivos

Tener la data mas completa y confiable sobre las elecciones presidenciales 2024 en Venezuela.
Hacer la data publica a traves de un API, para que quien quiera la pueda accesar.

A futuro, me gustaria expandir el "scope" y recolectar y difundir mas data relacionada Venezuela, no tan solo enfocada en las elecciones presidenciales.

Preguntas/problemas, o quieres ayudar? Agrega un issue.

1. Data

Contenido

Data elecciones 2024 https://docs.google.com/spreadsheets/d/1l6ThiQQZXog_8fBw3z5RwqThG7QAy0AqF4wPYpvGUWA/edit?gid=1712398662#gid=1712398662

Data elecciones presidenciales, desde 1998-2024, excluyendo la del 2018 https://docs.google.com/spreadsheets/d/1LdwSkmJwWlb-wSapDmYORcd5-VE0yoeqhq_9lXKd5M0/edit?gid=1705617688#gid=1705617688

Tambien contamos con un archivo de ~12GB con todas las imagenes de ~24mil actas. (Tengo que ponerlo en un lugar publico, pero es el mismo que otras personas han publicado).

Contiene la siguiente data

Centros CNE: Los 15.962 centros electorales en el registro para el 2024, uncluido el numero de electores por centro. Data proveniente del CNE.
Centros convzla: Todos (o casi todos) los centros electorales para los cuales existen actas digitalizadas en https://resultadosconvzla.com. Incluye un mapeo entre los IDs de resultadosconvzla y los IDs del CNE para cada centro. Data proviene de scraping.
Actas (data): La data extraida del codigo QR de casi todas (~22mil de ~24mil) de las actas digitalizadas. Data proviene del procesamiento de imagenes.

Algunas cosas por destacar

La data de las actas (los votos) NO es tomada de resultadosconvzla.com. TODA es extraida por nosotros de las imagenes de las actas utilizando lector de codigo QR. Asi no tenemos que confiar en un tercero para la validez de la data.
Por ende, la data es mas completa que la data de resultadosconvzla.com. Aqui tambien tenemos los votos por cada uno de los 10 candidatos, y los votos nulos (no todos 0) e invalidos (todos 0).

Herramientas

Hemos procesado actas de distintas fuentas (ademas de la nuestra propia), e intentado varias herramientas para extraer la data, cada con distinta eficacia.

Las imagenes de las actas provienen de varios archivos que distintas personas han publicado. TODO: poner un listado
La mayoria de las actas fueron procesadas utilizando: https://github.com/xaiki/resultadosvzla-tools. Es la que tuvo el mayor porcentaje de exito.

2. API -- https://api.vzlapi.com/

La idea es que toda la data mencionada arriba sea facilmente accesible a traves del API. Por ahora solo hay un endpoint, /actas, que acepta una cedula y regresa informacion del votante, su centro electoral, y la informacion que tenemos de ese centro electoral.

Ejemplo:

// https://api.vzlapi.com/actas?cedula=4000000

{
  "Cedula": "V4000000",

  // El centro de votacion asignado al elector
  "StateID": "18",
  "StateName": "EDO. TACHIRA",
  "CountyID": "247",
  "CountyName": "MP. SAN CRISTOBAL",
  "ParishID": "815",
  "ParishName": "PQ. LA CONCORDIA",
  "CenterOldID": "7433",
  "CenterID": "180801028",
  "CenterName": "ESCUELA BOLIVARIANA RITA ELISA MEDINA DE USECHE",
  "CenterAddress": "BARRIO LA VICTORIA DERECHA CALLE DETRAS DEL HOGAR DON BOSCO. IZQUIERDA CALLE 1 CENTRO MEDICO ROTARY. FRENTE CALLE PRINCIPAL ENTRADA AL ALBERGUE JUVENIL CIUDAD DE LOS MUCHACHOS CASA",

  // Incluida el numero de mesa (no siempre disponible)
  "TableID": "7362",
  "TableNumber": "1",

  // Elace al acta digitalizada (si es que existe)
  "ActaFilename": "788144_568516_0998Acta0563.jpg",
  "ActaBucketURL": "https://elecciones2024ve.s3.amazonaws.com/788144_568516_0998Acta0563.jpg",
  "ActaStaticURL": "https://static.resultadosconvzla.com/788144_568516_0998Acta0563.jpg",

  // Data extraida del acta (si existe), con todos los votos por candidato
  "ActaValidVotes": 311,
  "ActaNullVotes": 0,
  "ActaInvalidVotes": 0,
  "ActaCandidateVotes": {
    "Antonio Ecarri": 1,
    "Benjamin Rausseo": 1,
    "Claudio Fermin": 2,
    "Daniel Ceballos": 0,
    "Edmundo Gonzalez": 238,
    "Enrique Marquez": 0,
    "Javier Bertucci": 2,
    "Jose Brito": 0,
    "Luis Martinez": 1,
    "Nicolas Maduro": 66
  },

  // Enlaces a las paginas correspondientes en resultadosconvzla.com
  "ResultsStateURL": "https://resultadosconvzla.com/estado/18",
  "ResultsCountyURL": "https://resultadosconvzla.com/municipio/247",
  "ResultsParishURL": "https://resultadosconvzla.com/parroquia/815",
  "ResultsCenterURL": "https://resultadosconvzla.com/centro/7433",
  "ResultsTableURL": "https://resultadosconvzla.com/mesa/7433/7362"
}

Estamos utilizando el API de gdp.theempire.tech para ir de cedula -> centro (ejemplo), pero nos gustaria tener nuestras propia fuente de informacion, para no depender de un tercero y para que el API sea mas rapido.

Igualmente creo que es mas util acceder a la informacion por centro/estado/municipio, etc., que empezando por una cedula.

Corer localmente

Lo mas facil es utilizar devbox, pero tambien puedes instalar todas las dependencias directamente.

Usando devbox

# Instalar devbox si no lo tienes: https://www.jetify.com/devbox/docs/installing_devbox/

devbox run start

devbox shell
cd api
go run ./main.go

Como lanzar/deploy a produccion

Cuando se hace merge a main, el API hace deploy automaticamente, hosteado por https://cloud.jetify.com

ipince / vzlapi

readme