Kyero Scraper — European Property Listings, Coordinates & Agent Contacts

Scrape Kyero.com, the leading European property portal for international buyers, covering Spain, Portugal, France, and Italy. Extract properties for sale and rent with price, GPS coordinates, bedrooms, size, features, agent contact details, images, and listing dates — data that competing Kyero scrapers miss.

Unlike other Kyero actors that only parse HTML listing cards, this scraper visits each property detail page to extract latitude/longitude coordinates, agent phone/email/website, full feature lists, and listing dates — fields essential for serious real estate analysis that competitors leave empty.

Spanish residential proxy required — Kyero uses Cloudflare that geo-gates non-EU IPs. Included by default.

---

⚡ Quick Start

{
    "country": "spain",
    "query": "barcelona",
    "maxItems": 50
}

👉 50 Barcelona properties with prices, coordinates, bedrooms, and agent contacts.

---

🌍 Countries

Country	URL Pattern	Currency
🇪🇸 Spain	kyero.com/en/spain-property-for-sale	EUR (€)
🇵🇹 Portugal	kyero.com/en/portugal-property-for-sale	EUR (€)
🇫🇷 France	kyero.com/en/france-property-for-sale	EUR (€)
🇮🇹 Italy	kyero.com/en/italy-property-for-sale	EUR (€)

---

Data Fields

Category	Fields
Identity	propertyId, title, url, referenceNo
Price	price (numeric), priceFormatted (e.g. "€345,000")
Property	propertyType, bedrooms, bathrooms, builtM2, plotM2
Location	address, latitude, longitude ✅
Features	features (JSON array: pool, terrace, lift, sea view...)
Description	description (full text)
Media	images (JSON array of URLs)
Agent	agentName, agentPhone, agentEmail, agentWebsite
Dates	dateListed, scrapedAt
Listing	listingType (for_sale / to_rent)

---

Input Parameters

Parameter	Type	Default	Description
country	select	spain	Spain / Portugal / France / Italy
listingType	select	for_sale	For Sale / To Rent
query	string	barcelona	Location keyword (barcelona, alicante, paris...)
startUrls	array	[]	Kyero search or property URLs (overrides country/query)
includeDetails	boolean	true	Visit detail pages for coordinates, agent, features
maxItems	integer	100	Maximum properties (0 = no limit)
maxPages	integer	5	Search result pages
requestDelay	integer	500	Delay between detail requests (ms)
maxConcurrency	integer	8	Parallel detail page requests
proxyConfiguration	proxy	ES RESIDENTIAL	Required — Cloudflare geo-gating

---

Use Cases

• Property investment analysis — Coordinates enable map-based market analysis
• Agent lead generation — Phone + email from detail pages for B2B outreach
• Market research — Price/m² trends across Spanish regions
• Relocation services — Curated property lists for international buyers

---

Integration

JavaScript

const run = await client.actor('haketa/kyero-scraper').call({ country: 'spain', query: 'alicante', maxItems: 100 });

Python

run = client.actor('haketa/kyero-scraper').call(run_input={'country': 'spain', 'query': 'alicante', 'maxItems': 100})

CLI

$apify call haketa/kyero-scraper --input '{"country":"spain","query":"barcelona","maxItems":100}'

---

FAQ

Q: Why coordinates matter? A: Without lat/lng, you can't map properties, calculate distances to amenities, or do spatial market analysis. memo23 and other Kyero scrapers don't extract coordinates — we do.

Q: Why ES residential proxy? A: Kyero uses Cloudflare which challenges non-EU IPs with "Just a moment..." pages. An ES residential proxy makes requests appear as Spanish household visitors.

Q: Can I search for properties without a city? A: Yes — leave query empty to scrape all properties in the country. Use maxItems to control volume.

---

The only Kyero scraper with GPS coordinates, agent contacts, and listing dates — data that real estate professionals actually need.

---

Performance & Cost

Mode	Speed	Proxy
Search only (includeDetails: false)	~20-30 props/sec	ES Residential
Search + details	~5-10 props/sec	ES Residential
Direct URLs	~5-10 props/sec	ES Residential

Typical cost: 100 properties with full detail = ~60-90 seconds. ES residential proxy data transfer is the main cost driver.

---

Example Output

{
    "propertyId": "555123",
    "title": "Apartment in El Masnou, Barcelona province",
    "url": "https://www.kyero.com/en/property/555123",
    "price": "345000",
    "priceFormatted": "€345,000",
    "listingType": "for_sale",
    "bedrooms": "3",
    "bathrooms": "2",
    "builtM2": "120",
    "plotM2": null,
    "propertyType": "Apartment",
    "address": "El Masnou, Costa Garraf / Maresme, Barcelona province, Catalonia, Spain",
    "latitude": "41.4823",
    "longitude": "2.3178",
    "features": "[\"lift\",\"terrace\",\"pool\",\"sea_view\",\"parking\",\"air_conditioning\"]",
    "description": "Beautiful 3-bedroom apartment in El Masnou with sea views...",
    "images": "[\"https://images.kyero.com/.../1.jpg\",\"https://images.kyero.com/.../2.jpg\"]",
    "agentName": "Costa Barcelona Real Estate",
    "agentPhone": "+34 93 123 45 67",
    "agentEmail": "info@costabarcelona.com",
    "agentWebsite": "https://www.costabarcelona.com",
    "referenceNo": "CB-2024-0891",
    "dateListed": "2026-05-15",
    "scrapedAt": "2026-06-22T15:00:00.000Z"
}

---

Anti-Bot Strategy

Kyero uses Cloudflare (not Akamai) for bot protection. Our approach:

• Spanish residential IPs via Apify's ES residential proxy pool
• Browser TLS fingerprint via got-scraping Chrome impersonation
• Cloudflare challenge detection — automatically retries with fresh proxy on "Just a moment..." pages
• Moderate delays — 500ms between requests with jitter
• Adaptive retry — up to 4 attempts per request, doubling backoff

---

Common Search Queries

Spain (most listings)

barcelona, madrid, valencia, alicante, malaga, marbella, mallorca, ibiza, costa-blanca, costa-del-sol, murcia, sevilla, granada, cadiz

Portugal

lisbon, algarve, porto, albufeira, lagos, tavira, cascais, silver-coast, madeira

France

paris, nice, cannes, provence, alps, bordeaux, lyon, marseille, cote-dazur, languedoc

Italy

rome, milan, tuscany, florence, venice, lake-como, puglia, sardinia, sicily, umbria, naples

---

Tips & Best Practices

• Start with list-only: includeDetails: false for a fast scan, then enrich interesting properties via startUrls
• Narrow your query: "barcelona" returns 10,000+ properties — add qualifiers like "barcelona-beachfront" or use price filters in startUrls
• Monitor for Cloudflare blocks: If you see "Cloudflare block" warnings, increase requestDelay to 1000ms
• Cross-country comparison: Run the same listing type across multiple countries to compare price/m²
• Schedule for new listings: Weekly runs with maxPages: 1 to catch newly listed properties
• Export coordinates: Use the latitude/longitude fields to build property heatmaps in tools like Google Maps, Tableau, or Kepler.gl

---

Data Quality Notes

Field	Typical Fill Rate	Notes
latitude	70-80%	From detail page embedded data
longitude	70-80%	From detail page embedded data
agentPhone	60-70%	From detail page tel: links
agentEmail	40-50%	From detail page mailto: links
agentWebsite	50-60%	Agency website when listed
dateListed	30-40%	Not always shown on Kyero
features	80-90%	Pool, terrace, lift, parking...
builtM2	85-95%	Almost always available
plotM2	30-40%	Only for houses/villas with land

---

Known Limitations

• Pagination cap: Kyero limits results to ~20-25 pages per search. Segment by location for larger datasets.
• Coordinates on detail only: Coordinates require detail page visit (includeDetails: true)
• ES proxy required: Without Spanish residential proxy, Cloudflare returns challenge pages
• Agent contact varies: Not all listings include agent phone/email — Kyero's page design varies by agency

---

Legal & Responsible Use

This actor extracts publicly available property listings from Kyero.com. Users are responsible for complying with Kyero's Terms of Service and GDPR where applicable. Data is intended for legitimate real estate market research, investment analysis, and B2B agent outreach.