Katalog API

Tixvio'daki yaklaşan etkinlikler, mekanlar ve sanatçılar için herkese açık, ücretsiz ve salt okunur API.

Temel adres

Kurallar

Anahtar ya da kayıt gerekmez; API yalnızca okur (GET).
IP başına dakikada en çok 120 istek; aşılırsa 429 yanıtı ve Retry-After başlığı döner.
Yalnızca yayındaki, herkese açık listelenen gerçek etkinlikler: demo / test içerik, yalnızca bağlantıyla açılan ve satışı henüz açılmamış "yakında" etkinlikler yer almaz.
Fiyatlar para biriminin küçük biriminde tam sayıdır (kuruş / sent); saatler ISO 8601 (UTC), etkinlikler Europe/Istanbul saatindedir.
Yanıtlar en çok 5 dakika önbellekte kalabilir; bilet almak için kullanıcıyı her zaman etkinliğin url adresine yönlendir.
Reklam ve kişisel veri yoktur. Veriyi gösterirken Tixvio'yu kaynak olarak an ve etkinlik sayfasına bağlantı ver.

Uç noktalar

Yöntem	Yol	Açıklama
GET	`/api/public/v1/events`	Yaklaşan etkinlikler: q (arama), city, genre, from / to (YYYY-MM-DD), free=1, page, limit (en çok 50).
GET	`/api/public/v1/events/{slug}`	Etkinlik ayrıntısı: açıklama, mekan adresi ve konumu, organizatör ve bilet tipleri (teklifler).
GET	`/api/public/v1/venues`	Yaklaşan etkinliği olan mekanlar: q, city, page, limit.
GET	`/api/public/v1/venues/{slug}`	Mekan ayrıntısı ve yaklaşan etkinlikleri.
GET	`/api/public/v1/artists`	Yaklaşan etkinliği olan sanatçılar: q, genre, page, limit.
GET	`/api/public/v1/artists/{slug}`	Sanatçı ayrıntısı, resmi bağlantıları ve yaklaşan etkinlikleri.
GET	`/api/public/v1/feed.json`	Yaklaşan tüm etkinlikler bilet tipleriyle tek dosyada (en çok 1000, 10 dakikada bir yenilenir).
GET	`/api/public/v1/openapi.json`	OpenAPI 3.1 belgesi: tüm alanlar ve parametreler.

Örnek istek

İstanbul'daki yaklaşan beş techno etkinliği (yanıt kısaltılmıştır):

curl "https://tixvio.com/api/public/v1/events?city=%C4%B0stanbul&genre=Techno&limit=5"

{
  "page": 1,
  "hasMore": true,
  "events": [
    {
      "slug": "example-night",
      "url": "https://tixvio.com/e/example-night",
      "title": "Example Night",
      "startsAt": "2026-11-21T19:00:00.000Z",
      "timezone": "Europe/Istanbul",
      "city": "İstanbul",
      "genres": [
        "Techno"
      ],
      "status": "PUBLISHED",
      "saleMode": "ON_SALE",
      "currency": "TRY",
      "priceFrom": 45000,
      "soldOut": false,
      "venue": {
        "slug": "example-venue",
        "name": "Example Venue",
        "city": "İstanbul"
      }
    }
  ]
}

Yapay zeka asistanları ve arama motorları

llms.txt dosyası siteyi, katalog API bağlantılarını ve yaklaşan etkinlikleri yapay zeka asistanları için özetler. Etkinlik akışı ve OpenAPI belgesi de herkese açıktır; robots.txt bu adreslerin taranmasına izin verir.

Soru ya da iş birliği önerin mi var?Daha yüksek istek sınırı, ortak akış ya da entegrasyon için bize yaz.Bize ulaşın