GerviGrein English

Forritaskil

Síðast uppfært 2. október 2026

GerviGrein býður opin forritaskil (API) til að fletta upp GG-skori fréttar og biðja um að frétt verði metin. Hvorki þarf lykil né skráningu. Vafraviðbót GerviGreinar notar sömu forritaskil.

  • Grunnslóð: https://gervigrein.is. Aðeins HTTPS.
  • Svör eru JSON (UTF-8).
  • Fylgst er með tíu miðlum: ruv.is, mbl.is, visir.is, dv.is, heimildin.is, vb.is, nutiminn.is, mannlif.is, frettatiminn.is og frettin.is.

Fletta upp frétt

GET /api/lookup?url=<slóð fréttar>

Skilar GG-skori fréttarinnar ef hún hefur verið metin, og áætluðu hlutfalli gervigreindartexta hjá miðlinum síðustu 30 daga. Bættu við &l=en til að fá slóðir á ensku útgáfuna af síðu og mynd fréttarinnar.

GET https://gervigrein.is/api/lookup?url=https://visir.is/g/20262942330d/bjoda-ut-sorphirdu-i-breidholti-til-sex-ara

{
  "tracked": true,
  "outlet": "visir",
  "url": "https://visir.is/g/20262942330d/bjoda-ut-sorphirdu-i-breidholti-til-sex-ara",
  "article": {
    "id": 3396,
    "title": "Bjóða út sorphirðu í Breiðholti til sex ára",
    "words": 972,
    "published": "2026-10-01T23:00:45+00:00",
    "page": "/a/3396",
    "card": "/a/3396/card.png?v=2d73a3df14"
  },
  "status": "scored",
  "score": 0.07,
  "detector": "blend",
  "level": "human",
  "detectors": {
    "icebert": {"score": 0.05, "line": 0},
    "claude": {"score": 0.09, "line": 0}
  },
  "band": 0,
  "can_request": false,
  "requests": 0,
  "outlet_stats": {
    "name": "Vísir", "share": 0.275, "text": "28%", "scored": 534,
    "rank": 5, "of": 10, "estimate": true, "period": "30d"
  }
}

Reitir

ReiturMerking
trackedfalse ef slóðin er ekki á vef eins miðlanna tíu; þá fylgja engir aðrir reitir.
outletAuðkenni miðilsins: ruv, mbl, visir, dv, heimildin, vb, nutiminn, mannlif, frettatiminn, frettin.
urlStöðluð slóð fréttarinnar. Vantar, ásamt status, ef slóðin er forsíða eða yfirlitssíða (þá er article null).
articleFréttin, ef hún er í gagnagrunninum: id, title, words, published (ISO 8601), page (síða fréttarinnar á GerviGrein) og card (mynd, 1200×630 PNG, sem breytir um slóð ef skorið breytist). Slóðirnar eru miðaðar við grunnslóðina. Annars null.
statusSjá hér fyrir neðan.
scoreGG-skor frá 0 til 1, sama skor og á síðu fréttarinnar; hærra þýðir fleiri einkenni gervigreindartexta. Skorið er á sameiginlegum kvarða, mælt á móti fréttum skrifuðum af fólki: 0,1 er 5%-línan (um 1 af hverjum 20 slíkum fréttum fær hærra skor) og 0,5 efsta línan (hærra en allar fréttir skrifaðar af fólki sem greinirinn var borinn saman við). Aðeins ef status er scored.
detectorHvaða mat score er: blend (Blandað mat, beggja greina), annars icebert (Málfarsgreinir) eða claude (Framsetningargreinir).
levelNiðurstaða fyrir fréttina, út frá öllum greinunum: all Báðir greinar finna gervigreindareinkenni (báðir yfir efstu línu), one Annar greinirinn finnur gervigreindareinkenni, single Sjaldgæft í fréttum skrifuðum af fólki (eini greinirinn, yfir efstu línu), some Nokkur óvenjuleg einkenni (yfir 5%-línu), human Líkist fréttum skrifuðum af fólki.
detectorsSkor hvers greinis fyrir sig á sama kvarða; line er 0 undir 5%-línunni, 1 yfir henni, 2 yfir efstu línu.
bandÚrelt, fyrir eldri forrit: gamli flokkurinn 0–4, nú reiknaður út frá score og level. Notaðu level.
can_requestHvort POST /api/request-scan gæti bætt fréttinni við.
requestsHversu oft hefur verið beðið um að fréttin verði metin.
outlet_statsMiðillinn síðustu 30 daga: share er áætlað hlutfall frétta sem eru skrifaðar af gervigreind (0–1, leiðrétt fyrir skekkju greinisins; text er sama tala sniðin, eða „≥X%“ ef leiðréttingin nær 100%; null og „—“ ef engar fréttir eru metnar), scored fjöldi metinna frétta, rank af of (1 = hæsta hlutfall). estimate er false ef ekki er hægt að leiðrétta hlutföllin; þá er share hlutfall merktra frétta.

Gildi status

scoredFréttin hefur verið metin.
queuedFréttin er í gagnagrunninum og verður metin sjálfkrafa innan skamms.
summaryAðeins útdráttur úr RSS-straumi er til; beðið er eftir öllum textanum.
shortTextinn er of stuttur til að meta hann.
not_autoFréttin er í gagnagrunninum en verður ekki metin sjálfkrafa (t.d. eldri en 14 daga).
requestedBeðið hefur verið um fréttina og verið er að sækja hana.
failedEkki tókst að sækja fréttina.
unknownFréttin er ekki í gagnagrunninum.

Biðja um mat á frétt

POST /api/request-scan

Content-Type: application/json

{"url": "https://www.ruv.is/frettir/innlent/..."}

Sendu aðeins slóð, aldrei texta. GerviGrein sækir fréttina sjálf af vef miðilsins (mbl.is: aðeins afrit á archive.org, sem birtist oftast innan sólarhrings) og metur hana innan daglegra marka. Svarið er það sama og frá /api/lookup, auk accepted (hvort beiðnin var tekin gild).

  • 202: beiðnin var tekin gild. Flettu fréttinni upp aftur eftir nokkrar mínútur.
  • 200: beðið var um fréttina áður, eða hún er þegar komin.
  • 400: slóðin er ekki frétt á vef eins miðlanna.
  • 429: of margar beiðnir; reyndu aftur síðar.

Takmörk og sanngjörn notkun

  • Allt að 120 fyrirspurnir á mínútu á hverja IP-tölu, og 10 á mínútu fyrir /api/request-scan.
  • Nýjar beiðnir um mat: 20 á dag á hverja IP-tölu og 200 á dag samtals.
  • Sendu lýsandi User-Agent með leið til að hafa samband, og geymdu svör í nokkrar mínútur í stað þess að spyrja aftur og aftur.
  • Ætlarðu að senda margar fyrirspurnir, skrifaðu þá á [email protected].

Að nota niðurstöðurnar

  • Vísaðu í GerviGrein og tengdu á síðu fréttarinnar (page) þegar þú birtir skor.
  • Skor einstakrar fréttar er óvisst. Ekki birta það sem sönnun þess að frétt hafi verið skrifuð af gervigreind; hlutfall miðilsins er traustari mælikvarði. Sjá „Um“ á forsíðunni um hvernig það er reiknað.
  • Forritaskilin geta breyst. Þjónustan er veitt eins og hún er, án ábyrgðar; sjá notkunarskilmála.
  • Hvað er geymt um fyrirspurnir: sjá persónuvernd.