{"openapi":"3.1.0","info":{"title":"Wikivoyage API","version":"1.0.0","description":"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.","contact":{"name":"PremiumApi","url":"https://www.oanor.com/by/premiumapi"}},"servers":[{"url":"https://api.oanor.com/wikivoyage-api","description":"oanor gateway"}],"tags":[{"name":"Destinations"},{"name":"Meta"}],"components":{"securitySchemes":{"oanorKey":{"type":"apiKey","in":"header","name":"x-oanor-key","description":"Get your key at https://www.oanor.com/developer/keys"}}},"security":[{"oanorKey":[]}],"paths":{"/v1/destination":{"get":{"operationId":"get_v1_destination","tags":["Destinations"],"summary":"A destination travel guide","description":"","parameters":[{"name":"title","in":"query","required":true,"description":"Destination name, e.g. Paris","schema":{"type":"string"},"example":"Paris"}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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_content=thumbnail","description":"capital and most populous city in France"}},"meta":{"timestamp":"2026-06-01T16:23:46.167Z","request_id":"5f1ff197-f38c-4de9-bce9-90014384d7ba"},"status":"ok","message":"Destination retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/nearby":{"get":{"operationId":"get_v1_nearby","tags":["Destinations"],"summary":"Destinations near coordinates","description":"","parameters":[{"name":"lat","in":"query","required":true,"description":"Latitude","schema":{"type":"string"},"example":"48.8584"},{"name":"lon","in":"query","required":true,"description":"Longitude","schema":{"type":"string"},"example":"2.2945"},{"name":"radius","in":"query","required":false,"description":"Radius in metres (10-10000)","schema":{"type":"string"}},{"name":"limit","in":"query","required":false,"description":"Max results (1-50)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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,"distance_m":3026},{"url":"https://en.wikivoyage.org/wiki/Paris%2F1st_arrondissement","title":"Paris/1st arrondissement","latitude":48.8627,"longitude":2.3361,"distance_m":3081},{"url":"https://en.wikivoyage.org/wiki/Left_Bank","title":"Left Bank","latitude":48.8501,"longitude":2.3353,"distance_m":3125},{"url":"https://en.wikivoyage.org/wiki/Paris%2F17th_arrondissement","title":"Paris/17th arrondissement","latitude":48.8869,"longitude":2.3088,"distance_m":3337},{"url":"https://en.wikivoyage.org/wiki/Paris%2F2nd_arrondissement","title":"Paris/2nd arrondissement","latitude":48.8678,"longitude":2.3413,"distance_m":3580},{"url":"https://en.wikivoyage.org/wiki/Paris%2F9th_arrondissement","title":"Paris/9th arrondissement","latitude":48.8772,"longitude":2.3382,"distance_m":3819}]},"meta":{"timestamp":"2026-06-01T16:23:46.400Z","request_id":"08423c41-8b44-4fd8-9e15-86ba123cef7f"},"status":"ok","message":"Nearby destinations retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/search":{"get":{"operationId":"get_v1_search","tags":["Destinations"],"summary":"Search travel guides","description":"","parameters":[{"name":"q","in":"query","required":true,"description":"Keyword, e.g. beaches","schema":{"type":"string"},"example":"beaches"},{"name":"limit","in":"query","required":false,"description":"Max results (1-50)","schema":{"type":"string"}}],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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","title":"Long Beach","snippet":"which is a small, suburban city within Long Beach. The park features breathtaking views where you can see beaches of Orange County, Queen Mary, Palos Verdes"},{"url":"https://en.wikivoyage.org/wiki/Daytona_Beach","title":"Daytona Beach","snippet":"beautiful weather usually attracts tourists back to the beaches by early March. 29.1849-81.06091 Daytona Beach International Airport (DAB  IATA), 700 Catalina"},{"url":"https://en.wikivoyage.org/wiki/Beach_Cities","title":"Beach Cities","snippet":"33.541-117.7843 Laguna Beach - A resort town with popular beaches and numerous luxury resorts. 33.616-117.9314 Newport Beach - One of the wealthiest"},{"url":"https://en.wikivoyage.org/wiki/Virginia_Beach","title":"Virginia Beach","snippet":"Virginia beaches.   36.8382-75.9719511 SpringHill Suites Virginia Beach Oceanfront, 901 Atlantic Avenue, ☏ +1 757-417-3982. Located on Virginia Beach Boardwalk"},{"url":"https://en.wikivoyage.org/wiki/Goa","title":"Goa","snippet":"check Arambol beach in North Goa for tandem paragliders. Relax at the beaches — Goa has an almost unbroken 70 km coastline of beaches. Don't forget to"},{"url":"https://en.wikivoyage.org/wiki/San_Diego%2FMission_Beach-Pacific_Beach","title":"San Diego/Mission Beach-Pacific Beach","snippet":"Mission Beach and Pacific Beach are the two most popular beach neighborhoods in San Diego. Nestled between the ocean and the man-made Mission Bay, this"}]},"meta":{"timestamp":"2026-06-01T16:23:46.728Z","request_id":"dc363c08-3e3f-4a5a-9e67-179f3dd8d8d5"},"status":"ok","message":"Search results retrieved","success":true}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}},"/v1/meta":{"get":{"operationId":"get_v1_meta","tags":["Meta"],"summary":"Usage notes","description":"","parameters":[],"security":[{"oanorKey":[]}],"responses":{"200":{"description":"OK","content":{"application/json":{"example":{"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}}}},"401":{"description":"Missing or invalid x-oanor-key header"},"402":{"description":"Active subscription required"},"429":{"description":"Rate-limit or monthly quota reached"},"502":{"description":"Upstream did not respond"}}}}},"x-oanor-pricing":[{"slug":"free","name":"Free","price_cents_month":0,"monthly_call_quota":3000,"rps_limit":2,"hard_limit":true},{"slug":"starter","name":"Starter","price_cents_month":750,"monthly_call_quota":55000,"rps_limit":5,"hard_limit":true},{"slug":"pro","name":"Pro","price_cents_month":2250,"monthly_call_quota":240000,"rps_limit":12,"hard_limit":true},{"slug":"mega","name":"Mega","price_cents_month":6100,"monthly_call_quota":850000,"rps_limit":35,"hard_limit":true}],"x-oanor-marketplace-url":"https://www.oanor.com/api/wikivoyage-api"}