Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Wikipedia / MediaWiki Reading lists API

Private lists of selected pages

Wikipedia / MediaWiki Reading lists API is one of 33 APIs that Wikipedia / MediaWiki publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Reading lists. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, and pricing.

This API exposes 13 operations across 10 paths, and defines 5 schemas. It is described by OpenAPI 3.0.3, at version 1.45.

Requests are made against 5 base URLs: https://en.wikipedia.org/w, https://{lang}.wikipedia.org/w, https://commons.wikimedia.org/w, https://www.wikidata.org/w, https://www.mediawiki.org/w.

13 operations 10 paths 5 schemas 2 DELETE4 GET6 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.3
API Version
1.45
Base URL
https://en.wikipedia.org/w/api.php
Authentication
HTTP Bearer, API Key
Resource Areas
1

Authentication & Security 2

Wikipedia / MediaWiki Reading lists API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). An API key is passed in the cookie as {wiki}wikiUserID (CookieAuth).

  • BearerAuth — OAuth 2.0 bearer token from meta.wikimedia.org
  • CookieAuth — Session cookie obtained via action=login or action=clientlogin

Paths & Operations 13

Across 10 paths, the API surfaces 13 operations — 2 DELETE, 4 GET, 6 POST, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Reading lists 13

Private lists of selected pages

POST
/data/lists/setup
Wikimedia REST Opt in to Use Reading Lists.
1 param → 200default
POST
/data/lists/teardown
Wikimedia REST Opt Out from Using Reading Lists.
1 param → 200default
GET
/data/lists/
Wikimedia REST Get All Lists of the Current User.
2 params → 200default
POST
/data/lists/
Wikimedia REST Create a New List for the Current User.
1 param body → 200default
PUT
/data/lists/{id}
Wikimedia REST Update a List.
2 params body → 200default
DELETE
/data/lists/{id}
Wikimedia REST Delete a List.
1 param → 200default
POST
/data/lists/batch
Wikimedia REST Create Multiple New Lists for the Current User.
1 param body → 200default
GET
/data/lists/{id}/entries/
Wikimedia REST Get All Entries of a Given List.
getListEntries 3 params → 200default
POST
/data/lists/{id}/entries/
Wikimedia REST Create a New List Entry.
2 params body → 200default
DELETE
/data/lists/{id}/entries/{entry_id}
Wikimedia REST Delete a List Entry.
2 params → 200default
POST
/data/lists/{id}/entries/batch
Wikimedia REST Create Multiple New List Entries.
2 params body → 200default
GET
/data/lists/pages/{project}/{title}
Wikimedia REST Get Lists of the Current User Which Contain a Given Page.
3 params → 200default
GET
/data/lists/changes/since/{date}
Wikimedia REST Get Recent Changes to the Lists
2 params → 200default

Schemas 5

The contract defines 5 schemas that model the data the API accepts and returns. The most detailed are list_read (5 properties), list_entry_read (5 properties), problem (4 properties), list_entry_write (2 properties). Each schema is shown below with its type and property counts.

list_entry_read
object
5 properties
list_write
object
2 properties 1 required
problem
object
4 properties 1 required
list_read
object
5 properties 4 required
list_entry_write
object
2 properties 2 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wikipedia-reading-lists-api-openapi.yml Raw ↑

Other APIs Wikipedia / MediaWiki publishes across the network.

Wikipedia / MediaWiki articles API
Wikipedia / MediaWiki Authentication API
Wikipedia / MediaWiki batches API
Wikipedia / MediaWiki Citation API
Wikipedia / MediaWiki codes API
Wikipedia / MediaWiki Edit API
Wikipedia / MediaWiki Files API
Wikipedia / MediaWiki History API
Wikipedia / MediaWiki languages API
Wikipedia / MediaWiki Links API
Wikipedia / MediaWiki Math API
Wikipedia / MediaWiki Meta API