StayYield Intelligence

Premium Italian real estate intelligence for BnB and short-term rental investment opportunities.

StayYield Intelligence collects real property listings, estimates short-term rental economics, applies risk checks, and ranks opportunities using an investor-oriented score.

It helps investors, hosts, agencies, and analysts screen Italian properties faster by combining listing data, ROI estimates, payback, yield, location signals, and risk flags in one structured dataset.

---

What you get

Each run produces a structured dataset of real listings with:

• source listing URL and image
• city, province, region and coordinates when available
• purchase price and price per square meter
• surface, rooms, bathrooms and guest-capacity estimate
• distance-to-sea estimate and source of that estimate
• short-term rental revenue assumptions
• gross and net annual revenue
• gross yield, net yield and payback period
• pessimistic and optimistic scenarios
• legal, renovation and property-use risk flags
• risk-adjusted investment score
• final investor-oriented rank score
• final recommendation and ranking notes

The production pipeline currently uses the most stable validated source to ensure repeatable output on Apify.

---

Best use cases

This actor is useful for:

• BnB investors screening Italian cities
• short-term rental operators looking for acquisition targets
• real estate scouts building lead lists
• agencies preparing data-driven opportunity reports
• analysts comparing locations, yields and risk profiles
• local operators validating whether a property is worth deeper due diligence

---

Why it is different

Most real estate datasets stop at listing data: price, surface, photos and location.

StayYield Intelligence adds an investment layer:

1. It estimates total capital required, including renovation cost.
2. It estimates short-term rental revenue based on market assumptions.
3. It computes gross yield, net yield and payback.
4. It flags problematic assets such as auctions, deposits, land, rural special assets and heavy renovation cases.
5. It creates a final ranking designed to surface the strongest BnB-style opportunities first.

The result is a dataset that is easier to evaluate than raw listings.

---

Recommended input

For a stable premium run, start with Puglia:

{
  "runMode": "investment_dataset",
  "regions": ["puglia"],
  "sources": ["wikicasa"],
  "maxItems": 500,
  "wikicasaApiLimit": 25,
  "wikicasaMaxOffsetsPerCity": 10,
  "minApiItemsBeforeCrawler": 1,
  "useBrowserFallback": false,
  "useApifyProxy": false,
  "expectedNightlyRate": 120,
  "expectedOccupancyRate": 0.55,
  "financingMode": "cash",
  "renovationLevel": "medium",
  "propertyCondition": "good"
}

---

Important output fields

Field	Meaning
portfolio_rank	Final position in the ranked dataset
final_rank_score	Investor-oriented ranking score, 0-100
final_recommendation	Final label: STRONG_BUY, BUY, WATCH, HIGH_RISK or AVOID
final_rank_notes	Explanation of bonuses/penalties used in the final ranking
adjusted_investment_score	Risk-adjusted base investment score
net_yield_pct	Estimated annual net yield after operating costs
payback_years	Estimated simple payback period
distance_to_sea_km	Estimated distance from the sea
distance_to_sea_source	Whether the sea distance came from city baseline or listing text
property_use_risk	Residential/use risk: LOW, MEDIUM or HIGH
legal_risk	Legal/auction/conformity risk: LOW, MEDIUM or HIGH
renovation_risk	Renovation risk: LOW, MEDIUM or HIGH
listing_quality_flags	Human-readable warning flags

---

Example output record

{
  "portfolio_rank": 1,
  "title": "Bilocale in Via delle Perle, Gallipoli",
  "city": "Gallipoli",
  "province": "Lecce",
  "purchase_price_eur": 60000,
  "surface_sqm": 28,
  "distance_to_sea_km": 0.1,
  "distance_to_sea_source": "text_100m_sea",
  "net_yield_pct": 19.38,
  "payback_years": 5.16,
  "property_use_risk": "LOW",
  "legal_risk": "LOW",
  "renovation_risk": "LOW",
  "final_rank_score": 100,
  "final_recommendation": "STRONG_BUY",
  "final_rank_notes": [
    "bonus_high_net_yield",
    "bonus_fast_payback",
    "bonus_text_verified_sea_distance"
  ]
}

---

Ranking logic

StayYield Intelligence keeps two levels of scoring:

• adjusted_investment_score: conservative quality and risk score.
• final_rank_score: portfolio ranking score used to order the dataset.

The final ranking rewards:

• high net yield
• short payback period
• verified closeness to the sea
• low risk flags
• strong tourism-market fit

It penalizes:

• legal/auction/conformity risk
• heavy renovation risk
• non-residential or unclear asset use
• rural special assets that require deeper due diligence
• weak payback or weak yield
• very small units with limited guest capacity

---

Source strategy

The production pipeline currently uses the most stable validated source to ensure repeatable output on Apify. Reliability is prioritized over noisy multi-source scraping attempts that can burn compute and return empty output.

Future versions may add more sources when they can be integrated with the same level of stability.

---

Limitations

This actor provides analytical estimates, not financial or real estate advice.

Verify manually before buying any property:

• exact address and real distance from the sea
• legal and urban-planning compliance
• short-term rental rules in the municipality
• building condition and renovation quotes
• condominium rules
• actual occupancy and nightly-rate data
• taxation and licensing requirements

Use the output as a screening layer, not as a final investment decision.