🏠 Home
Build Hope
Help every family have a place to call home — funded through OseloHelp.com, our tax-exempt non-profit corporation.
TimTim.Live Developer Preview
How do I put events on my website?
Five small steps. No account needed to try it.
- 1
Choose a city.
- 2
Copy the code.
- 3
Paste it into your page.
- 4
Reload the page.
- 5
Events appear.
Your code — paste it where the events should appear
<script src="https://timtim.live/widget/events.js"
data-city="Miami" data-category="music" async></script>This runs the exact code above, right here on this page.
That is it. Without a key you see sample events, so you can build safely. When you are ready for real events, get a website key and add data-key="tt_pk_live_…".
Change how it looks
Add any of these to the script tag.
| Attribute | What it does |
|---|---|
| data-city | A city name, like Miami or Paris. |
| data-country | A two-letter country code, like US or FR. |
| data-category | music, festival, nightlife, conference… |
| data-near | A place, like "Paris,FR". |
| data-artist | Only events with this performer. |
| data-limit | How many events, 1 to 24. Six if you leave it out. |
| data-lang | The widget's language, like fr or es. Your page's own language if you leave it out. |
| data-color | The button color, like #0e7490. |
| data-key | Your website key (tt_pk_live_…) for real events. Without it you get sample events. |
The widget draws inside its own box (a shadow root), so your styles cannot break it and it cannot break yours. It only ever writes text, never HTML.
Prefer JavaScript?
Ask the API yourself. This works in any browser or in Node 18+, with no key, for sample events.
JavaScript
const res = await fetch("https://api.timtim.live/v1/demo/events?city=Miami&category=music");
const { events } = await res.json();
for (const event of events) {
console.log(event.name, event.display.date_label, event.tickets.buy_url);
}For your own events, use a key and /v1/events instead of /v1/demo/events:
With a key
const res = await fetch("https://api.timtim.live/v1/events?city=Miami&category=music", {
headers: { Authorization: "Bearer tt_test_YOUR_KEY" },
});Keys that start tt_sk_live_ are secret: keep them on your server, never in a web page.
Next steps
- Get a free test key — sign in, then make a test key. No card.
- Use the sandbox — test purchases, refunds and bad days.
- WordPress plugin — the same widget, no code.
- All the docs
Are you representing a company?
Learn how TimTim.Live distribution partnerships work.
Partner Program →
