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: [email protected]