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.
Byrjaðu á tíu sekúndum
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.233 myndir · 1.383 þáttaraðirSýningatímar
/showtimes
Allir sýningatímar dagsins, eða næstu daga, með sal, tungumáli og miðakaupaslóð.
97 sýningar á 26 myndum í dagStreymi á Í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.
5.221 titlar á streymiSjónvarpsþættir
/series/{id} · /episodes/upcoming
Þáttaraðir, seríur og útsendingardagar þátta — TheTVDB og RÚV sameinað í eitt dagatal.
1.383 þáttaraðirVæntanlegt
/upcoming
Myndir á leið í bíó, raðað eftir frumsýningardegi.
78 væntanlegarFólk
/persons/{id}
Leikarar, leikstjórar og aðrir aðstandendur ásamt kvikmyndaskrá.
170.278 einstaklingarBíó og flokkar
/theaters · /genres
Bíóhúsin og kvikmyndaflokkar á íslensku og ensku.
5 bíó · 37 flokkarListar 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/18822{
"data": {
"id": 18822,
"title": "Coyote vs. Acme",
"alternativeTitles": "",
"year": 2026,
"poster": "https://kvikmyndir.is/images/poster/18822_500.jpg",
"plot": "Eftir að Acme-vörur bregðast honum í eitt skiptið enn í endalausum eltingarleik hans við Roadrunner, ákveður Wile E. Coyote að ráða auglýsin…",
"imdb": "1756855",
"imdb_rating": null,
"runtime": 103,
"tv_show": 0,
"is_icelandic": 0,
"genres": [
"Gaman",
"Ævintýri",
"Fjölskylda"
]
}
}
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)
Samstarfslykill
Hærri mörk eftir þörfum
- Fyrir öpp, vefi og fyrirtæki
- Veittur eftir umsókn hér fyrir neðan
- Beint samband ef eitthvað breytist
Reglurnar
- Getið heimilda. Merktu gögnin „Kvikmyndir.is“ og tengdu á myndasíðuna
(
https://kvikmyndir.is/mynd/?id=<id>) þar sem það á við. - Geymdu svörin í skyndiminni. Notaðu
ETag/If-None-Matchog ekki sækja sama gagnið oftar en þarf. Mörkin sjást íX-RateLimit-*-hausum. - Ekki endurselja gögnin eða setja upp afrit af gagnagrunninum.
- Haltu lyklinum leyndum. Ef hann lekur, gerðu hann óvirkan og fáðu nýjan.
- Án ábyrgðar. Forritaskilin eru veitt eins og þau eru. Við getum breytt mörkum eða afturkallað lykla sem eru misnotaðir.