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.isogfrettin.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
| Reitur | Merking |
|---|---|
tracked | false ef slóðin er ekki á vef eins miðlanna tíu; þá fylgja engir aðrir reitir. |
outlet | Auðkenni miðilsins: ruv, mbl, visir, dv, heimildin, vb, nutiminn, mannlif, frettatiminn, frettin. |
url | Stöðluð slóð fréttarinnar. Vantar, ásamt status, ef slóðin er forsíða eða yfirlitssíða (þá er article null). |
article | Fré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. |
status | Sjá hér fyrir neðan. |
score | GG-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. |
detector | Hvaða mat score er: blend (Blandað mat, beggja greina), annars icebert (Málfarsgreinir) eða claude (Framsetningargreinir). |
level | Nið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. |
detectors | Skor 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_request | Hvort POST /api/request-scan gæti bætt fréttinni við. |
requests | Hversu oft hefur verið beðið um að fréttin verði metin. |
outlet_stats | Mið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
scored | Fréttin hefur verið metin. |
queued | Fréttin er í gagnagrunninum og verður metin sjálfkrafa innan skamms. |
summary | Aðeins útdráttur úr RSS-straumi er til; beðið er eftir öllum textanum. |
short | Textinn er of stuttur til að meta hann. |
not_auto | Fréttin er í gagnagrunninum en verður ekki metin sjálfkrafa (t.d. eldri en 14 daga). |
requested | Beðið hefur verið um fréttina og verið er að sækja hana. |
failed | Ekki tókst að sækja fréttina. |
unknown | Fré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-Agentmeð 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.