Wikivoyage

aid: wikivoyage
name: Wikivoyage
description: 'Wikivoyage is the free, collaboratively written travel guide operated by the non-profit Wikimedia Foundation.
  It covers travel destinations worldwide with articles on accommodation, sightseeing, local transport, and practical travel
  advice. Like all Wikimedia projects, Wikivoyage exposes its content through the MediaWiki Action API (/w/api.php) and the
  MediaWiki Core REST API (/w/rest.php/v1/), enabling developers to query, retrieve, and update travel guide articles programmatically.
  Content is available in over 20 languages. All APIs are governed by the Wikimedia Foundation API Usage Guidelines: a contactable
  User-Agent is required, serial (non-parallel) requests are expected for bulk work, and the maxlag parameter must be used
  by automated clients.'
url: https://en.wikivoyage.org
image: https://upload.wikimedia.org/wikipedia/commons/thumb/d/dd/Wikivoyage-Logo-v3-icon.svg/120px-Wikivoyage-Logo-v3-icon.svg.png
specificationVersion: '0.19'
created: '2026-06-13'
modified: '2026-06-13'
x-type: opensource
x-category: Travel
x-tier: 2
x-tier-reason: Leading open-license travel guide with global coverage; non-profit Wikimedia Foundation
tags:
- Travel
- Open Data
- Public APIs
- Open Knowledge
- Travel Guide
- Tourism
- MediaWiki
- Non-Profit
apis:
- name: Wikivoyage MediaWiki Action API
  description: The primary programmatic interface for Wikivoyage, exposed at https://en.wikivoyage.org/w/api.php. Operations
    are dispatched via the action= query parameter (query, parse, edit, search, ...). Enables retrieval of travel destination
    articles, accommodation listings, sightseeing information, and practical travel advice. Supports both anonymous reads
    and authenticated writes via OAuth 2.0. JSON is the recommended response format. Running on MediaWiki 1.47.0-wmf.6.
  humanURL: https://www.mediawiki.org/wiki/API:Main_page
  baseURL: https://en.wikivoyage.org/w/api.php
  tags:
  - Action API
  - Read
  - Write
  - Search
  - Travel Articles
  properties:
  - type: Documentation
    url: https://www.mediawiki.org/wiki/API:Main_page
  - type: Sandbox
    url: https://en.wikivoyage.org/wiki/Special:ApiSandbox
  - type: Tutorials
    url: https://www.mediawiki.org/wiki/API:Tutorial
  - type: Etiquette
    url: https://www.mediawiki.org/wiki/API:Etiquette
  - type: OpenAPI
    url: openapi/wikivoyage-mediawiki-action-api-openapi.yaml
  - type: JSONLDContext
    url: json-ld/wikivoyage-mediawiki-action-api-context.jsonld
- name: Wikivoyage MediaWiki Core REST API
  description: Modern REST surface under /w/rest.php/v1/ providing page CRUD, full-text search, file metadata, revision history,
    and wikitext <-> HTML transforms. Enables retrieval of Wikivoyage travel articles in wikitext, parsed HTML, or bare form.
    Supports autocomplete on page titles for destination lookup. Also mirrored at api.wikimedia.org/core/v1/wikivoyage/{lang}/
    for centralized access.
  humanURL: https://www.mediawiki.org/wiki/API:REST_API
  baseURL: https://en.wikivoyage.org/w/rest.php/v1
  tags:
  - REST API
  - Core
  - Pages
  - Search
  - Transforms
  - Travel Articles
  properties:
  - type: Documentation
    url: https://www.mediawiki.org/wiki/API:REST_API/Reference
  - type: APIPortal
    url: https://api.wikimedia.org/wiki/Core_REST_API
  - type: Sandbox
    url: https://en.wikivoyage.org/wiki/Special:RestSandbox
  - type: OpenAPI
    url: openapi/wikivoyage-mediawiki-core-rest-openapi.yaml
  - type: JSONLDContext
    url: json-ld/wikivoyage-mediawiki-core-rest-context.jsonld
common:
- type: Website
  url: https://www.wikivoyage.org
- type: Portal
  url: https://en.wikivoyage.org/wiki/Wikivoyage:Welcome,_fellow_Wikivoyagers!
- type: Documentation
  url: https://www.mediawiki.org/wiki/API:Main_page
- type: APIPortal
  url: https://api.wikimedia.org/wiki/Main_Page
- type: Foundation
  url: https://wikimediafoundation.org/
- type: License
  url: https://creativecommons.org/licenses/by-sa/4.0/
  title: CC BY-SA 4.0 (travel article content)
- type: Policy
  url: https://foundation.wikimedia.org/wiki/Policy:Wikimedia_Foundation_API_Usage_Guidelines
  title: API Usage Guidelines
- type: TermsOfService
  url: https://foundation.wikimedia.org/wiki/Policy:Terms_of_Use
- type: Status
  url: https://www.wikimediastatus.net/
- type: GitHubOrganization
  url: https://github.com/wikimedia
- type: BulkDownload
  url: https://dumps.wikimedia.org/enwikivoyage/
  title: Wikivoyage Database Dumps
- type: Plans
  url: plans/wikivoyage-plans-pricing.yml
- type: RateLimits
  url: rate-limits/wikivoyage-rate-limits.yml
- type: FinOps
  url: finops/wikivoyage-finops.yml
features:
- name: Travel Destination Articles
  description: Comprehensive travel guides for cities, regions, and countries worldwide, accessible via the Action API (action=parse&page={title})
    or REST API (/page/{title}/with_html).
- name: Full-Text Search
  description: Search across all Wikivoyage travel articles by keyword via the REST API /search/page endpoint or the Action
    API (action=query&list=search).
- name: Title Autocomplete
  description: Autocomplete destination names using the REST API /search/title endpoint for building travel search interfaces
    and apps.
- name: Multi-Language Coverage
  description: Wikivoyage is available in 20+ languages; each language edition exposes the same API surfaces under {lang}.wikivoyage.org.
- name: Revision History
  description: Access the full edit history of any travel article via /page/{title}/history and compare revisions via /revision/{from_id}/compare/{to_id}.
- name: Wikitext HTML Transforms
  description: Convert Wikivoyage wikitext to rendered HTML (and back) on-demand via /transform/wikitext/to/html/{title} -
    enabling custom rendering of travel content.
- name: Language Links
  description: Retrieve equivalent articles across all language editions of Wikivoyage via /page/{title}/links/language.
useCases:
- name: Travel Apps and Itinerary Planners
  description: Integrate Wikivoyage travel destination articles, accommodation listings, and sightseeing information into
    mobile travel apps and itinerary planning tools.
- name: AI Travel Assistants
  description: Ground AI travel recommendations in authoritative Wikivoyage content via the REST API, retrieving structured
    travel advice as context for LLM responses.
- name: Destination Guides and Tourism Websites
  description: Embed open-license travel content on tourism websites and destination guides, fetching article content and
    displaying it under CC BY-SA 4.0 attribution.
- name: Offline Travel Reading
  description: Build offline travel guides using periodic database dumps from dumps.wikimedia.org or by crawling the API,
    similar to the Kiwix/Wikipedia offline approach.
- name: Travel Research and Data Analysis
  description: Analyze global travel destination coverage, identify gaps, and study how travel advice evolves over time using
    the revision history and bulk dump APIs.
integrations:
- name: Wikidata
  description: Wikivoyage articles link to Wikidata items (QIDs) for structured geographic and entity data on travel destinations.
- name: Wikimedia Commons
  description: Travel images and maps used in Wikivoyage articles are hosted on Commons and accessible via the same Action
    API at commons.wikimedia.org/w/api.php.
- name: OpenStreetMap
  description: Wikivoyage embeds maps and location markers using OpenStreetMap tiles alongside structured geo-coordinates
    in article templates.
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com