Venezuela

Integraciones privadas

API para búsqueda simultánea y edificios verificados

No publicamos un esquema OpenAPI público. En este momento ofrecemos únicamente nuestros endpoints de búsqueda simultánea para integraciones en otras páginas, y nuestros endpoints de edificios con información verificada por el equipo y la comunidad.

Para solicitar una API key de partner, escríbenos por el chat con el nombre del partner o proyecto, dominio, caso de uso, volumen estimado y contacto técnico.

Búsqueda simultánea

GET /api/search

Requiere API key en el header x-api-key.

Permite integrar en otras páginas una búsqueda unificada contra varias sources al mismo tiempo.

Parámetros

query: texto obligatorio a buscar.

limit_per_source: opcional, entre 1 y 100.

source_ids: opcional y repetible para limitar la búsqueda a ciertas sources.

Prueba de llamada

curl -H "x-api-key: TU_API_KEY" "https://preview-venezuela.dataproven.org/api/search?query=caracas&limit_per_source=10"

Ejemplo de respuesta

{
  "query": "caracas",
  "limit_per_source": 10,
  "sources_consulted": [
    "directorio-ciudadano",
    "red-busqueda"
  ],
  "sources": [
    {
      "source": "directorio-ciudadano",
      "source_id": "directorio-ciudadano",
      "source_name": "Directorio Ciudadano",
      "status": "ok",
      "result_count": 1,
      "reported_total_count": 1,
      "has_more_results": false,
      "error_count": 0,
      "detail": null,
      "results": [
        {
          "source": "directorio-ciudadano",
          "source_id": "directorio-ciudadano",
          "source_name": "Directorio Ciudadano",
          "external_record_id": "rep-102",
          "person_name": "Carlos Pérez",
          "age": 47,
          "sex": "M",
          "status": "missing",
          "last_seen_location": "Caracas",
          "last_seen_at": "2026-06-24T18:30:00Z",
          "contact_phone": "0412-000-0000",
          "contact_name": "Ana Pérez",
          "report_url": "https://ejemplo.org/reportes/rep-102",
          "image_url": null,
          "source_text": "Reportado por familiares en Caracas.",
          "raw_payload": {}
        }
      ]
    }
  ],
  "source_statuses": [
    {
      "source": "directorio-ciudadano",
      "source_id": "directorio-ciudadano",
      "source_name": "Directorio Ciudadano",
      "status": "ok",
      "result_count": 1,
      "reported_total_count": 1,
      "has_more_results": false,
      "error_count": 0,
      "detail": null
    },
    {
      "source": "red-busqueda",
      "source_id": "red-busqueda",
      "source_name": "Red de Búsqueda",
      "status": "empty",
      "result_count": 0,
      "reported_total_count": 0,
      "has_more_results": false,
      "error_count": 0,
      "detail": "Sin coincidencias para esta consulta."
    }
  ],
  "results": [
    {
      "source": "directorio-ciudadano",
      "source_id": "directorio-ciudadano",
      "source_name": "Directorio Ciudadano",
      "external_record_id": "rep-102",
      "person_name": "Carlos Pérez",
      "age": 47,
      "sex": "M",
      "status": "missing",
      "last_seen_location": "Caracas",
      "last_seen_at": "2026-06-24T18:30:00Z",
      "contact_phone": "0412-000-0000",
      "contact_name": "Ana Pérez",
      "report_url": "https://ejemplo.org/reportes/rep-102",
      "image_url": null,
      "source_text": "Reportado por familiares en Caracas.",
      "raw_payload": {}
    }
  ],
  "errors": []
}

Listado de edificios verificados

GET /api/buildings

Requiere API key en el header x-api-key.

Entrega el directorio de edificios con información verificada, contactos, eventos y necesidades.

Parámetros

query: opcional para filtrar por edificio, dirección, contacto, teléfono, evento o notas.

Prueba de llamada

curl -H "x-api-key: TU_API_KEY" "https://preview-venezuela.dataproven.org/api/buildings?query=naiguata"

Ejemplo de respuesta

[
  {
    "building_name": "OPP33",
    "address": "Bulevar de Naiguatá",
    "city": "Naiguatá",
    "state": "La Guaira",
    "heartbeat_at": "2026-06-28T08:15:00Z",
    "contacts": [
      {
        "person_name": "María Pérez",
        "identity_document": "V-12345678",
        "phone": "0412-111-2233",
        "person_role": "contacto",
        "search_url": null
      }
    ],
    "tags": [
      "señales de vida",
      "contacto confirmado"
    ],
    "events": [
      "Hay electricidad parcial",
      "Se necesita agua potable"
    ],
    "needs": "Agua potable y medicinas.",
    "notes": "Información validada con vecinos y contacto directo.",
    "building_id": "opp33-bulevar-naiguata",
    "photos": [],
    "created_at": "2026-06-27T20:10:00Z",
    "updated_at": "2026-06-28T08:15:00Z"
  }
]

Qué escribir por el chat para pedir la API key

Este es un ejemplo de mensaje que puedes usar en el chat.

Hola equipo de Data Proven,

Quiero solicitar una API key de partner para integrar la búsqueda simultánea y el listado de edificios verificados.

- Nombre del partner, proyecto o sitio:
- URL o dominio donde se usará:
- Caso de uso:
- Volumen estimado de consultas por día:
- Contacto técnico:

Gracias.

Es un esfuerzo ciudadano para centralizar reportes y ayudar a conectar a familias, voluntarios y rescatistas.

Hacemos nuestro mejor esfuerzo para verificar y cotejar cada caso con la información disponible, pero todos los reportes deben ser confirmados en campo por los equipos correspondientes.

Cada minuto cuenta. Si quieres colaborar, escríbenos por el chat. También puedes leer nuestra metodología.