Send arrangementene deres til Locl
Locl viser hva som skjer i norske byer. Arrangerer dere noe, kan arrangementene komme med automatisk, og endringer og avlysninger følger etter av seg selv. Det er gratis. Velg den veien som passer:
- 1. Lim inn kalenderlenken, uten koding. Outlook, Meetup, en ICS-lenke eller en nettside med arrangementer.
- 2. Bruk API-et hvis dere har et eget system eller en utvikler.
- 3. Legg inn for hånd, ett og ett arrangement.
Slik får dere nøkkel
Vei 1 og 2 krever en invitasjon fra Locl. Fyll ut skjemaet under, eller skriv til hei@locl.no med navnet på arrangøren og nettsiden deres, så får dere en invitasjonslenke, vanligvis innen ett døgn. Lenken åpner «Legg til arrangement» der dere kan koble til kalenderen, og koden i lenken (etter invitasjon=) er API-nøkkelen. Den gjelder i 90 dager. Hold den hemmelig. På samme side kan dere lage egne nøkler (locl_…) som gjelder i ett år og kan trekkes tilbake når som helst, for eksempel én per system.
Be om nøkkel
1. Lim inn kalenderlenken
Åpne invitasjonslenken, lim inn lenken under «Koble til kalenderen», trykk Test lenken og se de fem første arrangementene. Ser det riktig ut, trykker dere Lagre. Locl henter kalenderen hver natt.
- Outlook: Innstillinger → Kalender → Delte kalendere → Publiser en kalender → ICS-lenken.
- Meetup:
https://www.meetup.com/<gruppa-deres>/events/ical/ - Nettside: en side med arrangementene merket med schema.org/Event (JSON-LD). Mange billett- og nettsidesystemer gjør det allerede.
- Google Kalender: gjør kalenderen offentlig, og lim inn «Offentlig adresse i iCal-format» (slutter på basic.ics) fra kalenderinnstillingene.
Vi følger robots.txt, henter bare offentlige adresser og bruker samme regler som API-et: samme arrangement oppdateres, og avlyste (STATUS:CANCELLED i kalenderen) merkes «Avlyst». Arrangementer uten klokkeslett kommer ikke med.
2. API-et
Send ett arrangement eller en liste (maks 100 per kall) med nøkkelen i Authorization-headeren. Sender dere samme id igjen, oppdateres arrangementet. Det blir aldri dubletter. Full beskrivelse: openapi.json.
De tre første arrangementene fra en ny arrangør ser vi over før de publiseres. Svaret har da merknaden venter_godkjenning. Etter det publiseres de med en gang. Det gjelder både API-et og kalenderlenken.
curl -X POST https://locl.no/api/v1/arrangementer \
-H "Authorization: Bearer DIN_NØKKEL" \
-H "Content-Type: application/json" \
-d '{"id":"quiz-2026-11-25","tittel":"Quiz på Løkka","start":"2026-11-25T19:00:00+01:00","slutt":"2026-11-25T21:00:00+01:00","sted":"Bar Boca","adresse":"Thorvald Meyers gate 30, 0555 Oslo","by":"oslo","beskrivelse":"Pubquiz med seks runder. Lag på opptil seks.","kategori":"social","lenke":"https://eksempel.no/quiz","billettlenke":"https://eksempel.no/quiz/billett","bilde":"https://eksempel.no/quiz.jpg","pris_fra":0,"gratis":true}'Svaret har én linje per arrangement med status opprettet, oppdatert, uendret, avlyst eller avvist (med grunn på norsk og engelsk), og adressen på Locl:
{
"ok": true,
"oppsummering": {
"opprettet": 1
},
"resultat": [
{
"id": "quiz-2026-11-25",
"status": "opprettet",
"url": "https://locl.no/event/quiz-pa-lokka-1x2y3z"
}
],
"grense": {
"per_dogn": 300,
"igjen": 299
}
}Feltene
| Felt | Hva | |
|---|---|---|
| id | påkrevd | Deres egen faste id. Samme id oppdaterer i stedet for å lage nytt. Bokstaver, tall og . _ : @ + = - (maks 120). |
| tittel | påkrevd | Navnet på arrangementet (3–120 tegn). |
| start | påkrevd | ISO 8601 med tidssone, f.eks. 2026-11-25T19:00:00+01:00. Uten sone leses tiden som norsk tid. |
| slutt | valgfritt | Som start. Må være etter start. |
| sted | påkrevd* | Navnet på stedet. *Kan sløyfes når adresse er med. |
| adresse | valgfritt | Gate, postnummer og sted. Brukes til kartet og til å finne byen. |
| by | valgfritt | En av byene på Locl: oslo, bergen, trondheim, stavanger, tromso, alesund, geiranger, lofoten, roros, flam, kristiansand, baerum, asker, lillestrom, drammen, stjordal, elverum, haugesund, sarpsborg, fredrikstad, tonsberg. Ellers finner vi byen fra adressen. |
| beskrivelse | valgfritt | Ren tekst, maks 1500 tegn. HTML fjernes. |
| kategori | valgfritt | music, theatre, art, film, talk, family, food, market, sports, outdoor, nightlife, workshop, shopping, business, social, motor, free. Ukjent kategori gjettes fra tittelen. |
| lenke | påkrevd | Siden der arrangementet står hos dere (http/https). |
| billettlenke | valgfritt | Billettsiden (http/https). |
| bilde | valgfritt | Bilde-URL (http/https, helst https og 1200 × 630). |
| pris_fra | valgfritt | Laveste pris i kroner (0–100 000). |
| gratis | valgfritt | true eller false. |
| avlyst | valgfritt | true avlyser, false gjenoppretter. Uten feltet står en tidligere avlysning. |
Har dere schema.org/Event allerede?
Send JSON-LD-en rett inn (name, startDate, location, offers, eventStatus …), ett objekt, en liste eller @graph. Gi gjerne identifier; ellers bruker vi lenken og starttiden som id.
Flere kall
GET /api/v1/arrangementerlister arrangementene deres (med?fra=2026-11-01for eldre).DELETE /api/v1/arrangementer/<id>avlyser. Siden står med «Avlyst», ingenting slettes.- Grense: 300 nye eller endrede arrangementer per døgn og 60 kall per minutt. Uendrede teller ikke.
- Feil eller tilbaketrukket nøkkel gir 401, utløpt nøkkel 403. Alle feil har
melding(norsk) ogmessage(engelsk).
Alle feilkoder
ikke_objekt: Hvert arrangement må være et JSON-objekt.id_mangler: Mangler «id»: deres egen faste id for arrangementet.id_ugyldig: «id» kan bare ha bokstaver, tall og . _ : @ + = - (maks 120 tegn).id_dublett: Samme «id» står flere ganger i forespørselen. Bare den første ble brukt.tittel: «tittel» må ha minst 3 tegn.persondata: Feltet ser ut til å inneholde e-post eller telefonnummer. Det blir offentlig, så det er ikke lov.start_mangler: Mangler «start».tid: Tiden må være ISO 8601, f.eks. 2026-11-20T19:30:00+01:00.bare_dato: Tiden mangler klokkeslett. Locl gjetter ikke klokkeslett.fortid: Arrangementet har allerede startet.forlangt: Arrangementet er mer enn ett år fram i tid.slutt_for_start: «slutt» må være etter «start».for_langt: Arrangementet kan vare høyst 60 dager.sted: Mangler «sted» (navnet på stedet) eller «adresse».by: Ukjent by. Bruk en av byene på locl.no (f.eks. oslo, bergen, trondheim), eller oppgi en adresse vi finner.by_velg: Kalenderen sier ikke hvilken by. Velg by over.lenke_mangler: Mangler «lenke»: siden der arrangementet står hos dere.lenke: Lenken må være en http(s)-adresse.bilde: Bildet må være en http(s)-adresse.pris: «pris_fra» må være et tall fra 0 til 100 000.boolsk: Feltet må være true eller false.ukjent_avlysning: Arrangementet finnes ikke hos Locl, så det er ingenting å avlyse.tatt_ned: Locl har tatt ned dette arrangementet. Skriv til hei@locl.no hvis det er feil.grense: Grensen per døgn er nådd. Prøv igjen i morgen, eller skriv til hei@locl.no.lagring: Klarte ikke å lagre. Prøv igjen senere.
3. Legg inn for hånd
Ett og ett arrangement på Legg til arrangement. Med invitasjon publiseres det med en gang; ellers ser vi over det først, vanligvis innen ett døgn.
Regler
Det dere sender, blir offentlig på locl.no med lenke tilbake til dere. Ikke send personopplysninger (e-post eller telefonnummer i tittel eller sted stoppes). Bruk bilder dere har rett til å dele. Vi kan ta ned arrangementer som bryter vilkårene.
In English: send your events to Locl
Locl shows what is on in Norwegian towns. Three ways in, all free:
- Paste your calendar link (ICS/iCal from Outlook or Meetup, or a web page with schema.org/Event). Locl fetches it every night. Google Calendar: paste the "Public address in iCal format" (ends in basic.ics).
- Use the API:
POST https://locl.no/api/v1/arrangementerwithAuthorization: Bearer <key>. One event or a list (max 100). Field names are Norwegian (see the table above), or send schema.org/Event JSON-LD as is. The sameidupdates the event;avlyst: trueorDELETE /api/v1/arrangementer/<id>cancels it.GETlists your events. See openapi.json. The first three events from a new organiser are reviewed before they are published (the response has the noteventer_godkjenning), after that they go live immediately. - Add events by hand on Add an event.
To get a key, use the form below or write to hei@locl.no with your organisation and website. You get an invitation link; the code after invitasjon= is your API key (valid 90 days). On the same page you can create personal keys (locl_…), valid for one year and revocable at any time. Limits: 300 new or changed events per day, 60 requests per minute. Errors return 401 (invalid key), 403 (expired key), 422 (validation, with message in English per field) or 429 (limit).