# Wikivoyage API > Wikivoyage as an API — the free, community-written worldwide travel guide, the travel sister project of Wikipedia. Wikivoyage covers countries, cities, regions, neighbourhoods and points of interest with practical, freely-licensed advice on what to see and do, how to get around, and where to eat and sleep. This API wraps the official Wikivoyage MediaWiki service into clean JSON. /v1/destination?title=Paris returns a destination's guide: its one-line description, the introductory guide text as plain readable prose, its geographic coordinates, a thumbnail image and the canonical URL — everything to present a destination at a glance. /v1/search?q=beaches searches the travel guides by keyword and returns matching destination titles with a short snippet, for building destination finders and autocomplete. /v1/nearby?lat=48.8584&lon=2.2945&radius=10000 finds destinations and points of interest within a radius (up to 10 km) of any coordinate, sorted by distance — perfect for "what is worth visiting near me" and map-based discovery. Titles are Wikivoyage article names such as Paris, Rome, Tokyo or Paris/7th arrondissement. Ideal for travel apps, trip planners, tourism dashboards, location-based discovery and chatbots. Content is licensed CC BY-SA by the Wikivoyage community. For encyclopaedic, non-travel content, pair this with a Wikipedia API. ## Authentication All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys. ```bash curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/wikivoyage-api/..." ``` ## Pricing - **Free** (Free) — 3,000 calls/Mo, 2 req/s - **Starter** ($8/Mo) — 55,000 calls/Mo, 5 req/s - **Pro** ($23/Mo) — 240,000 calls/Mo, 12 req/s - **Mega** ($61/Mo) — 850,000 calls/Mo, 35 req/s ## Endpoints ### Destinations #### `GET /v1/destination` — A destination travel guide **Parameters:** - `title` (query, required, string) — Destination name, e.g. Paris Example: `Paris` **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/wikivoyage-api/v1/destination?title=Paris" ``` **Response:** ```json { "data": { "destination": { "url": "https://en.wikivoyage.org/wiki/Paris", "title": "Paris", "extract": "Paris, the cosmopolitan capital of France, has the reputation of being the most beautiful and romantic of all cities, brimming with historic associations and remaining vastly influential in the realms of culture, art, fashion, food and design.\nDubbed the City of Light (la ville lumière) and the City of Love (la ville de l'amour), Paris is home to some of the world's finest and most luxurious fashion designers and cosmetics, such as Chanel, Christian Dior, Yves Saint-Laurent, Guerlain, Lancôme, L'Oréal, and Clarins. A large part of the city, including the banks of the River Seine, is a UNESCO World Heritage Site. The city has the second highest number of Michelin-starred restaurants in the world (after Tokyo, which is much larger) and contains numerous iconic landmarks such as the Eiffel Tower, the Arc de Triomphe, Notre-Dame de Paris, the Louvre, the Moulin Rouge and the Basilique du Sacré-Cœur, making it one of the most popular international tourist destinations in the world, with around 14 million visitors annually.", "latitude": 48.856, "longitude": 2.351, "thumbnail": "https://upload.wikimedia.org/wikipedia/commons/thumb/f/f3/View_of_the_Seine_in_Paris_in_september_2006.jpg/500px-View_of_the_Seine_in_Paris_in_september_2006.jpg?utm_source=en.wikivoyage.org&utm_campaign=api&utm_co …(truncated, see openapi.json for full schema) ``` #### `GET /v1/nearby` — Destinations near coordinates **Parameters:** - `lat` (query, required, string) — Latitude Example: `48.8584` - `lon` (query, required, string) — Longitude Example: `2.2945` - `radius` (query, optional, string) — Radius in metres (10-10000) - `limit` (query, optional, string) — Max results (1-50) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/wikivoyage-api/v1/nearby?lat=48.8584&lon=2.2945" ``` **Response:** ```json { "data": { "count": 10, "latitude": 48.8584, "radius_m": 10000, "longitude": 2.2945, "destinations": [ { "url": "https://en.wikivoyage.org/wiki/Paris%2F7th_arrondissement", "title": "Paris/7th arrondissement", "latitude": 48.8551, "longitude": 2.3126, "distance_m": 1374 }, { "url": "https://en.wikivoyage.org/wiki/Paris%2F16th_arrondissement", "title": "Paris/16th arrondissement", "latitude": 48.863611, "longitude": 2.276489, "distance_m": 1439 }, { "url": "https://en.wikivoyage.org/wiki/Paris%2F15th_arrondissement", "title": "Paris/15th arrondissement", "latitude": 48.8406, "longitude": 2.2939, "distance_m": 1980 }, { "url": "https://en.wikivoyage.org/wiki/Paris%2F8th_arrondissement", "title": "Paris/8th arrondissement", "latitude": 48.8722, "longitude": 2.313, "distance_m": 2046 }, { "url": "https://en.wikivoyage.org/wiki/Paris%2F6th_arrondissement", "title": "Paris/6th arrondissement", "latitude": 48.8488, "longitude": 2.3332, "dis …(truncated, see openapi.json for full schema) ``` #### `GET /v1/search` — Search travel guides **Parameters:** - `q` (query, required, string) — Keyword, e.g. beaches Example: `beaches` - `limit` (query, optional, string) — Max results (1-50) **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/wikivoyage-api/v1/search?q=beaches" ``` **Response:** ```json { "data": { "count": 10, "query": "beaches", "results": [ { "url": "https://en.wikivoyage.org/wiki/Beaches", "title": "Beaches", "snippet": "don't like beaches or just don't like something about the beaches you've been to. If you dislike the crowds, head to a remote, lesser-known beach, or visit" }, { "url": "https://en.wikivoyage.org/wiki/D-Day_beaches", "title": "D-Day beaches", "snippet": "some of the D-Day beaches. On the bus website there is a map of the bus route to the D-Day beaches. Bus 70 takes you to Omaha beach, the American cemetery" }, { "url": "https://en.wikivoyage.org/wiki/Sydney%2FNorthern_Beaches", "title": "Sydney/Northern Beaches", "snippet": "The Northern Beaches of Sydney refers to a suburban district located in the north of the city, as well as a stretch of famous beaches extending northwards" }, { "url": "https://en.wikivoyage.org/wiki/West_Palm_Beach", "title": "West Palm Beach", "snippet": "beaches in Palm Beach County. The proximity of the Gulf Stream keeps the waters warm year-round although many miles are private a nearby public beach" }, { "url": "https://en.wikivoyage.org/wiki/Long_Beach", …(truncated, see openapi.json for full schema) ``` ### Meta #### `GET /v1/meta` — Usage notes **Example:** ```bash curl -H "x-oanor-key: $KEY" \ "https://api.oanor.com/wikivoyage-api/v1/meta" ``` **Response:** ```json { "data": { "note": "Wikivoyage is the travel sister project of Wikipedia — community-written, freely-licensed guides to countries, cities, regions and points of interest worldwide. /v1/destination?title=Paris = a destination's guide: its short description, the introductory guide text (plain text), coordinates, a thumbnail image and the canonical URL; /v1/search?q=beaches = search travel guides by keyword, returning matching destination titles with a snippet; /v1/nearby?lat=48.8584&lon=2.2945&radius=10000 = destinations and points of interest within a radius (metres, up to 10km) of a coordinate, sorted by distance — ideal for 'what's worth visiting near me' features. Titles are Wikivoyage article names (e.g. Paris, Rome, Tokyo, Paris/7th arrondissement). Content is licensed CC BY-SA by the Wikivoyage community. For encyclopaedic (non-travel) content use a Wikipedia API instead.", "source": "Wikivoyage — the free worldwide travel guide (en.wikivoyage.org, a Wikimedia project)", "endpoints": [ "/v1/destination", "/v1/search", "/v1/nearby", "/v1/meta" ] }, "meta": { "timestamp": "2026-06-01T16:23:46.788Z", "request_id": "d3a108b3-f1f8-446f-ab00-7e56d733a568" }, "status": "ok", "message": "Meta retrieved", "success": true } ``` --- Marketplace page: https://www.oanor.com/api/wikivoyage-api OpenAPI spec: https://www.oanor.com/api/wikivoyage-api/openapi.json