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. 1. Lim inn kalenderlenken, uten koding. Outlook, Meetup, en ICS-lenke eller en nettside med arrangementer.
  2. 2. Bruk API-et hvis dere har et eget system eller en utvikler.
  3. 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

Vi bruker opplysningene bare til å svare dere og lage nøkkelen.

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.

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

FeltHva
idpåkrevdDeres egen faste id. Samme id oppdaterer i stedet for å lage nytt. Bokstaver, tall og . _ : @ + = - (maks 120).
tittelpåkrevdNavnet på arrangementet (3–120 tegn).
startpåkrevdISO 8601 med tidssone, f.eks. 2026-11-25T19:00:00+01:00. Uten sone leses tiden som norsk tid.
sluttvalgfrittSom start. Må være etter start.
stedpåkrevd*Navnet på stedet. *Kan sløyfes når adresse er med.
adressevalgfrittGate, postnummer og sted. Brukes til kartet og til å finne byen.
byvalgfrittEn 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.
beskrivelsevalgfrittRen tekst, maks 1500 tegn. HTML fjernes.
kategorivalgfrittmusic, theatre, art, film, talk, family, food, market, sports, outdoor, nightlife, workshop, shopping, business, social, motor, free. Ukjent kategori gjettes fra tittelen.
lenkepåkrevdSiden der arrangementet står hos dere (http/https).
billettlenkevalgfrittBillettsiden (http/https).
bildevalgfrittBilde-URL (http/https, helst https og 1200 × 630).
pris_fravalgfrittLaveste pris i kroner (0–100 000).
gratisvalgfritttrue eller false.
avlystvalgfritttrue 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

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:

  1. 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).
  2. Use the API: POST https://locl.no/api/v1/arrangementer with Authorization: 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 same id updates the event; avlyst: true or DELETE /api/v1/arrangementer/<id> cancels it. GET lists your events. See openapi.json. The first three events from a new organiser are reviewed before they are published (the response has the note venter_godkjenning), after that they go live immediately.
  3. 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).

Request a key

We only use this to reply to you and create the key.