Embed Your Events Anywhere: A Public JSON Feed for Every Shop
Your events have always lived on your Usetix shop. Today they live on every other site you want them on too.
Every published event in your shop is now available as JSON on the same URL — just append .json (or send Accept: application/json). No token, no signup, no proxy. Drop a few lines of JavaScript on your band’s site, your festival’s hub, or a partner’s listings page, and your full lineup shows up there, automatically.
What you get
curl -H "Accept: application/json" \
https://your-subdomain.usetix.io/events
Returns your published, upcoming events with everything a third-party page needs to render them: title, dates, venue (with lat/lng for maps), images, sold-out flag, cheapest available price, and a direct purchase URL.
GET /events/spring-showcase.json adds tickets, performers, and FAQ for a single event.
That’s it. Two endpoints, public, no auth.
Built for embedding
A few opinions baked in:
- CORS open to all origins. Fetch it from any browser, any domain.
Cache-Control: public, max-age=60— your CDN, your reverse proxy, even the visitor’s browser will happily cache it for a minute.ETagon event detail — repeat fetches return304 Not Modifiedand an empty body when nothing changed.- Absolute image URLs — drop them directly into
<img src=...>from any origin. - Money as
{ amount, currency }— same shape as the rest of the API, no symbols, no floats.
A 10-line “next event” widget
<div id="next-event"></div>
<script>
fetch("https://your-subdomain.usetix.io/events.json")
.then(r => r.json())
.then(data => {
const next = data.events[0];
if (!next) return;
document.getElementById("next-event").innerHTML = `
<a href="${next.url}">
<img src="${next.image_url}" alt="">
<h3>${next.title}</h3>
<p>${new Date(next.starts_at).toLocaleString()} · ${next.venue.name}</p>
</a>`;
});
</script>
Drop that on your band’s WordPress, your venue’s Squarespace, your festival’s static landing page. It refreshes itself the next time a visitor loads the page — and the moment you publish a new event in Usetix, it’s there.
What’s not in the feed
The public feed exposes only what your shop already shows publicly. Drafts, hidden tickets without an access code, capacity numbers, ticket stock, customer data, order data — none of that is in there. For all of it, plus full write access, use the authenticated admin API.
Try it
Pick any event in your account, publish it, and request its slug:
curl https://your-subdomain.usetix.io/events.json
The full reference — every field, every endpoint, with embedding examples — is at usetix.io/docs/api/public-events.
Build something cool with it? Tell us at [email protected].