Produkt- og butikkdata fra Vinmonopolet

Vinmonopolet deler ikke lengre butikkdata eller produktdata ved hjelp av csv-filer. 

API-portalen er en tjeneste fra Vinmonopolet. Den er tilgjengelig her: https://api.vinmonopolet.no/ 

Alle aktører som ønsker API-tilgang, må godta betingelsene beskrevet i Vinmonopolets Terms of service. De er tilgjengelig i pdf-format her: https://api.vinmonopolet.no/terms-of-service.

Vinmonopolet har i lengre tid delt ulike data om varer i produktutvalgene gjennom API-portalen. Vinmonopolet vil fra 10. oktober 2024 gjøre presiseringer i hvem som har tilgang til såkalt «detaljert produktinformasjon». Les detaljer i avsnittene under. 

Vinmonopolets åpne API-tjeneste 

De aktørene 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» her: https://api.vinmonopolet.no/product#product=open 

«Open» inneholder APIene: 

• products - v0 
• stores - v0 

Førstnevnte API 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 

De aktørene som ønsker tilgang til presse-API, må søke om dette. Dette gjøres ved å sende en e-post med søknad til oss merket «Søknad ny presse API-tjeneste», sendt til [email protected]. Fyll inn firmanavn og organisasjonsnummer, samt API-brukernavn (fornavn, etternavn) og e-postadresse som vil benyttes i API-portalen. 

Presse-API’et 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-API et eller ikke.

Vinmonopolets lukkede API-tjeneste 

De aktørene (grossister og deres samarbeidspartnere i verdikjeden) som ønsker tilgang til Vinmonopolets lukkede API trenger ikke søke om tilgang, men må først registrere seg i API-portalen og deretter subscribe til «product» kalt «Restricted» her: https://api.vinmonopolet.no/product#product=restricted 

Les om hvordan grossister kan dele api-data om sine produkter ved å gi fullmakter til samarbeidspartnere i verdikjeden her: https://api.vinmonopolet.no/blog/authorization-management 

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: [email protected] 
• For spørsmål relatert til datainnhold i de ulike api-tjenestene (som ikke fremgår av specs i API-portalen), ta kontakt med: [email protected] 
• For mer generelle spørsmål om API-tjenestene til Vinmonopolet, ta kontakt med: [email protected]