Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Kyero

1 credit per call5 endpoints21 datapoints

Kyero API

Kyero API for property for sale or rent in Spain, Portugal, Italy and France, listings, estate agents and autocomplete. 1 credit per successful call.

Get a free API keyRun it below
Kyero
GET/v1/kyero/search?location_id=31673&location_slug=marbella&operation=sale&max_price=500000&min_beds=3&sort=price_asc
{
  "success": true,
  "location": {
    "id": 31673,
    "name": "Marbella",
    "slug": "marbella",
    "type": "City",
    "name_with_country": "Marbella, Spain",
    "nation_id": 55529,
    "country": "es",
    "latitude": 36.50978,
    "longitude": -4.88525,
    "cover_image_url": "https://img.kyero.com/crop/480x320/locations/cover_images/31673_shutterstock_153173057.jpg",
    "guide_url": "https://www.kyero.com/en/advice/spain/places-to-live/marbella-0l31673",
    "hierarchy": [
      {
        "id": 55625,
        "name": "Costa Del Sol",
        "slug": "costa-del-sol",
        "type": "Costa"
      },
      {
        "id": 29,
        "name": "Malaga",
        "slug": "malaga",
        "type": "Province"
      },
      {
        "id": 55531,
        "name": "Andalucia",
        "slug": "andalucia",
        "type": "Region"
      }
    ]
  },
  "operation": "sale",
  "applied_filters": {
    "operation": "sale",
    "property_type": "any",
    "sort": "price_asc",
    "max_price": 500000,
    "min_beds": 3
  },
  "listings": [
    {
      "id": 21159255,
      "name": "Mobile home in Marbella, Malaga",
      "price": 90342,
      "price_formatted": "€ 90,342",
      "payment_scheme": "for_sale",
      "reference_no": "CITS_114877-Trigano Authentique, Plot 31",
      "location_id": 31673,
      "property_type": {
        "id": 33,
        "key": "mobile home",
        "group_id": 9
      },
      "bedrooms": 3,
      "bathrooms": 2,
      "built_m2": 0,
      "plot_m2": 0,
      "short_description": ".",
      "images": [
        "https://img.kyero.com/crop/960x720/properties/21159/21159255/426489970.jpg",
        "https://img.kyero.com/crop/960x720/properties/21159/21159255/426489971.jpg",
        "https://img.kyero.com/crop/960x720/properties/21159/21159255/426489972.jpg"
      ],
      "images_count": 39,
      "feature_keys": [
        "resale_only"
      ],
      "featured": false,
      "remote_viewing_enabled": false,
      "agent": {
        "id": 11295,
        "name": "Caravans in the Sun",
        "logo_url": "https://img.kyero.com/fit/125x125/agents/logos/11/11295.jpg?checksum=bca97fce7bbe394517220b7837047805",
        "type": "2",
        "prime": true,
        "path": "/en/spain/estate-agents/profile/caravans-in-the-sun-a11295",
        "url": "https://www.kyero.com/en/spain/estate-agents/profile/caravans-in-the-sun-a11295"
      },
      "path": "/en/property/21159255-wooden-home-for-sale-marbella",
      "url": "https://www.kyero.com/en/property/21159255-wooden-home-for-sale-marbella"
    },
    {
      "id": 16939965,
      "name": "Apartment in Marbella, Malaga",
      "price": 233000,
      "price_formatted": "€ 233,000",
      "payment_scheme": "for_sale",
      "reference_no": "DPIe3446",
      "location_id": 31673,
      "property_type": {
        "id": 1,
        "key": "apartment",
        "group_id": 1
      },
      "bedrooms": 3,
      "bathrooms": 2,
      "built_m2": 110,
      "plot_m2": 0,
      "short_description": "Exclusive property Three bedroom apartment located on the first floor in a beautiful urbanization in Parque Elviria with community pool and garden...",
      "images": [
        "https://img.kyero.com/crop/960x720/properties/16939/16939965/309779479.jpg",
        "https://img.kyero.com/crop/960x720/properties/16939/16939965/309779480.jpg",
        "https://img.kyero.com/crop/960x720/properties/16939/16939965/309779483.jpg"
      ],
      "images_count": 16,
      "feature_keys": [
        "parking",
        "terrace",
        "garden"
      ],
      "primary_badge": "near_shops",
      "featured": false,
      "remote_viewing_enabled": false,
      "agent": {
        "id": 4533,
        "name": "dpi direct property investments",
        "logo_url": "https://img.kyero.com/fit/125x125/agents/logos/4/4533.jpg?checksum=de1d097ef4b5f731498ea4d60d180243",
        "type": "2",
        "prime": true,
        "path": "/en/spain/estate-agents/profile/dpi-direct-property-investments-a4533",
        "url": "https://www.kyero.com/en/spain/estate-agents/profile/dpi-direct-property-investments-a4533"
      },
      "path": "/en/property/16939965-apartment-for-sale-marbella",
      "url": "https://www.kyero.com/en/property/16939965-apartment-for-sale-marbella"
    },
    {
      "id": 12104443,
      "name": "Apartment in Marbella, Malaga",
      "price": 269000,
      "price_formatted": "€ 269,000",
      "payment_scheme": "for_sale",
      "reference_no": "DPIe1797",
      "location_id": 31673,
      "property_type": {
        "id": 1,
        "key": "apartment",
        "group_id": 1
      },
      "bedrooms": 3,
      "bathrooms": 2,
      "built_m2": 148,
      "plot_m2": 0,
      "short_description": "Luxury complex of 46 contemporary apartments with breathtaking sea views. Located in Manilva, only 15 minutes from Marbella and Puerto Banus and o...",
      "images": [
        "https://img.kyero.com/crop/960x720/properties/12104/12104443/218276062.jpg",
        "https://img.kyero.com/crop/960x720/properties/12104/12104443/218276063.jpg",
        "https://img.kyero.com/crop/960x720/properties/12104/12104443/218276064.jpg"
      ],
      "images_count": 10,
      "feature_keys": [
        "pool",
        "resale_only"
      ],
      "featured": false,
      "remote_viewing_enabled": false,
      "agent": {
        "id": 4533,
        "name": "dpi direct property investments",
        "logo_url": "https://img.kyero.com/fit/125x125/agents/logos/4/4533.jpg?checksum=de1d097ef4b5f731498ea4d60d180243",
        "type": "2",
        "prime": true,
        "path": "/en/spain/estate-agents/profile/dpi-direct-property-investments-a4533",
        "url": "https://www.kyero.com/en/spain/estate-agents/profile/dpi-direct-property-investments-a4533"
      },
      "path": "/en/property/12104443-apartment-for-sale-marbella",
      "url": "https://www.kyero.com/en/property/12104443-apartment-for-sale-marbella"
    }
  ],
  "pagination": {
    "page": 1,
    "pages": 8,
    "per_page": 20,
    "count": 156,
    "reachable": 156,
    "max_pages": 50,
    "has_next": true
  },
  "available_filters": {
    "price": [
      50000,
      75000,
      100000
    ],
    "beds": [
      1,
      2,
      3
    ],
    "baths": [
      1,
      2,
      3
    ],
    "build_size": [
      50,
      100,
      150
    ],
    "features": [
      "pool",
      "garage",
      "terrace"
    ],
    "location_features": [
      "near_beach",
      "near_shops",
      "near_golf"
    ],
    "multimedia": [
      "remote_viewing",
      "video",
      "virtual_tour"
    ]
  },
  "alternate_searches": {
    "locations_nearby": [
      {
        "label": "Estepona",
        "location_id": 31466,
        "location_slug": "estepona",
        "path": "/en/estepona-property-for-sale-0l31466"
      },
      {
        "label": "Mijas",
        "location_id": 31695,
        "location_slug": "mijas",
        "path": "/en/mijas-property-for-sale-0l31695"
      },
      {
        "label": "Fuengirola",
        "location_id": 31480,
        "location_slug": "fuengirola",
        "path": "/en/fuengirola-property-for-sale-0l31480"
      }
    ],
    "top_property_types": [
      {
        "label": "Properties for sale in Marbella",
        "location_id": 31673,
        "location_slug": "marbella",
        "path": "/en/marbella-property-for-sale-0l31673"
      },
      {
        "label": "Apartments for sale in Marbella",
        "path": "/en/marbella-apartments-for-sale-0l31673g1"
      },
      {
        "label": "Villas for sale in Marbella",
        "path": "/en/marbella-villas-for-sale-0l31673g2"
      }
    ],
    "explore": [
      {
        "label": "Cheap properties",
        "location_id": 31673,
        "location_slug": "marbella",
        "path": "/en/marbella-property-for-sale-0l31673"
      },
      {
        "label": "Luxury properties",
        "location_id": 31673,
        "location_slug": "marbella",
        "path": "/en/marbella-property-for-sale-0l31673"
      },
      {
        "label": "New build properties",
        "location_id": 31673,
        "location_slug": "marbella",
        "path": "/en/marbella-property-for-sale-0l31673"
      }
    ],
    "beds": [
      {
        "label": "1 bedroom",
        "location_id": 31673,
        "location_slug": "marbella",
        "path": "/en/marbella-property-for-sale-0l31673"
      },
      {
        "label": "2 bedroom",
        "location_id": 31673,
        "location_slug": "marbella",
        "path": "/en/marbella-property-for-sale-0l31673"
      },
      {
        "label": "3 bedroom",
        "location_id": 31673,
        "location_slug": "marbella",
        "path": "/en/marbella-property-for-sale-0l31673"
      }
    ]
  },
  "title": "Properties for sale in Marbella",
  "meta": {
    "attempts": 1,
    "last_status": 200,
    "endpoint_family": "search",
    "dropped_by_guard": 0,
    "request_id": "req_b259b0d89b424178ae58eb869b16bf9d",
    "credits_charged": 1,
    "credits_remaining": 1853
  }
}
200 OKJSONX-Credits-Used: 1
Recorded from our API and shortened.

Sample data

What one call returns

A recorded run of search: the fields and shapes you will get, shortened to 3 items.

#idintegernamestringpriceintegerprice_formattedstringpayment_schemestringreference_nostringlocation_idintegerproperty_typeobjectbedroomsintegerbathroomsintegerbuilt_m2integerplot_m2integershort_descriptionstringimagesstring[]images_countintegerfeature_keysstring[]featuredbooleanremote_viewing_enabledbooleanagentobjectpathstringurlurl
121159255Mobile home in Marbella, Malaga90342€ 90,342for_saleCITS_114877-Trigano Authentique, Plot 3131673{3 fields}3200.[3 items]39[1 item]falsefalse{7 fields}/en/property/21159255-wooden-home-for-sale-marbellahttps://www.kyero.com/en/property/21159255-wooden-home-for-sale-marbella
216939965Apartment in Marbella, Malaga233000€ 233,000for_saleDPIe344631673{3 fields}321100Exclusive property Three bedroom apartment located on the first floor in a beautiful urbanization in Parque Elviria with community pool and garden...[3 items]16[3 items]falsefalse{7 fields}/en/property/16939965-apartment-for-sale-marbellahttps://www.kyero.com/en/property/16939965-apartment-for-sale-marbella
312104443Apartment in Marbella, Malaga269000€ 269,000for_saleDPIe179731673{3 fields}321480Luxury complex of 46 contemporary apartments with breathtaking sea views. Located in Manilva, only 15 minutes from Marbella and Puerto Banus and o...[3 items]10[2 items]falsefalse{7 fields}/en/property/12104443-apartment-for-sale-marbellahttps://www.kyero.com/en/property/12104443-apartment-for-sale-marbella

Recorded from our API · 3 items shown · 21 datapoints per itemGET /v1/kyero/search?location_id=31673&location_slug=marbella&operation=sale&max_price=500000&min_beds=3&sort=price_asc

21 datapoints

Identity

  • idinteger
  • namestring
  • property_typeobject

Contact

  • agentobject
  • urlurl

Location

  • location_idinteger

Reputation

  • imagesstring[]
  • images_countinteger

Price

  • priceinteger
  • price_formattedstring

Other

  • payment_schemestring
  • reference_nostring
  • bedroomsinteger
  • bathroomsinteger
  • built_m2integer
  • plot_m2integer
  • short_descriptionstring
  • feature_keysstring[]
  • featuredboolean
  • remote_viewing_enabledboolean
  • pathstring

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/kyero/search?location_id=31673&location_slug=marbella&operation=sale&max_price=500000&min_beds=3&sort=price_asc" \
  -H "X-API-Key: $API_KEY"

Kyero · 5 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/kyero/agent
none+4 optional
1 credit
GET/v1/kyero/agents
countrylocation_idlocation_slug+1 optional
1 credit
GET/v1/kyero/autocomplete
q+1 optional
1 credit
GET/v1/kyero/property
path
1 credit
GET/v1/kyero/search
location_idlocation_slug+15 optional
1 credit

Overview

What you can get

The Kyero API returns Kyero property data as JSON through 5 endpoints. agent, agents and autocomplete take a country: es, pt, it or fr.

  • Search: search takes a location_id and location_slug, with operation (sale or rent), property_type (any, apartments or villas), min_price, max_price, min_beds, max_beds, min_baths, max_baths, min_build_size, max_build_size, features, new_build, resale_only, sort (price_asc, price_desc or newest) and page.
  • Properties: property takes a path.
  • Agents: agents takes a country, location_id and location_slug, with page; agent takes a path, id or slug.
  • Locations: autocomplete takes q.

The recorded search for Marbella (location_id 31673, sale, at least 3 bedrooms, up to 500,000, sorted by price_asc) returns a pagination count of 156, with pages, per_page and has_next. Each item in listings carries id, name, price, price_formatted, reference_no, property_type, bedrooms, bathrooms, built_m2, plot_m2, short_description, images_count, feature_keys, agent, path and url. It also returns the resolved location, available_filters and alternate_searches for nearby locations and property types.

How a call works

Search a town: GET /v1/kyero/search?location_id=31673&location_slug=marbella&operation=sale&max_price=500000&min_beds=3&sort=price_asc with your key in the X-API-Key header. Each listing's path is what property takes, and its agent.path is what agent takes. Every successful call costs 1 credit; failed calls cost nothing.

Real estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

Use cases

Track asking prices for villas and apartments on the Costa del Sol and other markets

Use the Kyero API to track asking prices for villas and apartments on the Costa del Sol and other markets

Compare built and plot sizes with `built_m2` and `plot_m2`

Use the Kyero API to compare built and plot sizes with `built_m2` and `plot_m2`

Separate new builds from resales with `new_build` and `resale_only`

Use the Kyero API to separate new builds from resales with `new_build` and `resale_only`

List the estate agents active in a town with `agents`

Use the Kyero API to list the estate agents active in a town with `agents`

FAQ

Questions

How much does the Kyero API cost?

Each successful call costs one credit. New accounts get free credits to start, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Which countries does it cover?

`agents`, `agent` and `autocomplete` take a `country` of es, pt, it or fr, for Spain, Portugal, Italy or France.

Do I need a Kyero account?

No. You call this Kyero API with your Perceptlayer key in the `X-API-Key` header, with no Kyero login.

Should I build a Kyero scraper instead?

You can, but a Kyero scraper is code you maintain: page changes break it, requests get blocked, and Kyero's terms govern how you collect data. The Kyero API gives you 5 endpoints of named JSON fields for 1 credit per successful call, and failed calls cost nothing. A scraper makes sense only for data these endpoints don't return, so check the response in the playground on this page first.

Try the Kyero API with 100 free credits

No credit card. Failed calls are never billed.

Get a free API keyRead the docs