Forritaskil · API v2

Gögn Kvikmyndir.is fyrir þitt verkefni

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

Fá lykil Skjölun

Byrjaðu á tíu sekúndum

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

curl -H "Authorization: Bearer DINN_LYKILL" \
  "https://kvikmyndir.is/api/v2/showtimes?offset=0"

const 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

Kvikmyndir

/movies, /movies/{id} — leit, síur, leikarar, stiklur, streymi og svipaðar myndir.

Sýningatímar

/showtimes — allir sýningatímar dagsins (eða næstu daga) í íslenskum bíóum.

Væntanlegt

/upcoming — myndir á leið í bíó með frumsýningardögum.

Fólk

/persons/{id} — leikarar og aðstandendur.

Bíó og flokkar

/theaters, /genres — bíóhús og kvikmyndaflokkar.

Listar og leit

/lists, /search — sérvaldir listar og titlaleit.

Notandagögn

/me/* — „langar að sjá“, „hef séð“, einkunnir og umsagnir notanda.

Fleira er á leiðinni: streymisveitur, sjónvarpsþættir, umsagnir og fréttir. Nákvæm lýsing á öllum endapunktum er í skjöluninni (líka sem OpenAPI).

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

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

Sækja um

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-Match og 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.
Forritaskilin eru veitt eins og þau eru, án ábyrgðar um uppitíma. Við getum breytt mörkum eða afturkallað lykla sem eru misnotaðir.

Sækja um samstarfslykil

Spurningar? Sendu línu á kvikmyndir@kvikmyndir.is.