Documentación

Una llamada HTTP. Dos tipos de clave, y la diferencia entre las dos es la razón entera por la que los números de acá significan algo.

Dos claves, dos permisos

hmu_pk_live_…

Clave pública — segura en el navegador. Vistas, sesiones y tus eventos personalizados. No puede crear usuarios, y eso es a propósito.

hmu_sk_live_…

Clave secreta — sólo en tu servidor. Altas y bajas de usuarios, importaciones, eventos de suscripción.

Mandar eventos

Un evento, o hasta 100 de una. Un evento malo nunca tira el lote: te devolvemos qué entró y exactamente qué estaba mal en cada rechazo.

POST /v1/events

curl -X POST https://howmuchusers.wtf/api/v1/events \
  -H "Authorization: Bearer $HMU_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"event":"user.created","user_id":"usr_123","created_at":"2026-08-08T20:00:00Z"}'

Node / Next.js

// HowMuchUsers — desde tu servidor (Node, Next.js, cualquier backend).
// La clave secreta vive en el entorno. NUNCA en el código del navegador.
async function hmuUserCreated(user) {
  await fetch("https://howmuchusers.wtf/api/v1/events", {
    method: "POST",
    headers: {
      "Content-Type": "application/json",
      Authorization: `Bearer ${process.env.HMU_SECRET_KEY}`,
    },
    body: JSON.stringify({
      event: "user.created",
      user_id: user.id,          // un id estable. No mandes emails ni nombres.
      created_at: user.createdAt, // ISO 8601
    }),
  });
}

Importar tu historia

Los usuarios que tenías antes de instalarnos. Quedan marcados como importados para siempre: suman a tu total, se aclara en tu perfil público, y no cuentan para los rankings de crecimiento.

POST /v1/users/import

# Los usuarios que ya tenías. Quedan marcados como importados: suman a tu
# total, pero no a los rankings de crecimiento. Hasta 1.000 por pedido.
curl -X POST https://howmuchusers.wtf/api/v1/users/import \
  -H "Authorization: Bearer $HMU_SECRET_KEY" \
  -H "Content-Type: application/json" \
  -d '{"users":[
        {"user_id":"usr_1","created_at":"2025-11-03"},
        {"user_id":"usr_2","created_at":"2025-11-04"}
      ]}'

Comprobar que anda

La misma cabecera, sin cuerpo. Devuelve live: true apenas llega tu primer evento.

GET /v1/status

curl https://howmuchusers.wtf/api/v1/status \
  -H "Authorization: Bearer $HMU_SECRET_KEY"

Badges y contadores

No necesitan clave: dibujan sólo lo que elegiste publicar. El código para pegar, con el enlace de atribución, está en la pestaña Desarrollo de tu proyecto.

SVG

<img src="https://howmuchusers.wtf/api/badge/tu-startup.svg?theme=dark&lang=es" alt="" height="44" />