Produkt- og butikkdata fra Vinmonopolet
Her finner du informasjon om hvordan du kan hente data fra Vinmonopolet for bruk i egne tjenester.
API-portalen er en tjeneste fra Vinmonopolet: API-portalen.
Vinmonopolet deler ikke butikkdata eller produktdata ved hjelp av csv-filer.
Alle aktører som ønsker API-tilgang, må godta betingelsene beskrevet i Vinmonopolets API - Terms of service.
Vinmonopolets åpne API-tjeneste
Vinmonopolet har fra 10. oktober 2024 gjort presiseringer i hvem som har tilgang til såkalt «detaljert produktinformasjon»:
Aktører som ønsker tilgang til Vinmonopolets åpne API trenger ikke søke om tilgang. Du må først registrere deg i API-portalen og deretter subscribe til «product» kalt «Open»
«Open» inneholder APIene:
Products-APIet inkluderer operasjonene:
- Get details-normal
- Halvårlig salg i liter per butikk per varegruppe
- Salg i antall og liter pr artikkel per fullførte måned
Vinmonopolets presse-API
Aktører som ønsker tilgang til presse-API, må søke via e-post. Merk e-posten med «Søknad ny presse API-tjeneste».
Fyll inn:
- Firmanavn og organisasjonsnummer
- API-brukernavn (fornavn, etternavn) og
- E-postadresse som vil benyttes i API-portalen.
Send til presse@vinmonopolet.no.
Presse-APIet som gir detaljert produktinformasjon er et begrenset tilbud fra Vinmonopolet til aktører i pressen og aktører som jobber med pressen. Alle som ønsker tilgang, må i den skriftlige søknaden dokumentere et reelt behov for opplysningene i pressesammenheng. Basert på dette vil Vinmonopolet foreta en konkret vurdering i hvert enkelt tilfelle på om det er grunnlag for å gi tilgang til presse-APIet eller ikke.
Vinmonopolets lukkede API-tjeneste
Grossister og deres samarbeidspartnere i verdikjeden som ønsker tilgang til Vinmonopolets lukkede API trenger ikke søke om tilgang, men må registrere seg i API-portalen og subscribe til «product» kalt «Restricted»
Grossister kan dele api-data om sine produkter ved å gi fullmakter til samarbeidspartnere i verdikjeden: Autorisasjonshåndtering
Innsyn
Vinmonopolets virksomhet er underlagt Offentleglova. Utgangspunktet er derfor at alle kan kreve innsyn i saksdokumenter, journaler og lignende register. Det samme gjelder innholdet i databaser som enkelt kan sammenstilles. Innsynsretten gjelder likevel ikke for opplysninger som er unntatt i medhold av lov eller forskrift med hjemmel i lov.
Vinmonopolet anser at det er risiko for misbruk av dataene tilgjengelig via API, ved at disse kan benyttes på en måte som motvirker eller er til fare for det offentlige kontrolltiltaket AS Vinmonopolet utgjør for salg av alkohol i klasse 2 og 3, jf. Offentleglova §24 første ledd. Der det anses som nødvendig å begrense innsynet for å forhindre dette vil innsyn derfor nektes eller utsettes. Det vil bli foretatt en konkret vurdering i hvert enkelt tilfelle.
Alle som vil ha innsyn må begrunne hvorfor de har et saklig behov for innsyn, og samtidig redegjøre for hva opplysningene skal brukes til og hvordan de skal brukes. Dersom hele eller deler av opplysningene som det begjæres innsyn i skal publiseres må det redegjøres nærmere for hvilke opplysninger dette gjelder og hvordan publiseringen vil skje. Basert på dette vil Vinmonopolet foreta en konkret vurdering i hvert enkelt tilfelle på om det er grunnlag for å begrense eller utsette innsyn, eller ikke.
Spørsmål
- Har du tekniske spørsmål knyttet til våre API-tjenester, ta kontakt med: api@vinmonopolet.no
- For spørsmål relatert til datainnhold i de ulike api-tjenestene (som ikke fremgår av specs i API-portalen), ta kontakt med: kundesenter@vinmonopolet.no
- For mer generelle spørsmål om API-tjenestene til Vinmonopolet, ta kontakt med: presse@vinmonopolet.no
Sist oppdatert: