API abierta

Consolidamos en un solo lugar lo que estaba disperso y lo compartimos por API, no por volcado de base de datos. Cualquier plataforma —medios, ONG, otras webs de búsqueda— puede leer el estado consolidado y publicado para que nadie trabaje a ciegas.

Lo esencial

Abierta y gratuita, sin clave. Solo lectura (GET).
CORS abierto (*): se puede consumir desde el navegador.
Atribución obligatoria: muestra «Venezuela Reporta» como fuente.
Sin datos de contacto: nunca servimos teléfonos por API; enlaza a la ficha.
Comunitario y sin verificar: trátalo como señal, no como fuente oficial.
Límite 120 peticiones/min por origen · caché de 60 s. No hagas polling agresivo.

Personas

Registro consolidado de personas (desaparecidos, a salvo y encontrados), incluido lo que reunimos de plataformas hermanas y lo que extraemos con IA de las listas de hospitales y clínicas. Solo lo que ya es público en Buscar.

GET https://venezuelareporta.org/api/v1/personas

Parámetro	Ejemplo	Descripción
q	?q=María	Nombre, ciudad, zona o cédula (coincidencia parcial).
status	?status=buscando	buscando · a_salvo · encontrado.
ciudad	?ciudad=Caracas	Coincidencia parcial, sin distinción de mayúsculas.
since	?since=2026-06-26T00:00:00Z	Solo fichas creadas desde esa fecha ISO.
limit	?limit=100	Tope por página (máx. 100).
offset	?offset=100	Paginación; usa total para recorrer.

{
  "ok": true,
  "atribucion": "Venezuela Reporta — venezuelareporta.org",
  "generado_at": "2026-06-27T12:00:00.000Z",
  "total": 1240,
  "limit": 100,
  "offset": 0,
  "personas": [
    {
      "id": "uuid",
      "status": "buscando",
      "nombre": "María Pérez",
      "cedula": "V-12345678",
      "genero": "femenino",
      "edad": 34,
      "ciudad": "Caracas",
      "zona": "El Valle",
      "ultima_vez": "Cerca de la estación del metro",
      "descripcion": "...",
      "foto_url": "https://.../fotos/...jpg",
      "origen": "venezuelatebusca",
      "verificado": false,
      "created_at": "2026-06-26T11:30:00.000Z",
      "ficha_url": "https://venezuelareporta.org/reporte/uuid"
    }
  ]
}

Las fichas duplicadas se excluyen: solo devolvemos la canónica. Usa id, cedula u origen para cruzar con tus datos, y enlaza a ficha_url para que una familia pueda contactar.

Centros de acopio y clínicas

Estado en vivo y consolidado de sitios (acopio, clínica, hospital, refugio) a partir de reportes de voluntarios en el terreno. Sin datos personales.

GET https://venezuelareporta.org/api/v1/sitios

Parámetro	Ejemplo	Descripción
municipio	?municipio=Baruta	Coincidencia parcial, sin distinción de mayúsculas.
tipo	?tipo=acopio	acopio · clinica · hospital · refugio · otro.
since	?since=2026-06-26T00:00:00Z	Solo sitios con reporte desde esa fecha ISO.
limit	?limit=500	Tope de resultados (máx. 5000).

Detalle de un sitio (con check-ins publicados): GET /api/v1/sitios/{id}.

Alimentar el registro (escritura)

Cualquiera lee; escriben solo los socios a los que les emitimos una llave (no hay escritura anónima). Si tu plataforma quiere volcar su lista al registro común, escríbenos y coordinamos una llave. Luego envías por POST con la cabecera x-api-key.

POST https://venezuelareporta.org/api/v1/personas
x-api-key: <tu-llave>
Content-Type: application/json

{
  "status": "buscando",          // buscando | a_salvo | encontrado
  "nombre": "María Pérez",
  "ciudad": "Caracas",
  "cedula": "V-12345678",        // opcional
  "genero": "femenino",          // opcional
  "edad": 34,                     // opcional
  "zona": "El Valle",            // opcional
  "ultima_vez": "...",           // opcional
  "descripcion": "...",          // opcional
  "origen_id": "tu-id-estable"   // recomendado: idempotencia
}

Idempotente: reenviar el mismo origen_id actualiza la ficha, no la duplica. Tus fichas quedan atribuidas a tu entidad en origen.
Según tu llave: entra directa al registro (respuesta 201 publicado) o queda pendiente de que la revisemos (202 pendiente).
Privado por defecto: el contacto es opcional y no se publica. No se acepta el estado «fallecido».
401 sin llave · 403 llave sin permiso de escritura · 400 datos inválidos · 429 límite.

¿Necesitas más?

Si necesitas un volumen mayor, otro corte de datos o quieres consolidar tu lista en el registro, escríbenos a ayuda@venezuelareporta.org. Si tienes una lista de personas, también puedes enviárnosla aquí y la cruzamos con los desaparecidos.