{"openapi":"3.1.0","info":{"title":"Festarikartta API","version":"1.0.0","description":"Suomen musiikkifestivaalit ja niiden esiintyjät. Vain luku, ei avainta. Vastaukset ovat välimuistissa 1–5 minuuttia. Public read-only API for music festivals in Finland and their line-ups. Please link back to the festival page (pageUrl) when citing.","contact":{"url":"https://festarikartta.fi"}},"servers":[{"url":"https://festarikartta.fi"}],"paths":{"/api/festivals":{"get":{"operationId":"listFestivals","summary":"Festarit (oletuksena tulevat ja käynnissä olevat)","parameters":[{"name":"kind","in":"query","description":"Festivaalityyppi. Tyhjä = kaikki tyypit","schema":{"type":"string","enum":["musiikki","ruoka","elokuva","joulumarkkinat"]}},{"name":"city","in":"query","description":"Kaupunki, esim. Tampere tai tampere","schema":{"type":"string"}},{"name":"genre","in":"query","description":"Genre, esim. rock","schema":{"type":"string"}},{"name":"from","in":"query","description":"Festarit, jotka päättyvät tänä päivänä tai myöhemmin (YYYY-MM-DD). Aiempi päivä palauttaa myös menneitä.","schema":{"type":"string","format":"date","example":"2027-07-10"}},{"name":"to","in":"query","description":"Festarit, jotka alkavat viimeistään tänä päivänä (YYYY-MM-DD)","schema":{"type":"string","format":"date","example":"2027-07-10"}},{"name":"artist","in":"query","description":"Artistin slug (ks. /api/artists): festarit, joilla artisti esiintyy","schema":{"type":"string"}}],"responses":{"200":{"description":"Festarit alkupäivän mukaan","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FestivalList"}}}},"400":{"description":"Virheellinen parametri","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/festivals/{slug}":{"get":{"operationId":"getFestival","summary":"Festarin tiedot, esiintyjät ja mediamaininnat","parameters":[{"name":"slug","in":"path","required":true,"description":"Festarin slug, esim. ruisrock-2027","schema":{"type":"string"}}],"responses":{"200":{"description":"Festari","content":{"application/json":{"schema":{"$ref":"#/components/schemas/FestivalDetail"}}}},"404":{"description":"Ei löytynyt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/artists":{"get":{"operationId":"listArtists","summary":"Artistit, joilla on festarikeikkoja","parameters":[{"name":"q","in":"query","description":"Hae nimellä","schema":{"type":"string"}},{"name":"upcoming","in":"query","description":"true = vain artistit, joilla on tuleva keikka","schema":{"type":"string","enum":["true","false"]}}],"responses":{"200":{"description":"Artistit aakkosjärjestyksessä","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtistList"}}}},"400":{"description":"Virheellinen parametri","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}},"/api/artists/{slug}":{"get":{"operationId":"getArtist","summary":"Artistin tulevat ja menneet festarikeikat","parameters":[{"name":"slug","in":"path","required":true,"description":"Artistin slug","schema":{"type":"string"}}],"responses":{"200":{"description":"Artisti","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArtistDetail"}}}},"404":{"description":"Ei löytynyt","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}},"components":{"schemas":{"Error":{"type":"object","properties":{"error":{"type":"string"}},"required":["error"]},"Festival":{"type":"object","properties":{"id":{"type":"integer"},"slug":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["musiikki","ruoka","elokuva","joulumarkkinat"],"description":"Festivaalityyppi: musiikki, ruoka, elokuva tai joulumarkkinat"},"startDate":{"type":"string","format":"date","example":"2027-07-10"},"endDate":{"type":"string","format":"date","example":"2027-07-10"},"dateText":{"type":"string","description":"Suomalainen muoto, esim. 10.–12.7.2027"},"city":{"type":["string","null"]},"venue":{"type":["string","null"]},"lat":{"type":"number"},"lng":{"type":"number"},"genres":{"type":"array","items":{"type":"string"},"description":"Musiikissa genret, muissa tyypeissä teemat tai lajityypit"},"url":{"type":["string","null"],"description":"Festivaalin omat sivut"},"ticketUrl":{"type":["string","null"],"description":"Lippukauppa"},"priceText":{"type":["string","null"]},"featured":{"type":"boolean","description":"Maksettu nosto"},"pageUrl":{"type":"string","description":"Festarin sivu Festarikartassa"}},"required":["slug","name","startDate","endDate","pageUrl"]},"FestivalList":{"type":"object","properties":{"today":{"type":"string","format":"date","example":"2027-07-10"},"count":{"type":"integer"},"festivals":{"type":"array","items":{"$ref":"#/components/schemas/Festival"}}}},"Mention":{"type":"object","description":"Linkki artikkeliin. Vain otsikko, lähde ja päivä; lue artikkeli alkuperäisestä lähteestä.","properties":{"title":{"type":"string"},"source":{"type":"string","example":"hs.fi"},"sourceName":{"type":"string"},"url":{"type":"string"},"publishedOn":{"type":["string","null"],"format":"date"}}},"FestivalDetail":{"type":"object","properties":{"festival":{"allOf":[{"$ref":"#/components/schemas/Festival"},{"type":"object","properties":{"description":{"type":["string","null"]},"summary":{"type":"string","description":"Faktatiivistelmä lauseina"},"isPast":{"type":"boolean"}}}]},"performers":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["group","person"]},"performsOn":{"type":["string","null"],"format":"date"},"pageUrl":{"type":"string"}}}},"media":{"type":"array","items":{"$ref":"#/components/schemas/Mention"}}}},"ArtistList":{"type":"object","properties":{"count":{"type":"integer"},"artists":{"type":"array","items":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["group","person"]},"pageUrl":{"type":"string"},"upcomingCount":{"type":"integer"},"next":{"type":["object","null"],"properties":{"date":{"type":"string","format":"date","example":"2027-07-10"},"festival":{"type":"string"},"city":{"type":["string","null"]}}}}}}}},"Performance":{"type":"object","properties":{"festival":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"pageUrl":{"type":"string"},"startDate":{"type":"string","format":"date","example":"2027-07-10"},"endDate":{"type":"string","format":"date","example":"2027-07-10"}}},"performsOn":{"type":["string","null"],"format":"date","description":"Esiintymispäivä, jos tiedossa"},"dateText":{"type":"string"},"city":{"type":["string","null"]},"venue":{"type":["string","null"]},"lat":{"type":["number","null"]},"lng":{"type":["number","null"]},"ticketUrl":{"type":["string","null"]}}},"ArtistDetail":{"type":"object","properties":{"artist":{"type":"object","properties":{"slug":{"type":"string"},"name":{"type":"string"},"kind":{"type":"string","enum":["group","person"]},"description":{"type":["string","null"]},"url":{"type":["string","null"]},"links":{"type":"array","items":{"type":"string"}},"pageUrl":{"type":"string"},"summary":{"type":"string"}}},"upcoming":{"type":"array","items":{"$ref":"#/components/schemas/Performance"}},"past":{"type":"array","items":{"$ref":"#/components/schemas/Performance"}},"media":{"type":"array","items":{"$ref":"#/components/schemas/Mention"}}}}}}}