Forritaskil · API v2

Gögn Kvikmyndir.is fyrir þitt verkefni

Kvikmyndir, sýningatímar í íslenskum bíóum, væntanlegar myndir, leikarar og listar — í gegnum einföld JSON-forritaskil. Ókeypis fyrir verkefni sem vísa á okkur til baka.

16.344 kvikmyndir 1.484 þáttaraðir 175.853 leikarar og aðstandendur 67 sýningar í dag

Byrjaðu á tíu sekúndum

JSONRESTOpenAPI 3CORS opiðETag

Sendu lykilinn í Authorization-haus. Öll svör eru JSON í sama formi: {"data": …, "meta": …} eða {"error": {…}}.

curlcurl -H "Authorization: Bearer DINN_LYKILL" \
  "https://kvikmyndir.is/api/v2/showtimes?offset=0"
JavaScriptconst res = await fetch("https://kvikmyndir.is/api/v2/movies?per_page=10", {
  headers: { Authorization: "Bearer DINN_LYKILL" }
});
const { data, meta } = await res.json();

Hvað er í boði

Öll skjölun →

Kvikmyndir og þættir

/movies

Leit og síur eftir ári, flokki og tegund. Leikarar, stiklur og svipaðar myndir.

16.344 myndir · 1.484 þáttaraðir

Sýningatímar

/showtimes

Allir sýningatímar dagsins, eða næstu daga, með sal, tungumáli og miðakaupaslóð.

67 sýningar á 20 myndum í dag

Streymi á Íslandi

/streaming · /streaming/new · /streaming/leaving

Hvað er á Netflix, Disney+, Prime, Apple TV+, Símanum, SÝN og RÚV — nýkomið, á förum og hvar hver titill er.

7.641 titlar á streymi

Sjónvarpsþættir

/series/{id} · /episodes/upcoming

Þáttaraðir, seríur og útsendingardagar þátta — TheTVDB og RÚV sameinað í eitt dagatal.

1.484 þáttaraðir

Væntanlegt

/upcoming

Myndir á leið í bíó, raðað eftir frumsýningardegi.

69 væntanlegar

Fólk

/persons/{id}

Leikarar, leikstjórar og aðrir aðstandendur ásamt kvikmyndaskrá.

175.853 einstaklingar

Bíó og flokkar

/theaters · /genres

Bíóhúsin og kvikmyndaflokkar á íslensku og ensku.

6 bíó · 47 flokkar

Listar og leit

/lists · /search

Sérvaldir listar ritstjórnar og hröð titlaleit.

Notandagögn

/me/*

„Langar að sjá“, „hef séð“, einkunnir og umsagnir — með leyfi notandans.

Fleira er á leiðinni: sýningatímar eftir bíói og mynd, umsagnir og fréttir. Skjölunin er líka til sem OpenAPI.

Svona lítur svar út

Sjá myndasíðuna →

Raunverulegt svar fyrir myndina sem er oftast á tjaldinu í dag (stytt lýsing):

GET /movies/18046{
    "data": {
        "id": 18046,
        "title": "The Hunger Games: Sunrise on the Reaping",
        "alternativeTitles": "The Hunger Games 6",
        "year": 2026,
        "poster": "https://kvikmyndir.is/images/poster/18046_500.jpg",
        "plot": "Myndin gerist 24 árum fyrir atburði fyrstu Hungurleikamyndarinnar, og hefst morguninn fyrir fimmtugustu hungurleikana. Meðal keppenda er Hay…",
        "imdb": "32558705",
        "imdb_rating": "7.7",
        "runtime": 150,
        "tv_show": 0,
        "is_icelandic": 0,
        "genres": [
            "Spenna",
            "Ævintýri"
        ]
    }
}

Bættu við ?expand=cast,trailer,streaming,similar til að fá leikara, stiklu, streymi og svipaðar myndir í sama svari.

Tvær leiðir að lykli

Persónulegur lykill

60 / mín · 10.000 / dag

  • Strax, án umsóknar
  • Fyrir eigin verkefni og prófanir
  • Veitir líka aðgang að þínum eigin listum (/me)
Skráðu þig inn til að búa til

Reglurnar

  1. Getið heimilda. Merktu gögnin „Kvikmyndir.is“ og tengdu á myndasíðuna (https://kvikmyndir.is/mynd/?id=<id>) þar sem það á við.
  2. Geymdu svörin í skyndiminni. Notaðu ETag / If-None-Match og ekki sækja sama gagnið oftar en þarf. Mörkin sjást í X-RateLimit-*-hausum.
  3. Ekki endurselja gögnin eða setja upp afrit af gagnagrunninum.
  4. Haltu lyklinum leyndum. Ef hann lekur, gerðu hann óvirkan og fáðu nýjan.
  5. Án ábyrgðar. Forritaskilin eru veitt eins og þau eru. Við getum breytt mörkum eða afturkallað lykla sem eru misnotaðir.

Sækja um samstarfslykil

Með því að sækja um samþykkir þú reglurnar hér fyrir ofan.
Spurningar eða hugmyndir? Sendu okkur línu — við heyrum gjarnan hvað þú ert að smíða.
kvikmyndir@kvikmyndir.is