Gathern Scraper 🇸🇦 — Saudi Vacation Rentals Data & API 🏖️

🎉 Turn Gathern listings into clean structured data — Saudi vacation rentals, every city, no API key

Built for STR analysts, proptech teams, travel-tech startups and investors who need Saudi short-term-rental data at scale

---

📋 Overview

Scrape Gathern — Saudi Arabia's leading short-term & vacation-rental marketplace — into ready-to-use datasets. Pull thousands of rental units with nightly price (SAR), guest capacity, beds, rating and reviews, amenities, district, GPS coordinates and the full photo gallery — as JSON, CSV or Excel.

Why STR analysts and travel-tech teams choose us:

• ✅ Complete units: up to 56 fields per rental — nightly + total price, service/VAT split, capacity, beds, area, rating, reviews, amenities, GPS, district, photos
• ⚡ Fast & affordable: harvest whole-city inventory in seconds — the cheapest way to gather Saudi vacation-rental data at volume
• 🏝️ Every unit type: chalets, istraha (rest houses), serviced apartments, resorts, camps, farms — filter to exactly what you need
• 🇸🇦 Bilingual by default: city, district and unit-type names in both Arabic and English on every row
• 📅 Date-aware pricing: set check-in / check-out and get nightly price and availability for those exact nights
• 💸 Pay-per-result: only pay for units you actually extract — generous FREE tier, no credit card to start
• ✨ Investor KPIs built in: automatic price-per-guest (SAR) and a thumbnail-first row for instant gallery views

---

✨ Features

• 🏖️ Saudi short-term rentals: chalets, istraha, serviced apartments, resorts and camps in one actor
• 🏙️ Search by city or URL: type a Saudi city name, or paste a gathern.co search URL
• 💵 Full nightly pricing: nightly price, averaged price, pre-discount price, service + VAT, total with services (SAR)
• 👥 Capacity & specs: max guests, bedrooms, master & single beds, bathrooms, area (m²)
• ⭐ Ratings & demand: 0–10 guest rating, review count, booking count, view count
• 🧭 Geo data: city, district and neighbourhood (Arabic + English), latitude & longitude
• 🗓️ Availability: free-cancellation, insurance and instant-book flags; check-in / check-out for the searched dates
• 📸 Full photo gallery: every unit image URL, plus a cover thumbnail
• 🏗️ Amenities & features: amenity titles and feature chips per unit
• 📊 Computed KPIs: price-per-guest in SAR, ready for yield and rate models
• 📤 Clean exports: JSON, CSV and Excel directly from the dataset

---

🎬 Quick Start

Tell it where to look (a Saudi city name or a search URL), optionally pick a unit type and dates, and run. Results stream into your dataset as clean rows you can export to JSON, CSV or Excel.

curl -X POST https://api.apify.com/v2/acts/sian.agency~gathern-property-scraper/runs?token=YOUR_TOKEN \
-H 'Content-Type: application/json' \
-d '{"searchMode":"byCity","cities":["Riyadh"],"maxResults":100}'

---

🚀 Getting Started (3 Simple Steps)

Step 1: Choose how to search

Search by city (type Saudi city names like Riyadh, Jeddah, Dammam) or by search URL (paste a gathern.co search-results link).

Step 2: Narrow it down (optional)

Pick a unit type (chalet, istraha, apartment, resort, camp…), set check-in / check-out dates, choose a language and sort order.

Step 3: Run it

Click Start (or call the API). Rental units stream into your dataset in real time.

That's it! In under a minute, you'll have:

• A clean table of Saudi rental units with nightly prices and specs
• Capacity, rating, GPS, district and the full amenity & photo list
• A JSON / CSV / Excel export ready for your model or app

---

📥 Input Configuration

Field	Type	Required	Description
searchMode	string	No	byCity or bySearchUrl. Default byCity.
cities	array	No	Saudi city names (English or Arabic), e.g. Riyadh, Jeddah, الرياض.
unitType	string	No	resort, chalet, istraha, apartment, camp, farm, hotel, serviced-apartment.
checkIn / checkOut	string	No	YYYY-MM-DD dates — nightly price & availability for those nights.
lang	string	No	en or ar. Default en.
sort	string	No	points, price, rate, newest. Default points.
searchUrls	array	No	gathern.co search-results URLs.
maxResults	integer	No	Cap units per run. FREE: 25. PAID: unlimited.
maxPages	integer	No	Max search pages per city (10 units each). Default 20.
proxyCountry	string	No	Empty = direct (default). SA routes through a Saudi residential proxy for very large runs.

Example — by city:

{
  "searchMode": "byCity",
  "cities": ["Riyadh", "Jeddah"],
  "unitType": "chalet",
  "checkIn": "2026-07-01",
  "checkOut": "2026-07-03",
  "sort": "rate",
  "maxResults": 200
}

Example — by search URL:

{
  "searchMode": "bySearchUrl",
  "searchUrls": ["https://gathern.co/search?city=3&chalet_cats[]=2"]
}

---

📤 Output

Results are saved to the Apify dataset with 56 fields including:

Field	Type	Description
listingId	integer	Gathern rental-unit identifier
url	string	Canonical unit URL
propertyTitle	string	Unit title
unit_type / unit_type_ar	string	Unit type (Apartment, Chalet, Istraha, Resort, Camp…) — English & Arabic
nightly_price	number	Nightly price (SAR) for the searched dates
total_price_with_services	number	Total nightly price incl. service + VAT
price_per_guest_sar	integer	Computed nightly price per max guest
capacity / bedrooms / bathrooms	integer	Guest capacity & specs
area_sqm	integer	Unit area (m²)
rating / reviews_count	number	Guest rating (0–10) & review count
city / city_ar / district / district_ar	string	Location (English & Arabic)
latitude / longitude	number	GPS coordinates
amenities / features	array	Amenity titles & feature chips
photos	array	Full-resolution image URLs
thumbnail / cover_photo	string	Cover image

Example:

{
  "listingId": 253489,
  "url": "https://gathern.co/view/181254/unit/253489",
  "propertyTitle": "Apartment with Living Room",
  "unit_type": "Apartment",
  "unit_type_ar": "شقة",
  "currency": "SAR",
  "nightly_price": 449,
  "total_price_with_services": 565.74,
  "price_per_guest_sar": null,
  "bedrooms": 1,
  "bathrooms": 1,
  "area_sqm": 55,
  "rating": 10,
  "reviews_count": 2,
  "city": "Riyadh",
  "city_ar": "الرياض",
  "district": "Al Aqeeq Dist.",
  "latitude": 24.77993,
  "longitude": 46.62418,
  "amenities": ["55", "1", "1"],
  "photo_count": 6,
  "thumbnail": "https://img.gathern.co/1400x0/1/v0KR43VcfAaQREyLXBzC9nuSLsj7d2M_.jpg"
}

---

💼 Use Cases & Examples

1. Short-Term-Rental Yield & Revenue Models

STR investors and analysts modelling Saudi vacation-rental returns.

Input: A list of city names and a unit type. Output: Nightly price, capacity, rating and computed SAR-per-guest per unit. Use: Build nightly-rate, occupancy-proxy and revenue models across Saudi cities.

2. Nightly-Rate Comparables

Hosts and revenue managers pricing their own units.

Input: A search URL for a city and unit type. Output: Comparable units with nightly price, rating and amenities. Use: Set competitive rates against live local supply.

3. Travel-Tech & Booking Apps

Travel startups building Saudi vacation-rental products.

Input: Programmatic API calls per city. Output: Structured JSON with prices, geo and media ready to ingest. Use: Back a search or comparison app with live Saudi rental data.

4. Market Research & Tourism Dashboards

Data teams tracking Saudi Arabia's Vision-2030 tourism boom.

Input: Scheduled daily runs across multiple cities. Output: A time series of nightly rates, inventory and ratings. Use: Power BI / Looker dashboards on supply, pricing and demand.

5. Amenity & Rating Analysis

Proptech and hospitality teams benchmarking quality.

Input: By-city searches with sort by rating. Output: Units with amenity lists, ratings and review counts. Use: Find what amenities correlate with higher rates and ratings.

6. Powering a Saudi Rental Data API

Companies needing a live feed of Saudi short-term-rental supply.

Input: Programmatic API calls per region. Output: Clean structured JSON ready to serve. Use: Back a valuation or availability API with current Gathern data.

---

🔗 Integration Examples

JavaScript/Node.js

import { ApifyClient } from 'apify-client';
const client = new ApifyClient({ token: 'YOUR_TOKEN' });

const run = await client.actor('sian.agency/gathern-property-scraper').call({
  searchMode: 'byCity',
  cities: ['Riyadh'],
  maxResults: 100,
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items[0]);

Python

from apify_client import ApifyClient
client = ApifyClient('YOUR_TOKEN')

run = client.actor('sian.agency/gathern-property-scraper').call(
    run_input={
        'searchMode': 'byCity',
        'cities': ['Riyadh'],
        'maxResults': 100,
    }
)

for item in client.dataset(run['defaultDatasetId']).iterate_items():
    print(item)

cURL

curl -X POST 'https://api.apify.com/v2/acts/sian.agency~gathern-property-scraper/runs?token=YOUR_TOKEN' \
-H 'Content-Type: application/json' \
-d '{"searchMode":"byCity","cities":["Riyadh"],"maxResults":100}'

Automation Workflows (N8N / Zapier / Make)

1. Trigger: Schedule (e.g. daily) or webhook
2. HTTP Request: Call the actor API
3. Process: Handle the JSON results
4. Action: Save to a sheet, push to a dashboard, or send an alert

---

📊 Performance & Pricing

FREE Tier (Try It Now)

• 25 units per run — full feature access, same data quality
• No credit card required
• Perfect for testing and small projects

PAID Tier (Production Ready)

• Unlimited units per run
• Pay-per-result: only charged for units successfully extracted
• Ideal for dashboards, comparables and data APIs

💰 Transparent pay-per-result pricing — harvest Saudi vacation-rental data at volume and only pay for the units you actually extract.

🔗 View current pricing

---

❓ Frequently Asked Questions

Q: How many units can I extract? A: FREE tier: 25 per run. PAID tier: unlimited.

Q: What unit types are covered? A: Chalets, istraha (rest houses), serviced apartments, resorts, camps, farms, hotels — filter with unitType, or leave it empty for all.

Q: Can I get prices for specific dates? A: Yes — set checkIn and checkOut (YYYY-MM-DD) and nightly price and availability reflect those nights.

Q: Does it support Arabic? A: Yes — set lang to ar for Arabic geo/type names. Both Arabic and English location fields are always populated.

Q: What output formats are available? A: JSON, CSV and Excel — export directly from the Apify dataset.

Q: Do I need a Gathern account or API key? A: No. The actor works straight out of the box.

Q: What currency are prices in? A: Saudi Riyal (SAR), as published on Gathern.

Q: Is this legal? A: We only extract publicly available listing data. See the legal note below.

---

🐛 Troubleshooting

No results returned

• Check your city name — try the common English spelling (Riyadh, Jeddah, Dammam) or the Arabic name.
• If you set check-in / check-out, make sure units are actually available for those dates.

Fewer rows than expected

• Each search page returns 10 units. Add more cities or raise Max pages to gather more units.
• A single city query is capped by the marketplace at a few thousand units — add a unit-type filter or date band to slice deeper.

Large runs slowing down

• Set proxyCountry to SA to route through a Saudi residential proxy and avoid IP rate-limits at scale.

---

⚖️ Is it legal to scrape data?

Our actors are ethical and do not extract any private user data, such as email addresses, gender, or location. They only extract what the user has chosen to share publicly. We therefore believe that our actors, when used for ethical purposes by Apify users, are safe.

However, you should be aware that your results could contain personal data. Personal data is protected by the GDPR in the European Union and by other regulations around the world. You should not scrape personal data unless you have a legitimate reason to do so. If you're unsure whether your reason is legitimate, consult your lawyers.

You can also read Apify's blog post on the legality of web scraping.

Disclaimer: This actor is an independent tool and is not affiliated with, endorsed by, or sponsored by Gathern. "Gathern" and related marks are trademarks of their respective owners. Use this actor in compliance with Gathern's terms and all applicable laws.

---

🤝 Support

Join our active support community

• For issues or questions, open an issue in the actor's repository
• Check the SIÁN Agency Store for more automation tools
• 📧 apify@sian-agency.online

---

Built by SIÁN Agency | More Tools