Kyero API

Property Listings, Locations and Estate Agencies in Spain, Portugal, Italy and France

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.

500 free credits
No card needed
From $0.20 / 1k
Pay as you go
Structured JSON
Ready for apps
API key access
Test in minutes
5
Endpoints
4 countries
Markets
Sale + rent
Operations

Try it now

Make one request. Inspect structured JSON.

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.

Request preview
Request
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"
JSON response
{
  "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 }
}

What you can build

Structured data for real applications. Here are some ideas.

Property Search Applications

Build search for homes in Spain, Portugal, Italy and France with filters for price, rooms, size, type and features.

Market Monitoring

Track asking prices and rents by town, with newest-first and price sorting and the full match count.

Listing Data Enrichment

Pull the full record of a listing: price, areas, all images, grouped features, agency and nearby airports and schools.

Agency Research

List the estate agencies of a town and read their profiles, teams, languages and portfolio.

Location Experiences

Resolve town and region names to the ids that search and agency lookups take.

Kyero scraper API

Kyero API for property search, listing details, locations and estate agencies in Spain, Portugal, Italy and France

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.

Choose the right Kyero API endpoint

Search Kyero sale and rental listings

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 docs

Read the full record of a listing

Take the path of a search result and request the property endpoint for price, images, features, agency and nearby data.

Open Kyero Property Details API docs

Research estate agencies

List the agencies of a town, then read the profile of each one.

Open Kyero Agency Directory API docs

Available endpoints

Everything you need in one API.

Scrappa vs Do-it-yourself property data extraction

See how Scrappa compares to the official API.

Dedicated Kyero endpoints
Scrappa: yes (5 endpoints)
Do-it-yourself property data extraction:
Output format
Scrappa: Structured JSON
Do-it-yourself property data extraction: Raw page content
Filters honoured on every row
Scrappa:
Do-it-yourself property data extraction: Build your own checks
Request mode
Scrappa: Read-only
Do-it-yourself property data extraction: Depends on implementation
Parser maintenance
Scrappa: Handled by Scrappa
Do-it-yourself property data extraction: Your team

Key features

5 read-only endpoints for Spain, Portugal, Italy and France
Sale and rent listings
Filters for price, bedrooms, bathrooms, built area, type, new build and features
Full listing details with all images and grouped features
Location autocomplete with parent places
Agency directory and profiles
No phone numbers or e-mail addresses in the output

Frequently asked questions

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.

Start using the Kyero API

Sign up and get 500 free credits. No credit card required.