<!-- Wikimedia Enterprise. Canonical page: https://enterprise.wikimedia.com/project-data/wikivoyage-api/ -->

# Wikivoyage API

## Power your Platforms with Openly Licensed Travel Data

**Wikivoyage** is a sister project of Wikipedia dedicated to travel, containing over 150,000 articles. It's a global, human-curated travel guide built by over 2.7 million users, all available under open licenses. Wikivoyage is built by frequent travelers and locals, for travelers and tourists. Accessing Wikivoyage data through the Wikimedia Enterprise APIs, this dataset becomes a powerful engine for uncovering global travel insights, analyzing popular destinations, building location-aware apps, populating maps with rich destination info, creating automated itineraries, and more.

### Organized travel recommendations, made by people

Wikivoyage articles all follow the same structure, counter to articles in sister projects like Wikipedia. Wikivoyage data provides a predictable and scalable source of information.

- **Fixed Format for Every Destination:** Every article page follows a [consistent format](https://en.wikivoyage.org/wiki/Wikivoyage:Article_skeleton_templates/Sections), using the same subheadings to cluster similar information. This means you can reliably extract specific types of content, such as transport information, POIs, listings for accommodations, restaurants, and attractions, etc. All without the need for complex, custom parsers.
- **Clear Destination Hierarchy:** Wikivoyage data is logically organized from continents down to countries, regions, cities, and more. This clear hierarchy is perfect for modeling geographic relationships and building sophisticated location-aware systems.

**Human-Curated and Non-Commercial:** Wikivoyage offers authentic, human-curated recommendations [free from commercial travel advertising](https://en.wikivoyage.org/wiki/Wikivoyage:Welcome,_business_owners). This provides a clean dataset ideal for training AI and large language models to generate genuine, user-focused travel advice.

### Uncover Global Insights and Travel Trends

Wikivoyage is deeply integrated with the broader open-source knowledge ecosystem, allowing you to build rich and context-aware applications. You can extract and interlink information from multiple wiki project sources using the same Wikimedia Enterprise APIs.

- **Connect Through Wikidata:** Almost all Wikivoyage articles include a **Wikidata identifier**, a crucial ID to disambiguate and connect articles across databases. This allows you to build rich knowledge graphs by linking Wikivoyage data with other atlas data, Wikipedia data, and more.
- **Integrate Geolocation and Visuals:** Pull in precise **geolocation** data for every POI and easily reuse static map images via open-source **OpenStreetMap**. Wikivoyage articles also contain multiple high-quality, freely reusable **images** from Wikimedia Commons.
- **Build a Comprehensive Travel Atlas:** Combine these interconnected datasets to build a dynamic, multi-layered digital atlas that offers users unparalleled depth and context for any destination on Earth.
- **More than just destination articles:** Wikivoyage data includes **phrasebooks**, **travel topics**, and **itineraries**, providing rich textual information for advanced NLP tasks.

Whether you're looking for a **free travel data API** solution that offers unparalleled scale or need enterprise-grade reliability, Wikimedia Enterprise infrastructure delivers. Start leveraging the free worldwide travel guide today to power your AI, research, and knowledge graph projects.

[Get Started with Wikivoyage API](https://dashboard.enterprise.wikimedia.com/signup/?utm_source=website&utm_medium=cta&utm_campaign=signup&utm_content=wikivoyage-api)

### What data can you find in Wikivoyage?

A Wikivoyage article starts with information about the destination. It links to higher and lower entries in the geographical hierarchy, e.g., in which country a city is located, or what countries are part of a subcontinent. The entry outlines areas the destination borders, attraction highlights, and demography. Entries that cover a large geographic area, such as countries or continents, will divide and describe each smaller region or area and link to articles about those specific smaller areas. The centre of the location, region, or country is marked with geographic coordinates (GPS). There are Wikivoyage articles for almost every level of specificity and hierarchy: you'll find articles for cantons, provinces, cities, and neighborhoods, all the way up to nations, federated states, and continents.

### What sections does a Wikivoyage article have?

After the destination overview, a Wikivoyage article is always organized with [similar subheadings](https://en.wikivoyage.org/wiki/Wikivoyage:Article_skeleton_templates/Sections). Many sections have listings for specific points of interest with GPS coordinates. The subheadings are:

- **Understand**: A free-form text section providing deeper background information and cultural context, using descriptive paragraphs to explain a destination's unique character and add local flavor.
- **Talk**: Details the local language situation, how easy it is to get by with English or another foreign language, information about the writing system(s) travelers may encounter, and links to any useful phrasebooks.
- **Get in**: How to get to the destination. Has subheadings for different modes of transport (by plane, by boat, by train, by car, etc.). Includes information about immigration systems, visas needed, and border crossings.
- **Fees and permits**: A section specifically used for parks and natural reserves. Entrance fees, campsite fees, hiking permits and fees along with any notable rules and regulations.
- **Get around**: Details transportation options for traveling within a destination, with information becoming more specific for smaller geographic areas like cities than for larger ones like countries.
- **See**: A required section for almost all articles. Lists attractions in the area, e.g. museums, zoos, parks, and landmarks. Includes a list of itineraries, if applicable.
- **Do**: Also required for almost all articles. Lists activities in the area: scheduled events like sports events, casinos, theaters, tours, hiking trails, etc. Also includes recurring scheduled activities such as festivals, parades, celebrations, carnivals, and more.
- **Learn**: Includes information about where travelers can learn about language, culture, and other educational activities.
- **Work**: Shows options for travelers on finding work in the area: work visas, volunteer opportunities, and other job resources.
- **Buy**: Information on local currency and currency exchanges, duties and taxes, ATMs, what goods can be purchased in the area, shopping districts and centres, markets, and retailers.
- **Eat**: This section talks about food specific to the article location. Mentions types of restaurants to look out for or avoid, local cuisine, information for people with dietary restrictions, restaurant listings, supermarkets and food retailers.
- **Drink**: A section about the nightlife at the article location. This mentions areas with good nightlife, interesting musical traditions, club etiquette, and listings of bars and clubs.
- **Sleep**: Required section for almost all articles. Information on types of accommodations, price ranges, regulations, listings of hotels, guest houses, B\&Bs.
- **Stay safe**: Information to keep travelers safe: things to look out for in an area, climate charts, wildlife, culture, pests, tourist scams, and more. This includes knowledge to stay safe from crime, be aware of regions of civil war and unrest, and illegal activities.
- **Stay healthy**: Lists medical information: where to find a pharmacy, the cost of health care, significant outbreaks of disease, recommended shots and other precautions to take to stay healthy.
- **Respect**: An overview of cultural info to ensure a respectful visit: clothing prescriptions, gestures to avoid, words not to say, how to show respect for serving staff and the elderly. May have a separate subsection about LGBT laws and ethical standards.
- **Connect**: Phone networks, telecom carriers, country codes, postal services, levels of internet access, how to find Wi-Fi hotspots, local SIM cards and outlet types.
- **Cope**: How to deal with non-emergency situations such as needing a haircut, a babysit, pet care, services for when you lose travel documents, nearby embassies and consulates and their opening hours, etc.
- **Nearby**: Lists and links to nearby towns and cities.
- **Go next**: Information about nearby destinations to go next: day trips, nearby cities, routes and links to itineraries.

*Image: The Wikivoyage article on Rome, showing the standard section outline in the left rail and the banner, breadcrumb and destination summary a traveler sees first.*

Source: [Rome on English Wikivoyage](https://en.wikivoyage.org/wiki/Rome)

## How to access Wikivoyage data

Access Wikivoyage data in any of 27 languages through the [Wikimedia Enterprise APIs](https://enterprise.wikimedia.com/api/). Use the Snapshot API for complete project downloads or the On-demand API to retrieve a single article.

Example call to **download all of Dutch Wikivoyage**:

```bash
curl -L 'https://api.enterprise.wikimedia.com/v2/snapshots/nlwikivoyage_namespace_0/download' -H 'Authorization: Bearer ACCESS_TOKEN'
```

Example call to **get a specific Wikivoyage article**,
e.g. the English entry for 'European Union':

```bash
curl -L 'https://api.enterprise.wikimedia.com/v2/articles/European_Union' -H 'Content-Type: application/json' -H 'Authorization: Bearer ACCESS_TOKEN' -d '{"filters":[{"field":"is_part_of.identifier","value":"enwikivoyage"}],"limit":10}'
```

## Wikivoyage API FAQ

### Is there a Wikivoyage API?

Yes. Wikivoyage data is available through the Wikimedia Enterprise APIs, built and run by the Wikimedia Foundation. Every page comes back with its full wikitext and HTML, its revision metadata, its categories, and its license, in the same JSON schema used for every other Wikimedia project.

### Is there a free travel data API?

Yes. Wikivoyage is openly licensed travel data, and a free Wikimedia Enterprise account includes snapshot downloads and a monthly allowance of On-demand requests, with no credit card. Paid accounts add higher volume, hourly and real-time updates, and production support. See [pricing](https://enterprise.wikimedia.com/pricing/) for current limits.

### How do I download all of Wikivoyage?

Use the [Snapshot API](https://enterprise.wikimedia.com/docs/snapshot/), which publishes one bundle per language edition and is included with a free account. English Wikivoyage's article snapshot is under 1 GB compressed.

### Can I use Wikivoyage data commercially?

Yes, within the license. Wikivoyage is published under [CC BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/), which permits commercial use as long as attribution is preserved and derivative works carry the same license. The license block travels inside every API response.

### How is Wikivoyage different from Wikipedia?

Wikipedia is an encyclopedia, and its articles vary in structure. Wikivoyage is a travel guide written for people planning a trip, and its destination articles share the same sections, such as See, Do, Eat, and Sleep, so you can extract the same kind of information across destinations.

### How do I link Wikivoyage articles to Wikidata?

Almost all Wikivoyage articles include a Wikidata identifier, returned in the `main_entity` field. The English article on Rome, for example, returns `Q220`, which the [Wikidata API](https://enterprise.wikimedia.com/project-data/wikidata-api/) can look up and which connects the destination to the same concept on Wikipedia and other projects.

## Get started with the Wikivoyage API

Access Wikivoyage, Wikipedia, and other [Wikimedia project data](https://enterprise.wikimedia.com/project-data/) through one unified API delivering a consistent JSON output. [Get started with free instant access today](https://dashboard.enterprise.wikimedia.com/signup/?utm_source=website&utm_medium=cta&utm_campaign=signup&utm_content=wikivoyage-api).

[Get Started with Wikivoyage API](https://dashboard.enterprise.wikimedia.com/signup/?utm_source=website&utm_medium=cta&utm_campaign=signup&utm_content=wikivoyage-api)
