API pública — PuenteHogar · Datos abiertos de ayuda

¿Qué es esto?

PuenteHogar libera sus datos gratis y de forma abierta para que gobiernos, ONGs, medios y otras plataformas puedan centralizar la información de ayuda en un solo lugar. No hace falta registrarse ni pedir permiso.

🔒 Sin datos personales. La API nunca expone teléfonos, cédulas, nombres ni direcciones. Solo dice qué se necesita y dónde (por zona). El contacto entre familias y ayudantes ocurre siempre dentro de la app, con permiso.

Endpoint principal

GET https://puentehogar.org/api/publico

Devuelve JSON. Lectura libre (CORS abierto). Se actualiza cada ~10 minutos.

Ejemplo de uso

curl https://puentehogar.org/api/publico

// JavaScript
const r = await fetch('https://puentehogar.org/api/publico');
const datos = await r.json();
console.log(datos.resumen);

Ejemplo de respuesta

{
  "fuente": "PuenteHogar",
  "url": "https://puentehogar.org",
  "generado": "2026-07-01T15:00:00.000Z",
  "resumen": {
    "familias_total": 128,
    "familias_verificadas": 74,
    "familias_por_estado": { "La Guaira": 61, "Aragua": 22, "Miranda (Caracas y zonas)": 18 },
    "familias_por_necesidad": { "alquiler": 40, "acogida": 55, "refugio": 33 },
    "ofertas_total": 47,
    "ofertas_por_tipo": { "recibo": 20, "alquilo": 14, "hotel": 6, "apadrina": 7 },
    "mascotas_total": 9
  },
  "familias": [
    { "codigo": "PNT-XXXX", "estadoVe": "La Guaira", "zona": "La Guaira — Caraballeda",
      "necesidad": "acogida", "personas": 4, "ninos": 2, "mayores": 0,
      "discapacidad": false, "conMascotas": true, "estadoVivienda": "colapsada",
      "verificada": true }
  ],
  "ofertas": [
    { "tipo": "recibo", "pais": "Venezuela", "estadoVe": "Miranda (Caracas y zonas)",
      "zona": "Miranda — Baruta", "capacidad": 5, "duracion": "3 meses", "detalles": "..." }
  ],
  "mascotas": [
    { "tipo": "perro", "necesidad": "refugio_temporal", "estadoVe": "La Guaira",
      "zona": "Caraballeda", "nombreMascota": "Firulais", "descripcion": "..." }
  ]
}

Campos

resumen (conteos, ideal para tableros/mapas)

Campo	Qué es
`familias_total`	Familias que aún necesitan ayuda
`familias_verificadas`	Cuántas tienen sello verde (evidencia confirmada)
`_por_estado / _por_necesidad / *_por_tipo`	Desgloses para graficar

familias / ofertas / mascotas (listas, sin datos personales)

Campo	Qué es
`estadoVe`, `zona`	Ubicación (estado y sector, sin dirección exacta)
`necesidad` / `tipo`	Qué necesita la familia / qué ofrece el ayudante
`personas, ninos, mayores, discapacidad`	Composición del grupo familiar
`verificada`	Si la ficha tiene evidencia confirmada
`codigo`	Identificador público de la ficha (no personal)

Bonus: lista de edificios afectados

GET https://puentehogar.org/api/edificios

Lista de edificios/estructuras reportados como colapsados o inhabitables (nombre + zona), actualizada automáticamente.

Licencia

Uso libre para fines humanitarios de coordinación de ayuda. Solo te pedimos citar la fuente: «Datos de PuenteHogar — puentehogar.org».

⚠️ Es una fuente colaborativa en tiempo real: úsala como indicio para coordinar, no como registro oficial del Estado.

🇬🇧 In English — PuenteHogar publishes free, open, non-personal data to help centralize earthquake-relief information (Venezuela 2026). Endpoint: GET https://puentehogar.org/api/publico (JSON, open CORS, ~10-min cache). No personal data is ever exposed (no phones, IDs, names or addresses) — only needs and locations by area. Free for humanitarian use; please credit «PuenteHogar — puentehogar.org».