APIECICICCICE

E promé kos ku bo ta hasi ta fit riba un pantaya.

Purba form'é awor aki no ta clave, ni no ta un señal

Habri e adres aki den bo doño di cas. Lo bo mira algun suseso ku a tuma lugá mesora.

https://timtim.live/api/partner-network/demo?city=Washington

1
Haña un yabi di tèst
Ora di duna seña, bisa nos ken bo ta, i busca Test di prensa. E ta cuminsá cu e idea di ttpost, i ta djis mira sucesonan cu ta ilustrá e asuntu.

Haña kontesta pa susesonan

Pidi pa sosodé den un stad.

curl "https://api.timtim.live/v1/events?city=Washington&category=music" \
  -H "Authorization: Bearer tt_test_YOUR_KEY"

3
Demostrá e evento
Cada suceso tin un nomber, fecha, lugá, imágen, prijs i nombernan trahá pa bo karchi.
4
Us'é pa cumpra "wurl "
Us'é pa kumpra kos ku bo por kumpra. Esei ta e kaso. TimTim.Live ta trata cu e coneccion ei.
5
Mira resultado
Wak kon hende tabata manda, bende karchi i gana bo pan òf pidi nan.
GET https://api.timtim.live/v1/earnings

Buska Mi Klave di Prueba Purba Hacié sin un Faktor

TimTim.Live florin

• Kiko ta e kosnan ku nos ta gusta?

Unda pa manda petishon

https://api.timtim.live/v1

Bo Kantidat di Cákshon

Manda bo clave den e autornan. E klavenan di tèst (t get - mail) ta mira susesonan ku ta parse solamente un par di palabra. E clavenan clavenan (tt) por sinta den un página muhá i solamente lesa suceso. Dunamentu di yabi (ttpokapo) ta keda riba bo sirbidó i tambe por lesa salario. Un biaha nos ta mustra un yabi pa ten'é safe.

curl

curl "https://api.timtim.live/v1/events?city=Washington&category=music" \
  -H "Authorization: Bearer tt_test_YOUR_KEY"

JavaScript

const res = await fetch("https://api.timtim.live/v1/events?city=Washington&category=music", {
  headers: { Authorization: "Bearer tt_test_YOUR_KEY" },
});
const { events, next } = await res.json();
for (const event of events) {
  console.log(event.name, event.display.date_label, event.tickets.buy_url);
}

Node

// Node 18+ — keep server keys (tt_sk_live_) on the server
const res = await fetch("https://api.timtim.live/v1/events?city=Washington", {
  headers: { Authorization: `Bearer ${process.env.TIMTIM_KEY}` },
});
if (!res.ok) {
  const problem = await res.json();
  throw new Error(`${problem.title} (${problem.request_id})`);
}
const { events } = await res.json();

Python

import os, requests

res = requests.get(
    "https://api.timtim.live/v1/events",
    params={"city": "Washington", "category": "music"},
    headers={"Authorization": f"Bearer {os.environ['TIMTIM_KEY']}"},
)
res.raise_for_status()
for event in res.json()["events"]:
    print(event["name"], event["tickets"]["buy_url"])

PHP

<?php
$ch = curl_init("https://api.timtim.live/v1/events?city=Washington&category=music");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Authorization: Bearer " . getenv("TIMTIM_KEY")]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$data = json_decode(curl_exec($ch), true);
foreach ($data["events"] as $event) {
  echo $event["name"] . " " . $event["tickets"]["buy_url"] . PHP_EOL;
}

Flowonan

city: Susesonan den e stat aki.
country: Por ehempel, dos código di tereno bou di awa, por ehempel Merca.
category: Por ehempel, música, fiesta of conferencia.
from: Susesonan riba e fecha òf despues di e fecha aki (2026-10-20).
to: Suseso òf promé ku e fecha akí.
changed_since: Ta susesonan so a kambia despues di e tempu aki.
commissioned: = Solamente susesonan ku ta paga un rekompensa.
minimum_earnings: Solamente sucesonan cu ta paga por lo ménos esaki pa karchi.
near: Por ehempel, un lugá cerca di=Pris,FR.
limit: Cuantu suceso pa página, 1 pa 100 (20 si bo lagu'é afó).

Solamente bisá mi kico a cambia

Salba e tempu di bo último sync i mand'é segun cu bo ta cambia di con - cu - ta. Ta susesonan so bo ta haña ku a kambia bo punto di bista, entre otro, kanselámentu di lei i duna show. No tabatin mester di nada. Susesonan ku bo tin ku stòp di menshoná ta bini bèk den e lista ku no ta muchu leu.

GET https://api.timtim.live/v1/events?changed_since=2026-10-06T10:00:00Z

Mas cu un página

Si e kontesta a sigui, mand'é bèk komo kurador= pa haña e siguiente página. Ora bo ta den bashí, bo tin tur kos.

GET https://api.timtim.live/v1/events?city=Paris&cursor=eyJtIjoiZCIs…

Dor di Gana Kos

Cada suceso a gana. Si bo gana e premio ei, bo no ta haña e rekompensa ku ainda ta bale la pena. Si esei ta e caso, ganamentu di placa ta bisa loke bo ta haña, por ehempel, " $15 dollar pa por drenta e karchi di entrada". Si kita e compra for di base, e recompensa ta ser anulá.

Buk ta alimentá (tur loke tin den un fail)

Salba un cuminda di mas grandi na bo curpa. Despues, download tur suceso cu e ta cubri den un fail cu bo sirbidó, cu bo clave clave di sirbi: bo mester sal /vulk,vID.ndjson.gz of .cv. A agregá e idea ku e susesonan a tuma lugá solamente pa kiko a kambia, inkluso esnan ku a tuma lugá. E yabinan di prueba por pon'é na prueba awor; e mester di TimTim.Live repaso.

GET https://api.timtim.live/v1/bulk/bfs_YOURFEED.ndjson.gz?changed_since=2026-10-06T00:00:00Z

Mandadónan di propaganda riba bo mes app (e negoshi komersial komersial komersial di e sistema komersial)

Partnernan grandi por tene kumpradónan den nan mes app. Puntra GET /v1/events/EVENT_ID/tickets kiko ta na benta, despues POST /v1/orders ku e kumpradó su eskoho. Bo ta haña un link di pago di TimTim.Live pa habri pa e kumpradó; e benta ta wòrdu akreditá direkto na bo kompania. Ku yabi di prueba bo por purba awor. Uso real mester un revishon di TimTim.Live i pago ku karchi aktivá.

POST https://api.timtim.live/v1/orders  (Idempotency-Key: …)  {"event_id": "evt_test_washington_konpa", "ticket_type_id": "tt_test_washington_konpa", "quantity": 2, "buyer_email": "…", "buyer_name": "…"}

Hidvid ta ofrecé (brra i programa di recompensa)

Kada suseso ku ta paga un rekompensa komo un regalo ta mustra ku nan ta paga un suma di plaka. Cada oferta tin e documentonan, e fechanan cu bo por cumpra, e prijs, e lugá i e recompensa. Bo cliente ta sak'é dor di bo coneccion cu otro, i e recompensa ta ser pagá na bo compania via /v1 ta ser pagá. Duna un ehèmpel. Bibamentu tin mester di TimTim.Live repaso. Dunamentu di karchi di karchi direktamente mester tin un akuerdo ku un ret di karchi òf banko, i no tin nada di haber ku esei.

GET https://api.timtim.live/v1/offers?country=US

Asta státus i karchi

Nan ta programá pa posponé e posishon, posponé, kita afó, bende sèn òf kompletá karchi. Ora un evento ser kitá, tum'é abou.

GET https://api.timtim.live/v1/events/evt_test_washington_konpa

Kon lihé bo por puntra bo mes

Prueba: 60 ta pidi un minüt. Biba di un lugá pa otro: 120 pa minüt. Si bo bai mas lihé, bo ta haña 429 contesta cu Re lou- despues, e cantidad di seconde pa warda.

Kua ta e susesonan ku bo ta haña

Susesonan ku TimTim.Live persona ta krea i skohe pa kompartí. Nunka nos no ta inkluí susesonan for di otro sitionan di pasashi, pasobra nos no tin derecho di kompartí nan.

Loke nos no ta manda nunca

Skohe nòmber, adrès di e persona, adrès di kas, number di telefòn i detayenan di karchi. API ta compartí informacion di suceso, no di nos miembronan.

E Web sitenan Cu Ta Ser Obrá

Un liña di HTML ta mustra susesonan riba kualke website. Usa un website ku ta konsistí di un website (ttg) i agregá bo website na e lista ku e yabi ta permití. E no ta un faktor klave ku ta mustra algun suseso.

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

Odicion: datonan-stad, datonan bou di guia di datonan bou di cua datonan ta ser transmití, datonan bouogory, dato bou di datonan bouo na pia di página (142424), datonan-en=" berdad, datonan bou ambiente di informacion i datonan bou di color.

OA relashoná ku 2.0 (un gran variedat)

In relashoná ku esei. Haci un cliente di OA relashoná ku bo trabou di cas. Tocante su cliente ID i secreto pa haña un garantia cu ta dura un ora. Manda esei en bes di un yabi. Nunca e secreto ta biaha cu bo yamada API, i bo por pidi pa ménos alcanse cu e cliente tin.

# 1. Trade the client ID and secret for a one-hour token
curl -u "$CLIENT_ID:$CLIENT_SECRET" \
  -d grant_type=client_credentials -d "scope=events:read events:details" \
  https://api.timtim.live/v1/oauth/token
# → {"access_token":"tt_at_…","token_type":"Bearer","expires_in":3600,"scope":"events:read events:details"}

# 2. Use the token exactly like a key
curl -H "Authorization: Bearer $ACCESS_TOKEN" "https://api.timtim.live/v1/events?city=Washington"

Pa pone fin na un cos cu a sosodé trempan, P'e ta mes comun pa /v1 tanuvoke cu e mésun cliente ID i secreto. Si bo tira e kliente un banda tur loke e tin ku hasi.

Buska un yabi pa bo sirbidónan

In relashoná ku esei. Riba bo pista di trabou, haña un yabi di sirbidó, tèst yabi òf OAnrit. Habri "La pa mi sirbidónan di sirbishi " i menshoná boso adrèsnan públiko. Nan ta nenga di pidi karta i di un manera breve, for di tur otro kaminda nan ta nenga di hasi esei ku e yabi korekto.

P'esei, hasi sigur ku bo por usa bo karchi di elogio (mTL), pa kompanianan grandi: Duna nos bo sirbidó ID card (un karta) i pon'é riba un yabi. Despues yama fitps ku ta bisa: "Ta dushi pa biba kuné. " Nos ta kontestá solamente e sirbidó ku tin e karta ei.

# Your certificate's SHA-256 — paste this (or the PEM) under "Lock to my servers"
openssl x509 -in client.crt -noout -fingerprint -sha256

# Every call then presents the certificate
curl --cert client.crt --key client.key \
  -H "Authorization: Bearer $KEY" "https://api.timtim.live/v1/events?city=Washington"

PalabraPresproin

Usa Lus di Palabra? I na tur, TimTim.Live suceso: un bloki i un acococode cu ta mustra sucesonan cu bo mes propio área di TimTim.Live karchi ta conectá. E ta ser trahá dor di TimTim.Live. Ta te na fitant.▁living, i ta solamente di fittim.

E fail na Plugins → a agregá New → Plugin. Bo website ta konsistí di TimTim.Live suseso i Test di prensa. Anto agregá e bloki di TimTim.Live suceso na cualkier página.

Down down the WordPress Plugin

[timtim_events city="Washington" category="music" limit="6"]

Bòr kier sa

E mésun sucesonan cu JSON RS, XML, CSV of un fail di kalender (.c.). Djis un Kalènder ku ta kai for di otro, Kalènder i Punto di Bista Bíbliko por aboná riba e kalènder. Lesadónan di tambú no por manda kabes, p'esei pone un website klave òf un yabi di tèst den ? Nunca pone un clave den un coneccion.

https://timtim.live/v1/feeds/events.json?key=tt_pk_live_YOUR_KEY&city=Paris
https://timtim.live/v1/feeds/events.rss?key=tt_pk_live_YOUR_KEY&city=Paris
https://timtim.live/v1/feeds/events.xml?key=tt_pk_live_YOUR_KEY&city=Paris
https://timtim.live/v1/feeds/events.csv?key=tt_pk_live_YOUR_KEY&city=Paris
https://timtim.live/v1/feeds/events.ics?key=tt_pk_live_YOUR_KEY&city=Paris

Webw

Agregá un adrès riba bo kabes i nos a manda un mensahe pa bo ora ku algu a kambia: tuma lugá òf paga salario. Webw ta di un manera alternativo pa cambia bo abilidad di skirbi, i esei ta duná bo e mésun informacion.

{
  "id": "whd_8Fk2mQxR7tLp",
  "type": "event.changed",
  "created_at": "2026-10-06T15:04:05.000Z",
  "mode": "live",
  "data": {
    "event": {
      "id": "ev_…",
      "name": "…",
      "status": "cancelled",
      "tickets": {
        "availability": "ended",
        "buy_url": "https://timtim.live/b/…"
      },
      "…": "the same event object as GET /v1/events"
    }
  }
}

Analisá tur mensahe: Bo ta firma e mensahe aki ku bo sekreto. Sin importá kico ta mas bieu cu cincu minuut, i ignorá un pemiy bou di tera, bo a trata caba.

// Node — Express with the RAW body (do not JSON.parse before checking)
import crypto from "node:crypto";

app.post("/timtim", express.raw({ type: "application/json" }), (req, res) => {
  const header = req.get("TimTim-Signature") ?? "";           // t=1700000000,v1=<hex>
  const parts = Object.fromEntries(header.split(",").map((p) => p.split("=")));
  const body = req.body.toString("utf8");
  const expected = crypto.createHmac("sha256", process.env.TIMTIM_WEBHOOK_SECRET)
    .update(`${parts.t}.${body}`).digest("hex");
  const fresh = Math.abs(Date.now() / 1000 - Number(parts.t)) <= 300;
  const same = expected.length === (parts.v1 ?? "").length &&
    crypto.timingSafeEqual(Buffer.from(expected), Buffer.from(parts.v1));
  if (!fresh || !same) return res.sendStatus(400);

  const message = JSON.parse(body);                            // { id, type, mode, data }
  if (alreadyHandled(req.get("TimTim-Delivery-Id"))) return res.sendStatus(200);
  // message.type === "event.changed"    → message.data.event
  // message.type === "earnings.changed" → message.data.earning
  res.sendStatus(200);
});

Kontesta kualke 2 sekònde. Si no ta asina, nos ta purba atrobe despues di 1 minuut, 5 minuut, 30 minuut, despues 2, 6, 12 pa 24 ora, caba stop. Nunka nos lo sigui e instrukshonnan di Yehova.

E Para di santu

E RELATO di prueba ta haña algun suseso ku ta karakterisá TESTTET NO TA EITETY. Habri un cos pa cumpra i cushiná test di Test Ticket, anto pidi bo salario. Silulá un pida - pida i wak e cai.

Ora algu bai malu

Personanan ta splika nan mes ku palabranan kla, ku un título i kiko pa hasi despues. Kada kontesta ta karga un míim- realvid. Manda é pa nos i nos por haña bo petishon.

401missing_keyPlease add your TimTim.Live key. Send it as: Authorization: Bearer tt_test_… — get a test key at /partners/dashboard.
401invalid_keyWe do not recognise that key. Check you copied the whole key, or make a new one at /partners/dashboard.
401revoked_keyThat key was switched off. Make a new key at /partners/dashboard.
403partner_inactiveThis partner account cannot use live keys right now. Your test key still works. Contact TimTim.Live partnerships to review the account.
403missing_scopeThis key is not allowed to do that. Earnings need a secret key (tt_sk_live_…) or a test key, used from your server.
403domain_not_allowedThis website is not allowed to use this key. Add the website to the key's allowed domains at /partners/dashboard.
400unknown_parameterWe do not know one of those parameters. See /partners/docs for the list.
400invalid_countryWe could not read that country. Use a two-letter code, for example country=US or country=FR.
400invalid_dateWe could not read that date. Dates look like 2026-10-20.
400invalid_changed_sinceWe could not read changed_since. Use a full time, for example changed_since=2026-10-06T10:00:00Z.
400invalid_booleanThat value must be true or false. For example commissioned=true.
400invalid_numberThat value must be a number. For example minimum_earnings=5.
400invalid_nearWe could not find that place. Try near=Paris,FR or city=Paris&country=FR.
400invalid_locationWe could not read that location. Send lat, lng and optionally radius in kilometres.
400invalid_limitlimit must be between 1 and 100. Leave it out to get 20.
400invalid_cursorThat cursor is not one we gave you. Use the `next` value from the previous page exactly as it came.
404event_not_foundWe could not find that event. It may have been removed, or it is not shared with partners.
403capability_requiredCard-linked offers are not switched on for your account. Offers are an enterprise feature. Your test key shows sample offers now; ask TimTim.Live partnerships to review your account for live offers.
403server_key_requiredThis is for your server only. Use a secret key (tt_sk_live_…) or a test key from your server, never a website key in a web page.
403commerce_not_enabledSelling tickets in your own app is not switched on for your account. This is an enterprise feature (EMBEDDED_CHECKOUT). Your test key can try it now; ask TimTim.Live partnerships to review your account. Until then, use each event's buy_url.
503checkout_not_openCard payments are not open on TimTim.Live yet. Send the buyer to the event's buy_url instead. Your test key can still rehearse orders.
409ticket_not_availableThat ticket cannot be bought right now. It may be sold out, not on sale yet, or no longer on sale. Ask /v1/events/{id}/tickets for what is on sale now.
400order_invalidWe could not read that order. See /partners/docs for the fields an order needs.
409idempotency_conflictThat Idempotency-Key was already used for a different order. Send exactly the same order to get the same answer back, or use a new Idempotency-Key for a new order.
400idempotency_key_requiredPlease send an Idempotency-Key header. 8 to 80 letters, digits, - or _. Send the same key again to retry safely — you will get the same order, never a second one.
404order_not_foundWe could not find that order. Only orders your company began with this kind of key (test or live) can be read here.
403bulk_not_enabledBulk feeds are not switched on for your account. This is an enterprise feature (BULK_FEEDS). Your test key can try it now; ask TimTim.Live partnerships to review your account. Until then, page through /v1/events or the feeds.
404bulk_not_foundWe could not find that bulk feed. Use the address shown on /partners/dashboard: /v1/bulk/<subscription id>.ndjson.gz or .csv.gz.
429bulk_too_soonA full file was made for this feed a few minutes ago. Full files can be made every 15 minutes. For what changed since, add changed_since=<time> — that is not limited.
410event_withdrawnThis event is no longer shared with partners. Stop showing it and remove its buy_url. Nothing else is needed — your old link still takes people to the event page.
400invalid_trackWe could not read that tracking signal. Send {"type":"impression"}, {"type":"event_view","event_id":"…"} or {"type":"event_click","event_id":"…"}. Sales are recorded by TimTim.Live, never sent from a page.
404not_foundThere is nothing at this address. The Partner API lives at /v1/events, /v1/events/{id}, /v1/offers and /v1/earnings.
405method_not_allowedThis address does not answer that method. The Allow header lists the methods it answers.
401key_in_urlSend your key in the Authorization header. Only /v1/feeds reads a key from the URL (?key=). Everywhere else use Authorization: Bearer <key> — keys in URLs end up in logs.
403ip_not_allowedThis key only works from your listed servers. Call from an address on the key's allowlist, or change the list at /partners/dashboard.
401certificate_requiredThis key needs your client certificate. Connect to https://api.timtim.live with the TLS client certificate pinned to this key.
401certificate_mismatchThat is not the certificate pinned to this key. Use the certificate whose SHA-256 is on your dashboard, or pin the new one there.
429rate_limitedToo many requests — please slow down. Wait the number of seconds in Retry-After, then try again.
503unavailableThe Partner API is resting for a moment. Please try again in a minute.
500server_errorSomething went wrong on our side. Please try again. If it keeps happening, send us your TimTim Request ID.

E kontrakt

E descripcion completo di tur campo, den e forma habrí di habrí bo hermentnan por lesa.

Down▁straightapi.yaml

Con bibu e yabinan ta habri

Bo prueba prinsipal ta funshoná mesora. Pa un persona biba clave, na TimTim.Live, wak bo nomber di compania, bo website i con lo bo mustra sucesonan. Bo ta mira e kontesta riba bo pregunta.

TimTim.Live APIing

Beibel na papiamentu koriente ta sigui krese. Nos ta agregá kosnan nobo. Nos no ta kita ni kambia loke tin einan kaba.

2026-10-08 — Te ainda tin un tipo di kontesta ku ta karga un piedra chikitu. Mandaé bek como si fuera bou di awa bou di awa, pa haña un tiki 304 florin ora nada no a cambia. In relashoná ku esei.
2026-10-08 — Awor Web site ta conta cada bishitante riba nan mes, di manera cu sitionan druk ta sigui traha. No tabatin mester di akshon.
2026-10-07 — Clite (mTL) ta habrí: pega bo documento na un clave riba bo cár. In relashoná ku esei. No tabatin mester di akshon.
2026-10-07 — Buk ta come: Tur suceso cu lo bo por mustra, den un fail, na Alcult /v01bulk. In relashoná ku esei. No tabatin mester di akshon.
2026-10-07 — API tin su mes adres: https: estudio ta sigui funcioná. No tabatin mester di akshon.
2026-10-06 — Bo mes a marca página na timanttim.▁living▁liveelingout. In relashoná ku esei. No tabatin mester di akshon.
2026-10-06 — Bo mes app riba karchi di propaganda: foeton /v1 ta manda mensahe pa bo ku ta indiká ku bo tin un bon relashon ku Dios. In relashoná ku esei. No tabatin mester di akshon.
2026-10-06 — Un página di státus público na / Encunners, a controlá cada minuut. No tabatin mester di akshon.
2026-10-06 — E deklarashonnan di e kompanianan ku ta hasi propaganda pa e kompanianan: fomt /v1 ku ta sali for di otro. No tabatin mester di akshon.
2026-10-06 — Post ta informá: Duna bo e idea ku e tin di haber ku un asuntu di kumpra kos i nos ta mand'é bèk pa bo via e benta. In relashoná ku esei. No tabatin mester di akshon.
2026-10-06 — Aven sí ta ofrecé programanan di banco i recompensa pa banco: seat /v1 florin. In relashoná ku esei. No tabatin mester di akshon.
2026-10-06 — Kalènder ta duna kuminda: /v1.81.6333.craus pa Kalènder Google, Kalènder i Fut. No tabatin mester di akshon.
2026-10-06 — Un clave pa esnan cu ta sirbi bo: IPlistanan awor, un bendedó di cliente (mTLS) riba apitimo. In relashoná ku esei. No tabatin mester di akshon.
2026-10-06 — OAth 2,0 dollar pa gran parti: P'e cantidad di hende por lo general /v1 tanuunten i /v1.v1.884uth▁Fatherrevoke. Pa nos por logra esei, nos mester hasi esfuerso pa sigui traha. No tabatin mester di akshon.
2026-10-06 — PalabraPressilin 1.0.0: un bloki, un simde i un página di circunstancia. E ta cambia su mes for di fitant.▁living. No tabatin mester di akshon.
2026-10-06 — Webitecede, JSON mericanoREKSXMECCCC i w.bhow (asta p'e entrada, p'esei bo ta gana e pan. No tabatin mester di akshon.
2026-10-06 — [ Plachi na página 14] No tabatin mester di akshon.