Properstar Property Scraper

Extract property listings from Properstar with structured, ready-to-use data for market research, lead generation, monitoring, and analytics workflows.

Features

• Multi-URL extraction — Scrape one or multiple Properstar result URLs in one run.
• Pagination support — Collect data page-by-page with configurable limits.
• Project and listing coverage — Collect both classic listings and project records.
• Clean dataset output — Records are saved without null/empty fields.
• Image gallery URLs — pictures contains only image URLs from the search API response.

Use Cases

Market Research

Track asking prices, property types, and area-level trends across locations.

Lead Intelligence

Build fresh datasets of relevant properties for sales and outreach teams.

Monitoring

Run scheduled scraping to detect new listings, changes, and drops in price.

BI and Reporting

Export structured data into dashboards, reports, and portfolio tracking systems.

---

Input Parameters

Parameter	Type	Required	Default	Description
urls	Array	No	["https://www.properstar.com.ng/portugal/buy/apartment-house"]	One or more Properstar search URLs.
results_wanted	Integer	No	20	Maximum number of records to save.
max_pages	Integer	No	3	Maximum pages to process per URL.
proxyConfiguration	Object	No	—	Optional proxy settings for browser sessions.

---

Output Data

Each dataset item can include:

Field	Type	Description
id	Integer	Properstar item ID
result_type	String	listing or project
automatic_title	String	Main listing/project title
price_original	Number	Original price value
price_original_currency	String	Original price currency
city	String	City name
country_iso	String	ISO country code
property_type	String	Property type
bedrooms	Integer	Bedrooms count
bathrooms	Integer	Bathrooms count
area_living	Number	Living area
publication_date	String	Publish timestamp
pictures	Array	List of image URLs only
url	String	Listing/project URL
source_url	String	Source search URL

---

Usage Examples

Basic URL Scrape

{
    "urls": [
        "https://www.properstar.com.ng/portugal/buy/apartment-house"
    ],
    "results_wanted": 20,
    "max_pages": 3
}

Multiple URLs

{
    "urls": [
        "https://www.properstar.com.ng/portugal/buy/apartment-house",
        "https://www.properstar.com.ng/portugal/lisbon-district/buy/apartment-house?p=2"
    ],
    "results_wanted": 120,
    "max_pages": 4
}

Higher Throughput Run

{
    "urls": [
        "https://www.properstar.com.ng/portugal/buy/apartment-house"
    ],
    "results_wanted": 500,
    "max_pages": 10
}

---

Sample Output

{
    "source_url": "https://www.properstar.com.ng/portugal/buy/apartment-house",
    "search_id": 1281022695,
    "page": 1,
    "position": 1,
    "result_type": "listing",
    "id": 112264559,
    "url": "https://www.properstar.com.ng/listing/112264559",
    "automatic_title": "House for sale in Arco da Calheta, Portugal",
    "property_type": "House",
    "city": "Arco da Calheta",
    "country_iso": "PT",
    "price_original": 4500000,
    "price_original_currency": "EUR",
    "bedrooms": 5,
    "bathrooms": 5,
    "area_living": 379,
    "pictures": [
        "https://files-api.properstar.com/api/v2/files/example-id-1/1",
        "https://files-api.properstar.com/api/v2/files/example-id-2/1"
    ],
    "publication_date": "2026-05-12T12:00:00"
}

---

Tips for Best Results

Start With Known Working URLs

• Use direct Properstar result pages.
• If possible, start with country/city pages first.

Control Run Size

• Keep results_wanted low while testing.
• Increase gradually for production runs.

Pagination Strategy

• Use max_pages to control runtime.
• For deeper runs, schedule multiple jobs with segmented URLs.

Network Stability

• Keep proxy enabled for consistent performance.
• Retry with smaller batches if a target route is slow.

---

Integrations

Connect your data with:

• Google Sheets — Build live property trackers
• Airtable — Create searchable listing databases
• Looker Studio / BI tools — Build dashboards
• Webhooks — Send updates into custom pipelines
• Make — Automate downstream actions
• Zapier — Connect listings to CRM and alerts

Export Formats

• JSON — Best for APIs and developers
• CSV — Spreadsheet and quick filtering
• Excel — Reporting and sharing
• XML — Legacy integrations

---

Frequently Asked Questions

Can I scrape multiple regions in one run?

Yes. Add all target URLs to urls.

Does it support pagination?

Yes. Use max_pages to control page depth per URL.

Why are there no null fields in output?

The actor saves cleaned records and skips empty/null values.

Do I need detail-page requests to get images?

No. The actor collects image gallery URLs directly from search results.

Can I limit data for faster runs?

Yes. Lower results_wanted and max_pages.

---

Support

For issues or feature requests, use Apify run logs and actor input/output snapshots to identify the failing URL pattern, then update inputs accordingly.

Resources

• Apify Documentation
• Apify API Reference
• Apify Scheduling

---

Legal Notice

This actor is designed for legitimate data collection and analysis. You are responsible for complying with website terms, local laws, and all applicable data-use regulations.