Gathern Rental Listings Scraper

Collect public vacation-rental listings from Gathern’s public search data and listing details in Saudi Arabia, without logging in. On the Free plan, pricing is $0.00005 per Actor Start event plus $0.00785 per saved rental listing on Free.

• Extract rental titles, types, prices, service totals, capacities, ratings, and reviews.
• Compare rental prices and availability across Riyadh, Jeddah, and other searched cities.
• Build location datasets with cities, districts, coordinates, photos, and property features.
• Use descriptions, amenities, bedroom details, and cancellation fields for rental research and travel planning.
• Run city or public search-URL queries without logging in to Gathern; proxy use is optional.

What you get

The Actor reads Gathern’s public search results and listing details. Source-backed fields are emitted only when Gathern provides a value. The Actor also calculates price_per_guest_sar when nightly price and positive capacity are available.

Field or fields	Type	What it contains	Notes
listingId, url, propertyTitle	Integer; string	Listing identifier, Gathern listing URL, and property title	Required dataset fields
unit_type, unit_type_id	String; integer	Rental category and category ID	For example, apartment or chalet
currency	String	Listing currency	The Actor records SAR
nightly_price, price_before_discount, total_price_with_services	Number	Nightly, pre-discount, and service-inclusive prices	Values returned by the source
price_per_guest_sar	Number	Nightly price divided by capacity	Rounded to two decimals when calculated
capacity	Integer	Guest capacity
bedrooms, master_beds, single_beds, bathrooms	Integer	Bedroom, bed, and bathroom counts	Counts are extracted from listing data
area_sqm	Number	Property area in square metres
rating, reviews_count, booking_count, views_count	Number; integer	Rating, reviews, bookings, and views
city, city_ar, district, district_ar	String	English and Arabic location names
latitude, longitude	Number	Geographic coordinates
photos, thumbnail	Array; string	Photo URLs and thumbnail URL
features	Array of strings	Property features and amenities
description	String	Listing description
check_in, check_out	String	Selected stay dates returned by Gathern
available	Boolean	Availability value returned by Gathern
has_insurance, has_free_cancellation	Boolean	Insurance and free-cancellation values
scraped_at	String	UTC timestamp for record creation

Sample output

The sample is shortened by omitting minor fields; the values shown are copied exactly from one dataset record.

{
  "listingId": 277640,
  "url": "https://gathern.co/link/view?id=277640",
  "propertyTitle": "Apartment with Living Room",
  "unit_type": "Apartment",
  "currency": "SAR",
  "nightly_price": 300,
  "price_before_discount": 300,
  "total_price_with_services": 378,
  "price_per_guest_sar": 150,
  "capacity": 2,
  "rating": 10,
  "reviews_count": 1,
  "city": "Riyadh",
  "district": "Al Ghadeer Dist.",
  "latitude": 24.77799890874,
  "longitude": 46.661205478135
}

Pricing

This Actor charges per event. Charges are based on the following events:

Event	When it applies	Free-plan price
apify-actor-start	When the Actor starts running	$0.00005 per event on the Free plan
apify-default-dataset-item	One scraped result with all fields; one saved rental listing is one dataset item	$0.00785 per event on the Free plan

The number of Actor Start events depends on Actor memory, with a minimum of one event. A run with one Actor Start event and 50 saved results costs:

50 results = $0.39255 on Free
(50 × $0.00785) + $0.00005 = $0.39255 on Free

With one Actor Start event, the Free-plan calculations are:

1,000 results = $7.85005 on Free
(1,000 × $0.00785) + $0.00005 = $7.85005 on Free

10,000 results = $78.50005 on Free
(10,000 × $0.00785) + $0.00005 = $78.50005 on Free

The Apify Free plan includes $5 of monthly platform usage credit. With one Actor Start event, that credit covers exactly 636 saved results at the Free-plan event prices.

Platform usage such as compute, Apify Proxy traffic including residential traffic, and storage is included in the event prices and paid by the Actor developer. Buyers do not separately pay platform usage.

How to use

1. Choose byCity to search named cities, or choose bySearchUrl to use public Gathern search-result URLs.
2. Enter one or more city names in cities, or add public Gathern /search URLs in searchUrls.
3. Set optional city-search filters such as unitType, checkIn, checkOut, lang, and sort.
4. Limit pagination with maxPages and the number of unique saved listings with maxResults.
5. Configure optional Apify proxy settings, or set useApifyProxy to false to connect directly.
6. Repeat the run through Apify Schedules, using daily scheduling as a starting point for rental listings.

Example input:

{
  "searchMode": "byCity",
  "cities": ["Riyadh"],
  "unitType": "chalet",
  "lang": "en",
  "maxResults": 10,
  "proxyConfiguration": {
    "useApifyProxy": false
  }
}

Export the dataset as JSON or CSV, or read it through the Apify dataset API.

Input parameters

Parameter	What it does	Default
searchMode	Selects byCity or bySearchUrl.	byCity
cities	City names used in city mode. English and Arabic names are accepted.	["Riyadh"]
searchUrls	Public Gathern search URLs used in search-URL mode. Gathern /search URLs and supported query parameters are processed.	Not set
unitType	Optional rental category for city searches: resort, chalet, istraha, farm, camp, apartment, villa, room, studio, or serviced-apartment.	""
checkIn	Optional city-search check-in date in YYYY-MM-DD format.	Not set
checkOut	Optional city-search check-out date in YYYY-MM-DD format.	Not set
lang	Selects en or ar for text returned by Gathern.	en
sort	Sorts city searches by points, price, rate, or newest.	points
maxPages	Maximum number of search pages processed for each city or URL. Must be at least 1.	20
maxResults	Maximum number of unique rental listings saved across the run. Must be at least 1.	50
proxyConfiguration	Optional Apify proxy settings. The schema default uses useApifyProxy: true with the RESIDENTIAL group; set it to false or leave it empty to connect directly.	Apify proxy with RESIDENTIAL

Limits and edge cases

Condition	What the buyer sees	What to do
maxResults is reached	The Actor stops saving listings after the configured number of unique results across the run.	Increase maxResults for a larger dataset.
maxPages is reached	Pagination stops for that city or search URL even if more pages may exist.	Increase maxPages, which has a minimum of 1.
A search page returns no items or the source page count is reached	Pagination stops for that target.	Check the city, URL, dates, and filters, then run again if needed.
A search URL is not a public Gathern /search page	The URL is ignored and contributes no listings.	Use a public Gathern search-results URL.
A URL contains unsupported search parameters	Unsupported parameters are not translated into the search request.	Use filters represented by the supported Gathern search URL.
Gathern does not provide a field value	That field is omitted from the dataset record.	Use the fields available for each listing rather than expecting every record to have every field.
A search request fails on a target	A warning is logged and processing stops for that target; records already saved remain in the dataset.	Review the input and proxy configuration, then retry the run.
A listing-detail request fails	A warning is logged. A valid search result can still be saved, but detail fields may be absent; incomplete records without a listing ID or property title are skipped.	Retry the run if detail fields are needed.
The same listing appears in multiple targets	The Actor skips duplicate listing IDs and saves unique listings.	Use multiple targets when useful, while allowing for deduplication.

FAQ

How much does it cost to scrape Gathern rental listings?

On the Free plan, an Actor Start event costs $0.00005; each saved rental listing costs $0.00785 on Free. With one Actor Start event, 50 results = $0.39255 on Free.

Why did my run return no listings?

The Actor stops when a search response contains no items. A search URL may also be ignored if it is not a public Gathern /search page. Check the city or URL, dates, rental type, supported filters, and pagination limit.

What happens if Gathern access or a page fails?

A failed search request produces a warning and stops the current target, while records already saved remain available. If a detail request fails, the Actor can still save a valid search result, but fields supplied only by the detail response may be missing.

Is using public Gathern data legal or allowed?

The Actor reads Gathern’s public search data and listing details without logging in. Whether a particular use is legal or allowed depends on Gathern’s source terms and applicable law for your use case; review them before using the data.

Related actors

• Airbnb Scraper — Listings, Prices, Ratings & Hosts — related bovi Actor for Airbnb listings, prices, ratings, and hosts.
• At Home Japan Rental Listings — related bovi Actor for rental listings.
• Chaves na Mão Property Listings — related bovi Actor for property listings.