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.

API key

Para solicitar una API key de búsqueda, escribe a info@dataproven.org con el nombre del 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" "http://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" "http://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"
  }
]

Detalle de un edificio verificado

GET /api/buildings/{building_id}

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

Devuelve la ficha completa de un edificio específico ya validado dentro del directorio.

Parámetros

building_id: identificador del edificio, por ejemplo opp33-bulevar-naiguata.

Prueba de llamada

curl -H "x-api-key: TU_API_KEY" "http://preview.venezuela.dataproven.org/api/buildings/opp33-bulevar-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 para pedir la API key

Este es un ejemplo de correo que puedes enviar a info@dataproven.org.

Asunto: Solicitud de API key - Deep Search Venezuela

Hola equipo de Data Proven,

Quiero solicitar una API key para integrar la búsqueda simultánea.

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

Gracias.

Esta es una iniciativa ciudadana de emergencia y hacemos nuestro mayor esfuerzo para verificar cada reporte. Si quieres colaborar, escríbenos a info@dataproven.org.