Wikivoyage Travel Articles Scraper
parseforge/wikivoyage-articles-scraper
TravelEducationOther
Scrapes full Wikivoyage travel articles by destination title or keyword search in any supported language. Returns each guide as a flat row with complete text and metadata.
- Total users
- 2
- Monthly active
- 1
- Total runs
- 126
- Bookmarked
- 0
- Rating
- Not rated yet
- Last modified
- 12 days ago
Overview
Wikivoyage Travel Articles Scraper
Scrape full Wikivoyage travel articles by destination title or keyword search, in any supported language. Each article returns its complete guide text, sections, and metadata. No API key or authentication required. Export to JSON, CSV, Excel, or XML.
Wikivoyage is the free, crowd-sourced travel guide with over 30,000 destination articles, but there is no official API for bulk access. This Actor reads the public wiki directly, letting you pull complete articles by exact title or discover them through keyword search. You get the full structured content of each guide in one consistent row, ready for analysis or content pipelines.
| Who uses it | What they scrape Wikivoyage for |
|---|---|
| Travel content creators | Build destination databases for travel apps and websites. |
| Data analysts | Compare destination descriptions and practical information across regions. |
| Language researchers | Gather parallel travel corpora in multiple languages for NLP tasks. |
| SEO specialists | Extract structured location content for travel-related landing pages. |
What it does
This Actor collects Wikivoyage travel articles by direct title lookup or keyword search and returns each one as a flat row with its full text and metadata.
- π Direct title lookup: Provide a list of exact Wikivoyage article titles, one per line, and get each full guide back.
- π Keyword search mode: Enter a destination or keyword and the Actor finds matching articles via Wikivoyage's OpenSearch, then fetches their summaries.
- π Multi-language support: Set any ISO 639-1 language code (en, es, fr, de, it, pt, ru, ja, zh, and more) to scrape the corresponding Wikivoyage edition.
- βοΈ Flexible volume control: Set a maximum article count from 1 up to 1,000,000 per run to match your project's scope.
Results export to CSV, JSON, Excel, or XML, or straight from the API.
What you can do with Wikivoyage data
βοΈ Build a destination content database.
A travel startup pulls full Wikivoyage guides for 500 cities across 10 languages to seed their app's destination pages.
π Analyze travel guide structure.
A researcher collects articles for 200 destinations and compares which sections (Eat, Sleep, See) are most developed by region.
π Create multilingual travel datasets.
An NLP engineer scrapes the same destination articles in English, German, and Japanese to build a parallel corpus for machine translation.
π Generate location-specific content briefs.
An SEO content manager extracts practical information from Wikivoyage guides to inform writers creating city-specific blog posts.
Why choose this scraper
| What you get | |
|---|---|
| Full article text | The complete guide content, not a snippet or summary. |
| Structured output | Every article lands as a flat row with consistent fields for easy processing. |
| No authentication | Reads the public wiki directly with no API key, OAuth, or login. |
| Language coverage | Works with every Wikivoyage language edition that exists. |
How it compares
This Actor focuses on direct article retrieval by title or keyword with full text output, while other Wikivoyage scrapers on Apify offer additional browsing features like country listings and featured destinations.
| Feature | ParseForge | WikiVoyage Travel Guides Scraper | Wikivoyage Travel Guide Scraper |
|---|---|---|---|
| Direct title lookup | Yes, provide exact titles one per line | Not listed | Not listed |
| Keyword search mode | Yes, via Wikivoyage OpenSearch | Yes | Not listed |
| Full article text | Yes, complete guide content | Yes | Not listed |
| Multi-language support | Any Wikivoyage language edition | Yes, 11 languages | Not listed |
| Browse featured destinations | Not listed | Yes | Not listed |
| List countries and cities | Not listed | Yes | Not listed |
Configure the run
Drive the Actor with a list of exact article titles or a free-text keyword, choose a Wikivoyage language edition, and cap the total articles collected per run. The Input tab lists every parameter.
A first run with the defaults:
{
"maxItems": 10,
"mode": "lookup",
"titles": "Tokyo\nParis\nBarcelona\nNew York City\nKyoto",
"query": "Italy",
"language": "en"
}
A larger pull:
{
"maxItems": 200,
"mode": "lookup",
"titles": "Tokyo\nParis\nBarcelona\nNew York City\nKyoto",
"query": "Italy",
"language": "en"
}
Pricing
Pay-per-result: $0.01333 per result collected. You pay only for the results written to your dataset.
| Results collected | Approximate cost |
|---|---|
| 100 results | $1.33 |
| 1,000 results | $13.33 |
| 10,000 results | $133.30 |
New Apify accounts start with $5 in free credit.
Free users
Free-plan runs return up to 10 results as a preview. Upgrade your Apify plan to collect up to 1,000,000 results per run.
Run it
- Create a free Apify account with $5 in credit.
- Open the Wikivoyage Travel Articles Scraper.
- Set your inputs and any filters, then click Start.
- Export the results as CSV, Excel, JSON, or XML from the Dataset tab.
Run it programmatically through the Apify API (run-sync-get-dataset-items) or the ApifyClient for JavaScript and Python.
Use with AI agents (MCP)
Give an AI agent live access to Wikivoyage through the Model Context Protocol. Add the Actor to Claude, Cursor, or any MCP client:
claude mcp add --transport http apify "https://mcp.apify.com?tools=parseforge/wikivoyage-articles-scraper"
Then prompt it in plain language to run the scraper and read back the results.
Troubleshooting
Why am I getting no results for my titles?
Check that the article titles match Wikivoyage exactly, including capitalization, punctuation, and any parenthetical disambiguation like 'Paris' vs 'Paris (disambiguation)'. Also verify you are using the correct language code for the edition that contains the article.
Why does search mode return fewer results than I expected?
Wikivoyage's OpenSearch returns a limited set of matches. Try a more specific keyword or switch to lookup mode with a list of exact titles you have gathered manually.
Why do I get an error about an invalid language code?
Ensure you are using a valid ISO 639-1 two-letter code like 'en', 'fr', or 'ja'. Not all language codes have a corresponding Wikivoyage edition. Check wikivoyage.org to confirm the edition exists.
Why is the article text missing some sections?
Wikivoyage articles vary in completeness. Some destinations have sparse guides with only a few sections filled in. The Actor returns whatever content is present on the page.
Why does the run stop before reaching my max items?
The Actor stops when it has exhausted the titles you provided in lookup mode or when Wikivoyage's search returns no more matches. It will not invent articles beyond what exists.
FAQ
| Question | Answer |
|---|---|
| What is Wikivoyage? | Wikivoyage is a free, web-based travel guide for destinations worldwide, written by volunteers and hosted by the Wikimedia Foundation. It covers practical information like getting in, getting around, things to see and do, where to eat, and where to sleep. |
| Do I need an API key or login to use this Actor? | No. This Actor reads the public Wikivoyage website directly, so there is no API key, OAuth flow, or account registration required. |
| What languages does this Actor support? | It supports every language edition of Wikivoyage. You provide the ISO 639-1 language code (en, es, fr, de, it, pt, ru, ja, zh, etc.) and the Actor scrapes that edition. |
| What is the difference between lookup mode and search mode? | Lookup mode fetches articles by their exact Wikivoyage title, one per line. Search mode sends a free-text keyword to Wikivoyage's OpenSearch and retrieves the matching articles with their summaries. |
| How do I find the exact title of a Wikivoyage article? | Visit the Wikivoyage website in your chosen language and search for the destination. The article title appears at the top of the page. Copy it exactly, including any disambiguation in parentheses. |
| Does this Actor return the full article text? | Yes. Each row contains the complete guide content, including all sections like Understand, Get in, See, Do, Eat, Sleep, and more. |
| Can I limit how many articles are scraped? | Yes. Set the maximum articles field to any number from 1 to 1,000,000. The Actor stops after collecting that many articles. |
| What output formats are supported? | You can export your dataset to JSON, CSV, Excel, or XML from the Apify platform. |
| Is this Actor affiliated with Wikivoyage or the Wikimedia Foundation? | No. This is an independent scraper that reads publicly available web pages. It is not endorsed by or affiliated with Wikivoyage or the Wikimedia Foundation. |
| Can I scrape Wikivoyage listings for a whole country at once? | Wikivoyage organizes content by destination article, not by country-level listings. You can use search mode with a country name to find related articles, then feed those titles into lookup mode for full content. |
Related actors
Browse the full ParseForge collection for more scrapers.
π Need help? Email parseforge@protonmail.com with your run ID, your input, and what you expected.
β οΈ Disclaimer. This Actor is unofficial and is not affiliated with, endorsed by, or sponsored by Wikimedia Foundation, Inc. It collects only publicly available data. You are responsible for using the collected data in compliance with the source's terms of service and applicable data-protection laws, including GDPR, CCPA, and PIPL. Do not use it to collect personal data unlawfully.
Input
| Field | Type | What it does | Default |
|---|---|---|---|
| maxItems | integer | How many articles to collect per run. | 10 |
| mode | string (2 options) | lookup = direct titles; search = OpenSearch + summary fetch. | lookup |
| titles | string | Wikivoyage destination titles, one per line. | Tokyo Paris Barcelona New York City Kyot |
| query | string | Free-text destination search. | Italy |
| language | string | ISO 639-1 (en, es, fr, de, it, pt, ru, ja, zh, etc.). | en |
Pricing
from $10.00 per 1,000 results
| Charged for | What it is | Price each |
|---|---|---|
| Result item | Charged per record successfully returned in the dataset. | $0.01 to $0.01333 |
Tiered: the lower figure is the price on a higher Apify plan. Billing and the free credit live on Apify.
API
One POST returns the dataset directly. Same shape for every scraper in the library, so swapping the slug is the only change.
curl -X POST "https://api.apify.com/v2/acts/parseforge~wikivoyage-articles-scraper/run-sync-get-dataset-items?token=$APIFY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"helloWorld": 123
}' Examples
Input that runs as-is.
{
"helloWorld": 123
} Reviews
No reviews yet. Be the first.
Issues
We build and maintain this scraper, so a problem with it comes to us. Report it on the Apify listing and the thread stays attached to the scraper where the next person can find it: open an issue.
Broken and urgent, or you would rather not post in public? Write to parseforge@protonmail.com and it reaches the people who wrote it.
Related scrapers
Run Wikivoyage Travel Articles Scraper on Apify All scrapers
