💫 GetYourGuide Activities Scraper ## 📋 Table of Contents - About GetYourGuide - About This Actor - Features - Input Parameters - Usage Examples - Output Data - Use Cases - Advanced Usage - Technical Details - Troubleshooting - Support --- ## 🌍 About GetYourGuide GetYourGuide is a Berlin-based startup online marketplace for travel activities. GetYourGuide sells tours and excursions, activities including cooking classes, and tickets to tourist attractions. It offers more than 60,000 products worldwide in 150 countries, 22 languages, and 40 currencies. --- ## 🤖 About This Actor Universal GetYourGuide.com Scraper for Global Activities This powerful Apify Actor allows you to extract comprehensive activity data from GetYourGuide.com for any destination worldwide. Perfect for travel agencies, affiliate marketers, content creators, and market researchers. ### ✨ Features - 🌐 Global Coverage: Extract activities from any city worldwide - 🗣️ Multi-language Support: All 22 GetYourGuide languages supported - 💱 Multi-currency Support: All 40 GetYourGuide currencies supported - 🔗 Affiliate Integration: Automatic affiliate link generation - 📊 Comprehensive Data: Prices, ratings, reviews, descriptions, highlights - 🖼️ High-Quality Photos: Extract all activity images - ⚡ Fast & Reliable: Optimized for performance and stability ### ⚠️ Important Notes - 💡 Apify Proxy required for optimal performance - 💡 Respects GetYourGuide's robots.txt and rate limiting - 💡 Works with any city available on GetYourGuide - 💡 Real-time data extraction --- ## 📥 Input Parameters | Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | destinationCity | string | ✅ Yes | - | Destination city name (e.g., "Dubai", "Paris", "Tokyo") | | partnerID | string | ✅ Yes | - | Your GetYourGuide affiliate partner ID | | activityLimit | number | ❌ No | 10 | Maximum number of activities to extract | | language | string | ❌ No | "pt-BR" | Language code (see supported languages below) | | currency | string | ❌ No | "JPY" | Currency code (see supported currencies below) | ### 🗣️ Supported Languages (22) en, en-US, de, es, fr, it, pt-BR, nl, pl, sv, da, fi, no, zh-CN, zh-TW, ja, ko, th, id, vi, cs, ru ### 💱 Supported Currencies (40) USD, EUR, GBP, AUD, CAD, NZD, SGD, HKD, JPY, KRW, CNY, TWD, THB, MYR, IDR, PHP, VND, INR, AED, SAR, QAR, KWD, BHD, OMR, JOD, ILS, EGP, MAD, ZAR, NGN, KES, GHS, TZS, UGX, RWF, MXN, BRL, ARS, CLP, COP, PEN --- ## 🚀 Usage Examples ### Example 1: Dubai Activities (Japanese Market) json { "destinationCity": "Dubai", "partnerID": "QOJ6RGE", "activityLimit": 10, "language": "pt-BR", "currency": "JPY" } ### Example 2: Paris Activities (French Market) json { "destinationCity": "Paris", "partnerID": "YOUR_PARTNER_ID", "activityLimit": 20, "language": "fr", "currency": "EUR" } ### Example 3: New York Activities (US Market) json { "destinationCity": "New York", "partnerID": "YOUR_PARTNER_ID", "activityLimit": 15, "language": "en-US", "currency": "USD" } ### Example 4: Tokyo Activities (Japanese Market) json { "destinationCity": "Tokyo", "partnerID": "YOUR_PARTNER_ID", "activityLimit": 25, "language": "ja", "currency": "JPY" } ### Example 5: Barcelona Activities (Spanish Market) json { "destinationCity": "Barcelona", "partnerID": "YOUR_PARTNER_ID", "activityLimit": 30, "language": "es", "currency": "EUR" } ### Example 6: Bangkok Activities (Thai Market) json { "destinationCity": "Bangkok", "partnerID": "YOUR_PARTNER_ID", "activityLimit": 50, "language": "th", "currency": "THB" } --- ## 📤 Output Data The Actor returns a JSON array with detailed activity information. ### Output Fields | Field | Type | Description | |-------|------|-------------| | activityUrl | string | Original GetYourGuide activity URL | | affiliateLink | string | Affiliate link with your partner ID | | title | string | Activity title in selected language | | price | string | Activity price formatted | | currency | string | Price currency code | | rating | string | Activity rating (0-5) | | reviewCount | string | Number of customer reviews | | highlights | array | List of activity highlights | | fullDescription | string | Complete activity description | | included | array | What's included in the activity | | notIncluded | array | What's not included | | photos | array | URLs of high-resolution activity photos | | scrapedAt | string | ISO timestamp of data extraction | ### Sample Output json [ { "activityUrl": "https://www.getyourguide.com/pt-br/dubai-l173/dubai-burj-khalifa-sky-nivel-148-124-e-125-ingresso-t49181/", "affiliateLink": "https://www.getyourguide.com/pt-br/dubai-l173/dubai-burj-khalifa-sky-nivel-148-124-e-125-ingresso-t49181/?partner_id=QOJ6RGE&utm_medium=travel_agent", "title": "Dubai: Burj Khalifa Sky Level 148, 124 e 125 Ingresso", "price": "¥ 16.245", "currency": "JPY", "rating": "4.6", "reviewCount": "21.267 avaliações", "highlights": [ "Evite as multidões e acesse o mirante mais alto do mundo", "Evite as filas para o controle de segurança e elevador", "Assista ao show da Fonte de Dubai com música sincronizada", "Escolha a opção do pôr do sol para vistas garantidas da cidade na hora dourada", "Viagem pela construção histórica do Burj Khalifa na exposição do andar térreo" ], "fullDescription": "Evite as multidões e desfrute de uma experiência premium nos 124º, 125º e 148º andares do Burj Khalifa...", "included": [ "Taxas de admissão para o SKY Level 148 e Levels 124 e 125", "Acesso sem fila para segurança e elevador", "Tour introdutório com um embaixador convidado", "Acesso ao Lounge com lanches e bebidas quentes", "Estações interativas", "Acesso ao deck de observação", "Wi-Fi em toda a atração" ], "notIncluded": [ "Guia", "Guia de áudio" ], "photos": [ "https://cdn.getyourguide.com/image/format=auto,fit=crop,gravity=auto,quality=60,width=450,height=450,dpr=2/tour_img/d133141a03458020c7428194349ca70010928685d8f2ba665505fea96db34131.jpg", "https://cdn.getyourguide.com/image/format=auto,fit=crop,gravity=auto,quality=60,width=450,height=450,dpr=2/tour_img/2b54202dbbb9d54867c3ccd4bfdca984f4154567f3dee75c5b1a44915e021194.jpg" ], "scrapedAt": "2025-10-06T14:55:59.038Z" } ] --- ## 💼 Use Cases ### Perfect For: - 🏢 Travel Agencies: Automated activity data collection for any destination worldwide - 💰 Affiliate Marketers: Generate affiliate links automatically with your partner ID - 📊 Price Monitoring: Track activity prices across different currencies and markets - ✍️ Content Creators: Gather detailed tour information for travel blogs and websites - 🔍 Market Research: Analyze tourism offerings and trends globally - ⚖️ Comparison Sites: Build comprehensive activity comparison databases - 🌐 Multi-language Platforms: Support international audiences with localized content - 📱 Travel Apps: Integrate real-time activity data into mobile applications - 🏛️ Tourism Boards: Monitor and analyze local tourism offerings - 📈 Business Intelligence: Analyze pricing strategies across different markets --- ## 🎓 Advanced Usage ### Finding City Names - Use the exact city name as it appears on GetYourGuide.com - Examples: - ✅ "New York" (not "NYC") - ✅ "São Paulo" (not "Sao Paulo") - For best results, check the city URL on GetYourGuide first ### Getting Your Partner ID 1. Sign up for GetYourGuide Affiliate Program 2. Access your affiliate dashboard 3. Copy your unique Partner ID 4. Use it in the partnerID field ### Optimizing Results - Small datasets (10-20 activities): Fast extraction, good for testing - Medium datasets (20-50 activities): Balanced speed and comprehensiveness - Large datasets (50+ activities): Complete market overview, longer runtime ### Language & Currency Strategy Match language and currency to your target market: | Target Market | Language | Currency | Example | |---------------|----------|----------|---------| | Japanese tourists | ja | JPY | Tokyo attractions | | European travelers | en | EUR | Paris tours | | US market | en-US | USD | New York activities | | Brazilian market | pt-BR | BRL | Rio tours | | Chinese tourists | zh-CN | CNY | Dubai experiences | ### Popular Destinations #### 🌍 Europe London, Paris, Rome, Barcelona, Amsterdam, Prague, Vienna, Berlin, Lisbon, Athens, Dublin, Edinburgh, Stockholm, Copenhagen #### 🌏 Asia Tokyo, Bangkok, Singapore, Dubai, Hong Kong, Seoul, Bali, Phuket, Mumbai, Shanghai, Kyoto, Osaka, Kuala Lumpur #### 🌎 Americas New York, Las Vegas, Miami, Los Angeles, Cancun, Rio de Janeiro, Buenos Aires, Toronto, Vancouver, Mexico City #### 🌍 Middle East & Africa Dubai, Abu Dhabi, Cairo, Cape Town, Marrakech, Jerusalem, Istanbul, Doha #### 🌊 Oceania Sydney, Melbourne, Auckland, Gold Coast, Queenstown, Perth --- ## ⚙️ Technical Details ### System Requirements - Maximum Results: Unlimited - Build Version: 0.0.113 - Timeout: 360s (6 minutes) - Memory: 4 GB - Proxy: Required (Apify Proxy recommended) ### Performance Characteristics - Average Runtime: 2-5 minutes for 10 activities - Concurrent Requests: Optimized for rate limiting - Data Freshness: Real-time extraction from GetYourGuide - Success Rate: 95%+ under normal conditions ### Performance Tips ✅ Do: - Use appropriate activity limits to optimize runtime - Enable Apify proxy to avoid IP blocking - Schedule regular runs for price monitoring - Implement error handling in your workflows ❌ Don't: - Request excessive data in a single run - Run without proxy configuration - Use invalid partner IDs - Ignore rate limiting warnings --- ## 🔧 Troubleshooting ### Common Issues & Solutions #### ❌ No activities returned Possible Causes: - Invalid city name - City not available on GetYourGuide Solutions: - Verify destination city name matches GetYourGuide's spelling exactly - Check if the city exists on GetYourGuide.com - Try alternative city name spellings #### ❌ Proxy errors Possible Causes: - Apify proxy not enabled - IP blocked by GetYourGuide Solutions: - Enable Apify proxy in actor settings - Use residential proxies for better results - Reduce request frequency #### ❌ Incomplete data Possible Causes: - Some activities have limited information - Network issues during scraping Solutions: - This is normal - not all activities have complete data - Implement data validation in your workflows - Filter out incomplete results if needed #### ❌ Wrong language/currency Possible Causes: - Invalid language or currency code - Typo in input parameters Solutions: - Check that language and currency codes are from the supported lists - Use exact codes as listed (case-sensitive) #### ❌ Affiliate links not working Possible Causes: - Invalid partner ID - Partner ID not active Solutions: - Verify your partner ID is correct - Ensure your GetYourGuide affiliate account is active - Contact GetYourGuide affiliate support if issues persist --- ## 📞 Support ### Need Help? Feel free to reach out to the developer for: - ❓ Questions about usage - 🐛 Bug reports - 💡 Feature suggestions - 🤝 Integration support ### Before Contacting Support Please check: 1. Input parameters are correctly formatted 2. City name is spelled correctly 3. Partner ID is valid and active 4. Apify proxy is enabled 5. You have sufficient Apify credits ### Reporting Issues When reporting issues, please include: - Input parameters used - Error messages (if any) - Expected vs actual behavior - Screenshots (if applicable) --- ## 📄 Legal & Compliance Important Notice: This actor extracts publicly available data from GetYourGuide.com. By using this actor, you agree to: - ✅ Comply with GetYourGuide's Terms of Service - ✅ Use data responsibly and ethically - ✅ Respect rate limits and robots.txt - ✅ Use only valid affiliate partner IDs obtained through official GetYourGuide partnership programs - ✅ Not use data for malicious purposes --- ## 🔄 Version History ### v0.0.113 (Current) - ✨ Initial release - 🌐 Support for all GetYourGuide destinations - 🗣️ 22 languages supported - 💱 40 currencies supported - 🔗 Automatic affiliate link generation - 📊 Comprehensive data extraction --- ## 🙏 Credits Developed with ❤️ for the travel and tourism industry. Powered by: - Apify - Web scraping and automation platform - GetYourGuide - Travel activities marketplace --- ## 📚 Additional Resources - GetYourGuide Affiliate Program - Apify Documentation - GetYourGuide API Documentation --- ⭐ If you find this actor useful, please star it on Apify Store! --- Last Updated: October 2025