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

Wikivoyage Pages API

Travel article metadata, HTML, source, create, update

Wikivoyage Pages API is one of 14 APIs that Wikivoyage publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Pages. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

This API exposes 6 operations across 5 paths, and defines 4 schemas. It is described by OpenAPI 3.0.3, at version 1.47.

Requests are made against 2 base URLs: https://en.wikivoyage.org/w, https://{lang}.wikivoyage.org/w.

6 operations 5 paths 4 schemas 4 GET1 POST1 PUT

Metadata

The identity and technical contract details declared by the specification.

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

Authentication & Security 2

Wikivoyage Pages API declares 2 security schemes for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). An API key is passed in the cookie as wikivoyagewikiUserID (CookieAuth).

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

Paths & Operations 6

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

Pages 6

Travel article metadata, HTML, source, create, update

GET
/page/{title}
Wikivoyage Core REST Get Travel Article Source and Metadata
getPage 2 params → 200404
PUT
/page/{title}
Wikivoyage Core REST Update or Create a Travel Article
updatePage 1 param body → 200404
GET
/page/{title}/bare
Wikivoyage Core REST Get Travel Article Metadata Without Content
getPageBare 1 param → 200404
GET
/page/{title}/html
Wikivoyage Core REST Get Travel Article as HTML
getPageHtml 1 param → 200
GET
/page/{title}/with_html
Wikivoyage Core REST Get Travel Article Metadata and HTML
getPageWithHtml 1 param → 200404
POST
/page
Wikivoyage Core REST Create a New Travel Article
createPage body → 201

Schemas 4

The contract defines 4 schemas that model the data the API accepts and returns. The most detailed are Page (9 properties), UpdatePageRequest (5 properties), CreatePageRequest (5 properties), Error (2 properties). Each schema is shown below with its type and property counts.

CreatePageRequest
object
5 properties 3 required
UpdatePageRequest
object
5 properties 2 required
Error
object
2 properties
Page
object
A Wikivoyage travel article page object.
9 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

wikivoyage-pages-api-openapi.yml Raw ↑

Other APIs Wikivoyage publishes across the network.

Wikivoyage Authentication API
Wikivoyage Edit API
Wikivoyage Files API
Wikivoyage History API
Wikivoyage Links API
Wikivoyage Meta API
Wikivoyage Parse API
Wikivoyage Patrol API
Wikivoyage Query API
Wikivoyage Revisions API
Wikivoyage Search API
Wikivoyage Transforms API