API pública

Acceso gratuito y de solo lectura a los recursos verificados del directorio. No requiere autenticación. Solo pedimos que cites la fuente.

Base URL: https://venezuelaune.org

Reglas de uso

  • ✓Sin autenticación. La API es abierta.
  • ✓Rate limit: 60 requests/minuto por IP. Si excedes, recibes HTTP 429.
  • ✓Cache: Las respuestas se cachean 5 min en el navegador y CDN.
  • ✓Solo datos aprobados. Nunca verás recursos pending o rejected.
  • ✓Sin datos sensibles. No exponemos emails, IPs ni metadata interna.
  • ✓CORS abierto. Puedes consumirla desde cualquier origen.

Endpoints

GET/api/public/resources

Lista los recursos aprobados (donaciones, refugios, hospitales, etc.)

Parámetros

  • categorystring · opcional— Filtrar por slug de categoría (ej: donaciones, albergue)
  • limitnumber · opcional— Cantidad de resultados (max 100, default 50)
  • offsetnumber · opcional— Saltar N resultados (para paginación)

Ejemplo

https://venezuelaune.org/api/public/resources?category=donaciones&limit=10
GET/api/public/resources/:id

Detalle de un recurso específico por su UUID

Ejemplo

https://venezuelaune.org/api/public/resources/15663421-dfb9-4242-af03-e3eea92eabfd
GET/api/public/categories

Lista las 10 categorías disponibles

Ejemplo

https://venezuelaune.org/api/public/categories
GET/api/public/stats

Estadísticas generales (total, por categoría)

Ejemplo

https://venezuelaune.org/api/public/stats

Ejemplos de uso

JavaScript (fetch)

const res = await fetch('https://venezuelaune.org/api/public/resources?category=donaciones')
const { data, pagination } = await res.json()

console.log(`${data.length} donaciones encontradas`)
for (const r of data) {
  console.log(`- ${r.title} (${r.category_name})`)
  console.log(`  ${r.url}`)
}

cURL

curl https://venezuelaune.org/api/public/resources?limit=5 | jq .data[].title

Python

import requests
r = requests.get('https://venezuelaune.org/api/public/resources?category=salud')
for recurso in r.json()['data']:
    print(f"{recurso['title']} — {recurso['url']}")

Créditos

Si usas esta API, por favor cita la fuente: "Datos de venezuelaune.org". Si construyes algo con ella, cuéntanos por Instagram @vnz.dev.