Get revscoring articlequality prediction

POST	`/service/lw/inference/v1/models/{wiki}-articlequality:predict`

Get a score from the Revscoring Article Quality model (previously hosted on ORES) for a given Wiki revision id.

Note: For historical reasons, the articlequality model that is used for wikidata items uses a different URL scheme (item instead of article), thus the URI for wikidata is /service/lw/inference/v1/models/wikidatawiki-itemquality:predict.

Examples

curl

Anonymous access

# Get a score from the Revscoring Article Quality model for the revision 12345 of English Wikipedia.
$ curl https://api.wikimedia.org/service/lw/inference/v1/models/enwiki-articlequality:predict -X POST -d '{"rev_id": 12345}' -H "Content-type: application/json"

Logged in access

# Get a score from the Revscoring Article Quality model for the revision 12345 of English Wikipedia.
$ curl https://api.wikimedia.org/service/lw/inference/v1/models/enwiki-articlequality:predict -X POST -d '{"rev_id": 12345}' -H "Authorization: Bearer YOUR_ACCESS_TOKEN" -H "Content-type: application/json"

Python

# Python 3
# Get a score from the Revscoring Article Quality model for the revision 12345 of English Wikipedia.

import json
import requests

use_auth = False
inference_url = 'https://api.wikimedia.org/service/lw/inference/v1/models/enwiki-articlequality:predict'

if use_auth:
  headers = {
      'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
      'User-Agent': 'YOUR_APP_NAME (YOUR_EMAIL_OR_CONTACT_PAGE)',
      'Content-type': 'application/json'
  }
else:
  headers = {}
data = {"rev_id": 12345 }
response = requests.post(inference_url, headers=headers, data=json.dumps(data))
print(response.json())

JavaScript

/*
Get a score from the Revscoring Article Quality model for the revision 12345 of English Wikipedia.
*/

const inferenceUrl = "https://api.wikimedia.org/service/lw/inference/v1/models/enwiki-articlequality:predict";
const accessToken = "YOUR_ACCESS_TOKEN";
const appName = "YOUR_APP_NAME";
const email = "YOUR_EMAIL_OR_CONTACT_PAGE";
let headers = new Headers({
    "Content-Type": "application/json",
    "Authorization": "Bearer " + accessToken,
    "Api-User-Agent": appName + " ( " + email + " )"
});
let data = {"rev_id": 12345 };

fetch(inferenceUrl, {
    method: "POST",
    headers: headers,
    body: JSON.stringify(data)
})
.then(response => response.json())
.then(inferenceData => console.log(inferenceData));

URI Parameters

`wiki` required	Wiki code:`enwiki` (English), `euwiki` (Basque), `fawiki` (Persian), `frwiki` (French), `glwiki` (Galician), `nlwiki` (Dutch), `ptwiki` (Portoguese), `ruwiki` (Russian), `svwiki` (Swedish), `trwiki` (Turkish), `ukwiki` (Ukrainian) or `wikidatawiki` (Wikidata, see note above).

POST Parameters

`rev_id` required	Wiki Revision id: integer related to a certain revision id for the Wiki set in the URI parameter.
`extended_output`	Whether or not the response should include the extended output of the model (like the list of features used etc..). Either true or false. Default: false

Responses

200

Success: Revision id found. Returns a Revscoring score object.

Example

{
  "enwiki": {
    "models": {
      "articlequality": {
        "version": "0.8.2"
      }
    },
    "scores": {
      "12345": {
        "articlequality": {
          "score": {
            "prediction": "Stub",
            "probability": {
              "B": 0.0485969161578697,
              "C": 0.028513124194213476,
              "FA": 0.0030320049715483475,
              "GA": 0.005008907686741135,
              "Start": 0.11763969051576227,
              "Stub": 0.7972093564738649
            }
          }
        }
      }
    }
  }
}