Location Autocomplete
/api/kyero/autocomplete
Resolve place names to location ids and slugs
Scrappa's read-only Kyero API turns the property portal for international buyers into structured JSON. Search homes for sale and rent in Spain, Portugal, Italy and France by price, bedrooms, bathrooms, built area, type and features; read full listings with all images, grouped features, agency and nearby data; resolve places to location ids; and read estate agency directories and profiles.
Try it now
Use the first endpoint in this API family with a Scrappa API key. Every account includes 500 free monthly credits, so you can validate the response shape before buying credits.
curl -X GET "https://scrappa.co/api/kyero/search?location_id=31673&location_slug=marbella&operation=sale&min_beds=3&max_price=500000&sort=price_asc" \
-H "Accept: application/json" \
-H "X-API-KEY: YOUR_API_KEY"
{
"success": true,
"location": { "id": 31673, "name": "Marbella", "country": "es" },
"operation": "sale",
"applied_filters": { "operation": "sale", "min_beds": 3, "max_price": 500000, "sort": "price_asc" },
"listings": [],
"pagination": { "page": 1, "pages": 8, "count": 143, "reachable": 143, "max_pages": 50 },
"meta": { "endpoint_family": "search", "billable": true, "attempts": 1 }
}
Structured data for real applications. Here are some ideas.
Build search for homes in Spain, Portugal, Italy and France with filters for price, rooms, size, type and features.
Track asking prices and rents by town, with newest-first and price sorting and the full match count.
Pull the full record of a listing: price, areas, all images, grouped features, agency and nearby airports and schools.
List the estate agencies of a town and read their profiles, teams, languages and portfolio.
Resolve town and region names to the ids that search and agency lookups take.
Kyero scraper API
The Kyero API is built for proptech teams, relocation services and analysts who work with the Spanish, Portuguese, Italian and French property markets. Search listings by price, rooms, size and features, then use listing details, location autocomplete and agency endpoints to build search tools, market monitors and agency directories.
Search sale and rent listings in Spain, Portugal, Italy and France.
Filter by price, bedrooms, bathrooms, built area, apartments or villas, new build and features.
Get full listing details with all images, grouped features and agency data.
Resolve towns and regions to location ids.
Read agency directories and profiles.
Call 5 read-only endpoints that return structured JSON.
Resolve a place with location autocomplete, then pass its id and slug to the search endpoint. Page through up to 1,000 listings per search.
Open Kyero Property Search API docsTake the path of a search result and request the property endpoint for price, images, features, agency and nearby data.
Open Kyero Property Details API docsList the agencies of a town, then read the profile of each one.
Open Kyero Agency Directory API docsEverything you need in one API.
/api/kyero/autocomplete
Resolve place names to location ids and slugs
/api/kyero/search
Search sale and rent listings by price, rooms, size, type and features
/api/kyero/property
Get the full record of one listing
/api/kyero/agents
List the estate agencies of a location
/api/kyero/agent
Get one agency profile with team, address and portfolio
See how Scrappa compares to the official API.
| Feature | Scrappa | Do-it-yourself property data extraction |
|---|---|---|
| Dedicated Kyero endpoints | yes (5 endpoints) | |
| Output format | Structured JSON | Raw page content |
| Filters honoured on every row | Build your own checks | |
| Request mode | Read-only | Depends on implementation |
| Parser maintenance | Handled by Scrappa | Your team |
The Kyero API is Scrappa's read-only REST API for property listings in Spain, Portugal, Italy and France. It covers search, listing details, location autocomplete and estate agencies.
No. Scrappa is an independent service and is not affiliated with or endorsed by Kyero. A Scrappa API key is used to access the endpoints on this page.
Up to 1,000 per search: 50 pages of 20 listings. The response shows the full match count and how many are reachable. Narrow the search with filters to reach the rest.
Kyero ignores price, room and size values that are not in its own lists and returns unfiltered results. This API rejects such values with a non-billable error instead.
No. Kyero publishes only the town centre for a listing, and the response says so.
No. All Kyero endpoints on this page are read-only.