Saltar al contenido
Hitz.mxHitz.mx
ÚneteEntrar a tu cuenta

El API de Hitz.mx

Los mismos datos públicos que ya ves en el sitio (bandas, venues, promotores, shows), en JSON. Sin keys, sin registro, sin autenticación: si es público en Hitz.mx, es público aquí. Pensada para bots, automatizaciones e integraciones de terceros (por ejemplo, un bot de Discord que avise de shows nuevos).

Ojo: esta API sigue en desarrollo y los endpoints pueden cambiar sin aviso previo.

Autenticación

Ninguna. Todos los endpoints son de solo lectura sobre datos ya públicos.

Límite de uso

60 solicitudes por minuto, por IP. Pasado el límite, verás un 429.

Formato

JSON siempre. Las URLs de fotos ya vienen completas, listas para usarse.

Ver el índice en vivo ↗¿Dudas o algo que falta? Escríbenos
GET/bandas

Lista todas las bandas registradas en Hitz.mx.

Parámetros (query string, todos opcionales)

ciudadFiltra por ciudad exacta. Ej: Chihuahua
generoFiltra por género exacto. Ej: Punk

Ejemplo

curl "https://hitz.mx/api/v1/bandas?ciudad=Chihuahua"

Respuesta

{
  "items": [
    {
      "slug": "zovek",
      "name": "Zovek",
      "bio": "Tomamos la violencia ritual...",
      "photoUrl": "https://cdn.hitz.mx/photos/...",
      "genres": ["Punk", "Metal"],
      "ciudad": "Chihuahua",
      "links": { "instagram": "...", "spotify": null, ... },
      "badges": { "verified": true, "founder": true, ... },
      "status": { "buscandoIntegrantes": false, ... },
      "likesCount": 12,
      "profileUrl": "https://hitz.mx/bandas/zovek",
      "createdAt": "2026-08-27T04:12:00.000Z"
    }
  ]
}
GET/bandas/{slug}

El mismo objeto de arriba, para una sola banda por su slug. 404 si no existe.

Ejemplo

curl "https://hitz.mx/api/v1/bandas/zovek"

Respuesta

{
  "slug": "zovek",
  "name": "Zovek",
  "bio": "Tomamos la violencia ritual...",
  "photoUrl": "https://cdn.hitz.mx/photos/...",
  "genres": ["Punk", "Metal"],
  "ciudad": "Chihuahua",
  "links": { "instagram": "...", "spotify": null, ... },
  "badges": { "verified": true, "founder": true, ... },
  "status": { "buscandoIntegrantes": false, ... },
  "likesCount": 12,
  "profileUrl": "https://hitz.mx/bandas/zovek",
  "createdAt": "2026-08-27T04:12:00.000Z"
}
GET/venues

Lista todos los venues registrados en Hitz.mx.

Parámetros (query string, todos opcionales)

ciudadFiltra por ciudad exacta. Ej: Chihuahua
tipoFiltra por tipo exacto. Ej: Bar

Ejemplo

curl "https://hitz.mx/api/v1/venues?ciudad=Chihuahua"

Respuesta

{
  "items": [
    {
      "slug": "pryccns",
      "name": "PRYCCNS",
      "bio": "...",
      "photoUrl": "https://cdn.hitz.mx/photos/...",
      "tipos": ["Bar", "Foro"],
      "ciudad": "Chihuahua",
      "address": { "direccion": "...", "colonia": "...", "codigoPostal": "...", "mapsUrl": "..." },
      "capacidad": null,
      "links": { "instagram": "...", "tiktok": null, ... },
      "badges": { "verified": true, "pro": false },
      "status": { "buscandoBandas": false, "bookingAbierto": true, ... },
      "likesCount": 5,
      "profileUrl": "https://hitz.mx/venues/pryccns",
      "createdAt": "2026-08-27T04:12:00.000Z"
    }
  ]
}
GET/venues/{slug}

El mismo objeto de arriba, para un solo venue por su slug. 404 si no existe.

Ejemplo

curl "https://hitz.mx/api/v1/venues/pryccns"

Respuesta

{
  "slug": "pryccns",
  "name": "PRYCCNS",
  "bio": "...",
  "photoUrl": "https://cdn.hitz.mx/photos/...",
  "tipos": ["Bar", "Foro"],
  "ciudad": "Chihuahua",
  "address": { "direccion": "...", "colonia": "...", "codigoPostal": "...", "mapsUrl": "..." },
  "capacidad": null,
  "links": { "instagram": "...", "tiktok": null, ... },
  "badges": { "verified": true, "pro": false },
  "status": { "buscandoBandas": false, "bookingAbierto": true, ... },
  "likesCount": 5,
  "profileUrl": "https://hitz.mx/venues/pryccns",
  "createdAt": "2026-08-27T04:12:00.000Z"
}
GET/promotores

Lista todos los promotores, disqueras y colectivos registrados en Hitz.mx.

Parámetros (query string, todos opcionales)

ciudadFiltra por ciudad exacta.
subtipopromotor, disquera o colectivo.

Ejemplo

curl "https://hitz.mx/api/v1/promotores?subtipo=disquera"

Respuesta

{
  "items": [
    {
      "slug": "nacion-libre-records",
      "name": "Nación Libre Records",
      "bio": "Disquera independiente",
      "photoUrl": "https://cdn.hitz.mx/photos/...",
      "subtipo": "disquera",
      "genres": [],
      "ciudad": "Chihuahua",
      "links": { "instagram": "...", "tiktok": "", ... },
      "badges": { "verified": true },
      "profileUrl": "https://hitz.mx/promotores/nacion-libre-records",
      "createdAt": "2026-08-20T07:51:41.972Z"
    }
  ]
}
GET/promotores/{slug}

El mismo objeto de arriba, para un solo promotor por su slug. 404 si no existe.

Ejemplo

curl "https://hitz.mx/api/v1/promotores/nacion-libre-records"

Respuesta

{
  "slug": "nacion-libre-records",
  "name": "Nación Libre Records",
  "bio": "Disquera independiente",
  "photoUrl": "https://cdn.hitz.mx/photos/...",
  "subtipo": "disquera",
  "genres": [],
  "ciudad": "Chihuahua",
  "links": { "instagram": "...", "tiktok": "", ... },
  "badges": { "verified": true },
  "profileUrl": "https://hitz.mx/promotores/nacion-libre-records",
  "createdAt": "2026-08-20T07:51:41.972Z"
}
GET/la-escena

El feed de La Escena: actualizaciones de banda, shows, posts de fans y actualizaciones de promotor, mezclados en un solo feed cronológico, igual que en el sitio. Cada item trae su propio kind (band_update, event, fan_post o promoter_update) con su forma correspondiente. Sin filtro por tipo de contenido: filtra del lado tuyo sobre kind si solo te interesa uno.

Parámetros (query string, todos opcionales)

ciudadFiltra por ciudad exacta.
generoUno o más géneros, separados por coma.
cursorEl nextCursor de la respuesta anterior, para paginar.

Ejemplo

curl "https://hitz.mx/api/v1/la-escena?ciudad=Chihuahua"

Respuesta

{
  "items": [
    {
      "id": "0cf78003-...",
      "kind": "band_update",
      "createdAt": "2026-09-01T20:18:11.733Z",
      "message": "...",
      "photoUrl": null,
      "linkUrl": null,
      "musicUrl": null,
      "videoUrl": "https://www.instagram.com/p/...",
      "likesCount": 1,
      "commentCount": 0,
      "url": "https://hitz.mx/bandas/flores-salvajes/actualizaciones/0cf78003-...",
      "band": { "slug": "flores-salvajes", "name": "Flores Salvajes", "photoUrl": "...", "ciudad": "Chihuahua" }
    },
    {
      "id": "8ee49281-...",
      "kind": "event",
      "createdAt": "2026-09-07T22:04:00.327Z",
      "message": "...",
      "url": "https://hitz.mx/calendario/belafonte-sensacional-2026-10-03",
      "event": { "slug": "belafonte-sensacional-2026-10-03", "title": "Belafonte Sensacional", "startsAt": "...", "venueLabel": "Armónico" },
      "band": null,
      "promoter": null
    },
    {
      "id": "ada1a776-...",
      "kind": "fan_post",
      "createdAt": "2026-09-08T16:46:50.741Z",
      "message": "...",
      "url": "https://hitz.mx/la-escena/ada1a776-...",
      "postType": "Aviso",
      "author": { "type": "staff", "name": "...", "photoUrl": "...", "profileUrl": "https://hitz.mx/staff/..." },
      "band": null
    }
  ],
  "nextCursor": "2026-08-26T16:32:21.202Z"
}
GET/calendario

Próximos shows, del más cercano al más lejano. Paginado: usa nextCursor para pedir la siguiente página.

Parámetros (query string, todos opcionales)

ciudadFiltra por ciudad exacta.
mesFiltra por mes. Formato YYYY-MM.
qBusca en título, venue o lineup.
generoUno o más géneros, separados por coma.
cursorEl nextCursor de la respuesta anterior, para paginar.
limitResultados por página. Máximo 50, default 20.

Ejemplo

curl "https://hitz.mx/api/v1/calendario?ciudad=Chihuahua&limit=5"

Respuesta

{
  "items": [
    {
      "slug": "zovek-en-pryccns-2026-09-20",
      "title": "Zovek en PRYCCNS",
      "startsAt": "2026-09-20T02:00:00.000Z",
      "endsAt": null,
      "status": "programado",
      "statusNote": null,
      "ticketUrl": "https://...",
      "description": "...",
      "photoUrl": "https://cdn.hitz.mx/photos/eventos/...",
      "likesCount": 3,
      "ciudad": "Chihuahua",
      "venue": { "slug": "pryccns", "name": "PRYCCNS" },
      "venueNameOther": null,
      "lineup": ["Zovek", "..."],
      "eventUrl": "https://hitz.mx/calendario/zovek-en-pryccns-2026-09-20"
    }
  ],
  "nextCursor": "2026-09-20T02:00:00.000Z"
}
GET/calendario/{slug}

Detalle de un show por su slug, con la dirección completa del venue, el promotor que lo organizó (si aplica) y el lineup resuelto (con slug y foto de cada banda que ya tiene perfil). 404 si no existe.

Ejemplo

curl "https://hitz.mx/api/v1/calendario/zovek-en-pryccns-2026-09-20"

Respuesta

{
  "slug": "zovek-en-pryccns-2026-09-20",
  "title": "Zovek en PRYCCNS",
  "startsAt": "2026-09-20T02:00:00.000Z",
  "endsAt": null,
  "status": "programado",
  "statusNote": null,
  "ticketUrl": "https://...",
  "description": "...",
  "photoUrl": "https://cdn.hitz.mx/photos/eventos/...",
  "recapPhotoUrl": null,
  "genres": ["Punk", "Metal"],
  "likesCount": 3,
  "ciudad": "Chihuahua",
  "venue": {
    "slug": "pryccns",
    "name": "PRYCCNS",
    "mapsUrl": "...",
    "direccion": "...",
    "colonia": "...",
    "codigoPostal": "..."
  },
  "venueNameOther": null,
  "promoter": null,
  "lineup": [
    { "name": "Zovek", "slug": "zovek", "photoUrl": "https://cdn.hitz.mx/photos/..." }
  ],
  "eventUrl": "https://hitz.mx/calendario/zovek-en-pryccns-2026-09-20"
}

¿Armaste algo con esto? Nos gustaría verlo en acción, cuéntanos.