Lo que puedes hacer
Crear un enlace corto
Si no eliges el código, el servicio genera uno de 7 caracteres. Si lo eliges, queda como alias, único en su dominio.
Alias de 3 a 32 caracteres
Letras minúsculas, dígitos, guion y guion bajo, por ejemplo
promo-septiembre.Hasta 1.000 enlaces por petición
El alta en lote devuelve un resultado por enlace: uno inválido no tumba a los demás.
h0b.co o tu propio dominio
Publicas en los dominios de la plataforma, como h0b.co, o en un dominio propio que ya esté verificado.
Vencimiento opcional
Al vencer, el enlace deja de redirigir y quien lo abre recibe un 404.
Cambiar el destino sin cambiar el enlace
Editas el destino, el estado o el vencimiento. El dominio y el código no cambian, así que los enlaces ya repartidos siguen funcionando.
Eliminar y restaurar
Un enlace eliminado se puede restaurar durante 90 días, con el mismo código y sin un nuevo cobro.
Estadísticas de visitas
Totales del rango, serie por día o por hora y desglose por país, dispositivo, sistema, navegador u origen, por enlace o de toda tu organización.
Reintentos sin duplicados
Con una llave de idempotencia, repetir una creación que se cortó devuelve el mismo enlace, sin crear otro ni cobrar dos veces.
Cómo funciona
Cuatro pasos, desde crear el enlace hasta leer sus visitas.
POST /api/ v6/ urlshortener/ links Tu aplicación crea el enlace
Envías la URL de destino y, si quieres, un alias, un dominio y un vencimiento.
201 · shortUrlRecibes el enlace corto
La respuesta trae el enlace listo para compartir, por ejemplo dentro de un SMS.
h0b.co/ … Una persona lo abre
Llega a tu destino. Si el enlace venció o lo eliminaste, recibe un 404.
GET …/stats Tú lees las visitas
Consultas totales, serie y desgloses por enlace, o el resumen de toda tu organización.
Tu primer enlace
Cambia hk_TU_API_KEY por tu clave de API. Este ejemplo crea un enlace y, como ocurre con cualquier alta, se cobra si tu plan no lo incluye.
curl -X POST https://developers.hablame.co/api/v6/urlshortener/links \
-H "Authorization: Bearer hk_TU_API_KEY" \
-H "Idempotency-Key: 5f3b2c10-9a7e-4b2d-8c1f-0a1b2c3d4e5f" \
-H "Content-Type: application/json" \
-d '{
"longUrl": "https://example.com/landing?utm_source=sms",
"domain": "h0b.co",
"code": "promo-septiembre",
"expiresAt": "2026-12-31T23:59:59-05:00"
}'{
"success": true,
"data": {
"domain": "h0b.co",
"code": "a1b2c3d",
"shortUrl": "https://h0b.co/a1b2c3d",
"longUrl": "https://example.com/landing?utm_source=sms",
"isAlias": false,
"status": "active",
"domainStatus": "active",
"expiresAt": null,
"createdAt": "2026-09-23T15:04:05Z",
"clicks": 0,
"uniqueClicks": 0,
"firstClickAt": null,
"lastClickAt": null
},
"meta": {
"requestId": "8f0c0e2a4b1d4c8f",
"clientIp": "203.0.113.45",
"timestamp": "2026-09-23T18:30:00+00:00",
"responseTimeMs": 7.2
}
}Qué necesitas
- Una clave de API de tu organización con el acortador habilitado.
- Con el servicio del acortador, la clave consulta, crea y edita enlaces: el servicio se da completo. Solo el propietario de tu organización crea las claves.
- Saldo disponible o un plan mensual del acortador vigente. Sin ninguno de los dos, la API no crea el enlace.
- Si quieres usar un dominio propio, escríbenos: la API no registra ni verifica dominios, y solo se publica en los ya verificados.
Qué se cobra
Aquí no publicamos precios. Puedes ver el vigente de tu organización con GET / o preguntarle al equipo comercial.
- Crear un enlace se cobra, salvo que tengas un plan mensual del acortador que lo incluya.
- Después, cada visita de una persona al enlace también se cobra. Las de robots y las vistas previas no.
- Editar, eliminar, restaurar y consultar estadísticas no tienen costo.
¿Quieres integrarlo?
Cuéntanos qué necesitas y te orientamos sobre cómo conseguir tu clave de API.