API REST gratuita con datos falsos en español para prototipos, demos y frontends.
Estás montando una maqueta, un demo para un cliente o un frontend y necesitas datos de ejemplo que se vean reales. En vez de usar usuarios en inglés o inventar JSON a mano, llama a HispAPI y listo: nombres, direcciones, productos, refranes, citas y más, todo en español.
- Sin clave, sin registro y gratis.
- CORS habilitado: se puede llamar desde el navegador.
- Respuestas en español y con datos que encajan (direcciones con ciudad y departamento reales de Colombia, nombres con género, productos con precio en pesos).
Base: https://hisp-api.vercel.app
Todos devuelven { "endpoint": "...", "count": N, "data": [...] }.
| Ruta | Descripción | Parámetros |
|---|---|---|
GET /api |
Índice con todos los endpoints | — |
GET /api/names |
Nombres en español (con género) | gender, limit |
GET /api/users |
Usuarios completos (nombre, email, teléfono, dirección, empresa) | limit, seed |
GET /api/posts |
Publicaciones | limit, seed |
GET /api/comments |
Comentarios | limit, seed |
GET /api/products |
Productos con precio en pesos | category, limit |
GET /api/addresses |
Direcciones colombianas (calle, número, ciudad, departamento, código postal) | limit, seed |
GET /api/companies |
Empresas falsas con eslogan | limit |
GET /api/refranes |
Refranes populares | limit |
GET /api/quotes |
Citas célebres con autor | limit |
GET /api/jokes |
Chistes cortos | limit |
GET /api/random |
Un elemento aleatorio de cualquier categoría | — |
limit: cuántos elementos devuelve. Mínimo 1, máximo 50. Por defecto 5.gender: filtra por género en/api/names. Valores:woman,man,random.category: filtra por categoría en/api/products. Ejemplo:Tecnología.seed: si lo pasas, los resultados generados son siempre los mismos (útil para demos estables).
# Cinco usuarios
curl https://hisp-api.vercel.app/api/users?limit=5
# Nombres de mujer
curl https://hisp-api.vercel.app/api/names?gender=woman
# Los mismos usuarios siempre (seed fija)
curl https://hisp-api.vercel.app/api/users?limit=5&seed=demo
# Productos de Tecnología
curl https://hisp-api.vercel.app/api/products?category=Tecnolog%C3%ADaDesde el navegador:
const res = await fetch("https://hisp-api.vercel.app/api/refranes?limit=3");
const body = await res.json();
console.log(body.data);
// [
// { "id": 1, "text": "A quien madruga, Dios le ayuda." },
// ...
// ]npm install # no hay dependencias, pero por si acaso
npm start # arranca en http://localhost:3000
npm test # ejecuta la suite de testsLa API no tiene dependencias externas: solo Node.js. Se puede subir a cualquier sitio que ejecute serverless o un proceso Node.
npx vercel --prodLa API vive en api/index.js y se puede ejecutar con npm start.
La lista crece con la comunidad. Si quieres añadir más nombres, ciudades, refranes o una categoría nueva, mira CONTRIBUTING.md.
MIT. Usa los datos para lo que quieras.
HispAPI · hecho con cariño y café en Colombia 🇨🇴