SDKs and Tools

Nothing to install. One line of HTML.

<script src="https://timtim.live/widget/events.js"
        data-city="Miami" data-category="music" async></script>

Every option →

@timtim-live/events — no dependencies; works in browsers, Node 18+, Deno and edge runtimes. No key = sample events.

npm install @timtim-live/events

import { TimTimEvents } from "@timtim-live/events";

const timtim = new TimTimEvents({ apiKey: "tt_test_..." }); // leave the key out for sample events

const { events } = await timtim.events.list({ city: "Miami", category: "music" });
for (const event of events) console.log(event.name, event.tickets.buy_url);

Not on npm yet — the install line works once it is. Today, plain fetch does the same: see how.

<timtim-events> — an HTML tag you can style and control from your own code. TimTim.Live hosts the open-source build, so it works today with no install.

<script src="https://timtim.live/embed/v1/timtim-events.js" defer></script>
<timtim-events location="Miami,US" category="music"></timtim-events>

Build yours with every option →

From npm, once published: @timtim-live/web-component

<script type="module">import "@timtim-live/web-component";</script>
<timtim-events city="Miami" category="music" limit="6"></timtim-events>

Not on npm yet — the install line works once it is. The hosted widget above works today.

@timtim-live/react — built on the same SDK, so it never behaves differently.

import { TimTimEvents } from "@timtim-live/react";

export default function Events() {
  return <TimTimEvents city="Miami" category="music" />;
}

Not on npm yet — the install line works once it is.

A block and a shortcode, with a preview and a connection test. Download it from timtim.live; it updates itself from there. It is not on WordPress.org.

Download the pluginInstallation guide

Mobile apps

Show events inside your phone app. With no key you see sample events. All three refuse server keys, because anyone can read an app's files.

The code works today from GitHub. It is not on npm, the Swift Package Index or Maven yet.

import { TimTimEventList } from "@timtim-live/react-native";

export default function Events() {
  return <TimTimEventList location="Miami,US" category="music" />;
}

import TimTimEvents

let timtim = try TimTimEvents()                  // no key: sample events
let page = try await timtim.events(EventQuery(city: "Miami", category: "music"))

val timtim = TimTimEvents()                      // no key: sample events
val page = withContext(Dispatchers.IO) { timtim.events(EventQuery(city = "Miami", category = "music")) }

AI assistants

Let Claude, Cursor, VS Code or another MCP app find live events for you. It can only read. It never buys anything.

https://api.timtim.live/v1/mcp

npm ci && npm run build
node packages/mcp/dist/cli.js

Website builders

Every builder below works today. Most use the same embed: make it once, then paste it in.

Make your embed →Step by step for each builder →

• WordPress

  Works now

  Download the plugin. Add the TimTim.Live Events block.

  Download the plugin

• Shopify

  Works now

  Paste the embed into a Custom Liquid section.

  Code and guideShopify App Store app: coming soon

• Wix

  Works now

  Paste the embed into a Custom Element or Embed HTML box.

  Code and guideWix app: coming soon

• Squarespace

  Works now

  Paste the embed into a Code Block.

  Code and guide

• Webflow

  Works now

  Paste the embed into a Code Embed element.

  Code and guideWebflow app: coming soon

• Framer

  Works now

  Add the code component. Set it up in the side panel.

  Code and guide

• Drupal 10 and 11

  Works now

  Install the module from GitHub. Place the TimTim.Live Events block.

  Code and guide

• Joomla 4 and 5

  Works now

  Install the module. Put it in a template position.

  Code and guide

• Bubble

  Works now

  Paste the embed into an HTML element.

  Code and guideBubble plugin store listing: coming soon

Postman is an app for trying an API by pressing buttons. Our collection has every request ready to send.

1. Download the collection file from GitHub.
2. In Postman, press Import and choose that file.
3. Send "Start here: sample events (no key)". It works with no key.

Get the Postman collection

Source code

timtim-live-events on GitHub