Dette er API-dokumentasjon for Store norske leksikon (SNL), Store medisinske leksikon (SML) og Norsk biografisk leksikon (NBL). Alle verkene er publisert av Foreningen Store norske leksikon.
API-dokumentasjon
Artikler
Alle artikler finnes i .json format. Legg på .json på slutten av URLen til artikkelen, f.eks. https://snl.no/Norge.json
Artikkelsøk
https://[subdomene].snl.no/api/v1/search?query=[søkefrase]&[parameter]
| Parameter | Forklaring |
|---|---|
| query | Påkrevd. Spørreord, f.eks. "Tog", "Edvard Munch" |
| limit | Ikke påkrevd. Maks. antall resultater, 1-10 er gyldige verdier, standard er 3 |
| offset | Ikke påkrevd. Brukes til å vise neste "side" med resultater, default er 0, inkrementer med verdien du satte i limit |
Søkeresultater
| Resultatfelt | Forklaring |
|---|---|
| article_id | Artikkelens ID-nummer. |
| article_type_id | 1: Vanlig artikkel, 2: Biografi, 3: Landartikkel, etc.... |
| clarification | Presiseringsfelt for tittel |
| encyclopedia_id | Angir hvilket verk artikkelen tilhører. 1: SNL, (2: Meta,) 3: SML, 4: NBL |
| headword | Artikkelens tittel, eksklusive presisering. |
| permalink | Navnet som brukes i artikkelens URL |
| rank | Søkeresultat-rangeringstall. Bestemmes av hvor mange ganger søkeordet forekommer i artikkelen. Får bonuspoeng for perfekt treff i headword og i headword+clarification. |
| snippet | Utdrag fra første sted i artikkelen hvor søkefrasen forekommer. |
| taxonomy_id | ID-nummer for kategori i leksikonet. Kategoriene er tilgjengelige på https://[subdomene].snl.no/.taxonomy/[taxonomy_id] |
| taxonomy_title | Navnet på kategorien artikkelen ligger i. |
| article_url | URL til vanlig visning av artikkelen. |
| article_url_json | URL til json-representasjon av artikkelen. |
| title | Artikkelens fulle tittel. |
| license | Artikkelens lisens. Lisensen gjelder selve artikkelteksten og kan være begrenset eller fri. |
| first_image_url: | Lenke til artikkelens øverste bilde, hvis det finnes. |
| first_image_license | Lisens for artikkelens øverste bilde. |
| first_two_sentences | Utdrag av artikkelens to første setninger. |
Eksempler på søk
- https://snl.no/api/v1/search?query=Tog&limit=5&offset=0
- https://nbl.snl.no/api/v1/search?query=petter%20dass
- https://sml.snl.no/api/v1/search?query=cellen
Generelt om lisenser
Artikler
Lisens på artikler er oppgitt i .json
Faktaboks
Lisens på innholdet i metadata/faktaboks er alltid fri.
Bilder
Lisens på bilder er oppgitt i .json
Kontakt
Tips
Tips oss gjerne om har forslag til utvidelser eller endringer av APIet. Teknisk kontakt er redaksjonen@snl.no