Resumen de la API

La API pública de Sway permite a un crew (una agencia, un colectivo de promotores, un equipo de sala) llevar su propia web con sus datos de Sway. Tu web sigue siendo independiente y solo habla con Sway a través de la API:

• Muestra tu roster, tus eventos, line-ups y horarios, salas, noticias, partners, galerías y press kits.
• Vende entradas: abre un checkout de Sway desde tu web, comprueba antes un cupón o un código de acceso, sigue el pedido.
• Vende merch desde la tienda de tus páginas: el catálogo, un carrito calculado por Sway, un checkout de Stripe en la cuenta de la página.
• Recoge: solicitudes de booking, altas a la newsletter, respuestas a tus formularios.
• Lleva tu programa de embajadores en tus propias páginas: alta, acceso por enlace de email, área de miembro, clasificación, recompensas.
• Entérate de los cambios al momento con webhooks, en vez de preguntar cada pocos minutos.
• Pregunta a un asistente de IA sobre tus datos a través del servidor MCP.

URL base

https://www.sway.events/api/v1

Todos los endpoints están versionados bajo /v1. Las respuestas son JSON con claves en snake_case, salvo los feeds de calendario (text/calendar) y las exportaciones (NDJSON). GET /v1/openapi.json describe cada endpoint en OpenAPI 3.1, y GET /v1/changelog lista qué cambió y cuándo.

Quién tiene acceso

El acceso a la API viene con los planes Studio y Roster. Las claves se crean en Admin del crew → API, por alguien con el permiso Gestionar API en el crew.

Cada clave pertenece a un solo crew: es la clave, y nunca un parámetro de la petición, la que decide qué datos ves. Si la suscripción del crew caduca, sus claves dejan de funcionar hasta que vuelva a estar activa.

Qué puede ver tu clave

Todo lo que devuelve la API es gestionado o público:

Ejemplo: el artista invitado. El evento de tu promotor tiene en el cartel a un artista que no es de tu crew. Aparece dentro del line-up del evento solo con campos públicos (nombre, imagen, géneros) y "managed": false. Pedido directamente, GET /v1/artists/{id} responde 404.

Todo lo que queda fuera de las páginas de tu crew también responde 404, nunca 403, así la API no revela nada sobre lo que no puedes alcanzar.

Inicio rápido

Comprueba tu clave y lo que puede hacer:

curl https://www.sway.events/api/v1/me \
  -H "Authorization: Bearer sway_sk_YOUR_KEY"

{
  "key": {
    "id": "3f9a1c02-7b45-4c8e-9d21-0a1b2c3d4e5f",
    "type": "secret",
    "scopes": ["read:profile", "read:artists", "read:promoters", "read:events", "read:venues", "read:content"],
    "rate_limit": { "per_minute": 120, "per_day": 20000 },
    "limits": {
      "requests_per_minute": 2400,
      "crew_work_per_minute": 600,
      "crew_work_per_day": 120000,
      "bytes_per_day": 5368709120
    },
    "websites": []
  },
  "crew": { "id": "a2628d53-4f21-4c1e-9b7d-1a2b3c4d5e6f", "name": "Insomnia", "slug": "insomnia" }
}

Después lista tus próximos eventos:

curl "https://www.sway.events/api/v1/events?limit=10" \
  -H "Authorization: Bearer sway_sk_YOUR_KEY"

Un solo recurso vuelve como el propio objeto; una lista viene envuelta en { "data": [...], "pagination": {...} }.

Saber más