Retreat Guru LATAM Yoga & Meditation Retreat Scraper

Scrape yoga, meditation, ayahuasca, and wellness retreat listings from retreat.guru across 12 Latin American countries. Extracts structured event data including dates, pricing, ratings, location, and teacher info.

What it does

This actor crawls retreat.guru's country and style-filtered listing pages for 12 LATAM markets — Mexico, Costa Rica, Brazil, Peru, Argentina, Colombia, Ecuador, Bolivia, Uruguay, Chile, Guatemala, and Nicaragua — and returns one record per retreat event. It extracts data from inline JSON-LD Event schema blocks on each detail page, supplemented by HTML parsing for room options, participant limits, and retreat center links.

Coverage: ~3–5k LATAM retreat events across country × style combinations (yoga, ayahuasca, ayurveda, meditation, vipassana, tantra, breathwork, cacao).

Use cases

• Build retreat search and discovery products for the LATAM wellness tourism market
• Feed travel-affiliate sites with structured retreat inventory (dates, pricing, capacity)
• Track retreat pricing trends and availability across LATAM destinations
• Enrich wellness tourism databases with Retreat Guru's verified listings
• Research the LATAM yoga and meditation retreat market ($4B+ inbound segment)

Input

Field	Type	Description	Default
maxItems	integer	Maximum number of retreat records to return	required
countries	array	LATAM country slugs to scrape (see below)	all 12
styles	array	Retreat style filters to apply (see below)	all 8

Supported country slugs

mexico, costa-rica, brazil, peru, argentina, colombia, ecuador, bolivia, uruguay, chile, guatemala, nicaragua

Supported style slugs

yoga, ayahuasca, ayurveda, meditation, vipassana, tantra, breathwork, cacao

Example input

{
  "maxItems": 100,
  "countries": ["mexico", "peru", "costa-rica"],
  "styles": ["yoga", "meditation", "ayahuasca"]
}

To scrape all available LATAM retreats:

{
  "maxItems": 5000
}

Output

Each record represents one retreat event. Records are deduplicated by retreat GID across all country and style pages.

Field	Type	Description
event_gid	string	Unique event identifier from retreat.guru (e.g. 1524-751)
title	string	Retreat event title
url	string	Full URL of the event detail page
retreat_center	string	Name of the retreat center or organizer
retreat_center_url	string	URL of the retreat center profile on retreat.guru
country	string	Country where the retreat is located
region_or_state	string	State or region within the country
city	string	City where the retreat takes place
venue	string	Venue or place name
styles	string	Retreat style tags as comma-separated string
start_date	string	Start date in ISO 8601 format (YYYY-MM-DD)
end_date	string	End date in ISO 8601 format (YYYY-MM-DD)
nights	integer	Duration in nights
price_from_usd	number	Starting price in USD
price_currency	string	Original price currency code
room_options	string	Available accommodation options as comma-separated string
participant_max	integer	Maximum number of participants
teacher_names	string	Retreat center / organizer name
teacher_bios_url	string	Link to the retreat center profile
listing_image_url	string	URL of the primary listing image
description	string	Full text description of the retreat
rating	number	Average rating (0–5 scale)
reviews_count	integer	Total number of reviews
listed_at	string	Listing availability date
scraped_at	string	ISO 8601 timestamp of when this record was scraped

Example record

{
  "event_gid": "1524-751",
  "title": "7 Day Peyote, Psilocybin and Bufo Alvarius Retreat (July 20 - 26th)",
  "url": "https://retreat.guru/events/1524-751/...",
  "retreat_center": "Arkana Spiritual Center",
  "retreat_center_url": "https://retreat.guru/centers/1524-1/arkana-spiritual-center",
  "country": "Mexico",
  "region_or_state": "State of Mexico",
  "city": "Valle de Bravo",
  "venue": "Arkana Spiritual Center",
  "styles": "peyote",
  "start_date": "2026-07-20",
  "end_date": "2026-07-26",
  "nights": 6,
  "price_from_usd": 3960,
  "price_currency": "USD",
  "room_options": "AVB Double Shared, AVB Double Private (2ppl), AVB Single Private",
  "participant_max": 22,
  "rating": 5.0,
  "reviews_count": 205,
  "listed_at": "2026-07-20",
  "scraped_at": "2026-05-30T19:33:00.482Z"
}

How it works

1. Generates listing URLs for each configured country and country × style filter combination
2. For each listing page, extracts all JSON-LD Event schema blocks and deduplicates by retreat GID
3. Enqueues each unique retreat's detail page for full data extraction
4. On each detail page, parses the JSON-LD microdata block for structured fields, supplemented by HTML parsing for accommodation options, participant limits, and retreat center links
5. Paginates listing pages (?page=N) until maxItems is reached or no new events are found

Notes

• Languages is null — retreat.guru does not expose language tags in a structured format
• Inclusions (meals, transport, etc.) are embedded in the description text rather than structured fields
• Records are globally deduplicated: a retreat appearing in both /be/mexico-retreats and /be/yoga-retreats-in-mexico is returned only once
• The actor respects retreat.guru's robots.txt crawl-delay by running at low concurrency