🔌 API Pública · Solo lectura

API para Desarrolladores

Datos en tiempo real de centros de acopio, refugios y links de donación verificados. Gratis, sin registro, acceso de solo lectura.

URL base

https://apoyo-venezuela.com/api/v1

Ejemplo en:

GET/api/v1/centros

Devuelve todos los centros de acopio activos. Sin parámetros trae todo; puedes filtrar por estado, municipio o texto libre.

Parámetro	Tipo	Descripción
estado_id	string	Filtra por ID del estado (ej. VE-A)
municipio_id	string	Filtra por ID del municipio
q	string	Búsqueda por nombre o dirección (máx. 80 chars)

Campo	Tipo	Descripción
id	string	Identificador único
nombre	string	Nombre del centro
direccion	string	Dirección física
municipio_id	string	ID del municipio
estado_id	string \| null	ID del estado
estatus	string	activo \| saturado \| sin_verificar
ubicacion_url	string \| null	Enlace a Google Maps
contacto	string \| null	Teléfono de contacto del centro
estado_vialidad	string \| null	Condiciones de acceso vial
horario_recepcion	string \| null	Horario de atención
verificado	boolean	Si fue verificado por el equipo
municipios	object \| null	{ id, nombre, estado_id }
necesidades	array	Lista de insumos necesarios con urgencia

código

curl "https://apoyo-venezuela.com/api/v1/centros"

GET/api/v1/refugios

Devuelve todos los refugios activos. Sin parámetros trae todo; puedes filtrar por zona o buscar por texto.

Parámetro	Tipo	Descripción
zona	string	Filtra por zona exacta (ej. Norte, Sur)
q	string	Búsqueda por nombre, municipio, zona o necesidades

Campo	Tipo	Descripción
id	string	Identificador único
nombre	string	Nombre del refugio
direccion	string \| null	Dirección
referencia_lugar	string \| null	Referencia o punto cercano
zona	string \| null	Zona geográfica
municipio	string \| null	Municipio
contacto_nombre	string \| null	Nombre del responsable
contacto_telefono	string \| null	Teléfono del responsable
num_personas	number \| null	Número de personas albergadas
necesidades	string \| null	Texto libre con necesidades
confirmado	boolean	Si fue confirmado por el equipo
google_maps_url	string \| null	Enlace a Google Maps

código

curl "https://apoyo-venezuela.com/api/v1/refugios"

GET/api/v1/donaciones

Devuelve todos los links de donación verificados y activos. No hay parámetros — trae todo.

Campo	Tipo	Descripción
id	string	Identificador único
title	string	Nombre de la organización o campaña
description	string	Descripción breve
url	string \| null	Enlace a la página de donación
whatsapp_phone	string \| null	Número para contacto por WhatsApp cuando no hay URL
image_url	string \| null	Logo o imagen representativa
country	string \| null	Código ISO 3166-1 del país (ej. VE, US, ES)
is_active	boolean	Siempre true en esta respuesta

código

curl "https://apoyo-venezuela.com/api/v1/donaciones"

Todas las respuestas usan la misma estructura:

código

{
  "ok": true,
  "data": [ /* arreglo de objetos */ ],
  "count": 42,
  "timestamp": "2026-06-29T00:00:00.000Z"
}

En caso de error:

código

{
  "ok": false,
  "error": "Error al obtener centros de acopio"
}