--- title: "Kyero API: JSON data, 5 endpoints, 1 credit per call" description: "Kyero API for property for sale or rent in Spain, Portugal, Italy and France, listings, estate agents and autocomplete. 1 credit per successful call." url: https://perceptlayer.com/apis/kyero --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Kyero 1 credit per call 5 endpoints 21 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 key](https://perceptlayer.com/signup) Run 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 OK JSON X-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. | # | id integer | name string | price integer | price\_formatted string | payment\_scheme string | reference\_no string | location\_id integer | property\_type object | bedrooms integer | bathrooms integer | built\_m2 integer | plot\_m2 integer | short\_description string | images string\[\] | images\_count integer | feature\_keys string\[\] | featured boolean | remote\_viewing\_enabled boolean | agent object | path string | url url | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 21159255 | Mobile home in Marbella, Malaga | 90342 | € 90,342 | for\_sale | CITS\_114877-Trigano Authentique, Plot 31 | 31673 | {3 fields} | 3 | 2 | 0 | 0 | . | \[3 items\] | 39 | \[1 item\] | false | false | {7 fields} | /en/property/21159255-wooden-home-for-sale-marbella | https://www.kyero.com/en/property/21159255-wooden-home-for-sale-marbella | | 2 | 16939965 | Apartment in Marbella, Malaga | 233000 | € 233,000 | for\_sale | DPIe3446 | 31673 | {3 fields} | 3 | 2 | 110 | 0 | Exclusive 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\] | false | false | {7 fields} | /en/property/16939965-apartment-for-sale-marbella | https://www.kyero.com/en/property/16939965-apartment-for-sale-marbella | | 3 | 12104443 | Apartment in Marbella, Malaga | 269000 | € 269,000 | for\_sale | DPIe1797 | 31673 | {3 fields} | 3 | 2 | 148 | 0 | Luxury 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\] | false | false | {7 fields} | /en/property/12104443-apartment-for-sale-marbella | https://www.kyero.com/en/property/12104443-apartment-for-sale-marbella | Recorded from our API · 3 items shown · 21 datapoints per item GET /v1/kyero/search?location\_id=31673&location\_slug=marbella&operation=sale&max\_price=500000&min\_beds=3&sort=price\_asc 21 datapoints ### Identity - id integer - name string - property\_type object ### Contact - agent object - url url ### Location - location\_id integer ### Reputation - images string\[\] - images\_count integer ### Price - price integer - price\_formatted string ### Other - payment\_scheme string - reference\_no string - bedrooms integer - bathrooms integer - built\_m2 integer - plot\_m2 integer - short\_description string - feature\_keys string\[\] - featured boolean - remote\_viewing\_enabled boolean - path string Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/kyero/agent`](https://perceptlayer.com/apis/kyero/agent) | none +4 optional | 1 credit | | [GET `/v1/kyero/agents`](https://perceptlayer.com/apis/kyero/agents) | `country` `location_id` `location_slug` +1 optional | 1 credit | | [GET `/v1/kyero/autocomplete`](https://perceptlayer.com/apis/kyero/autocomplete) | `q` +1 optional | 1 credit | | [GET `/v1/kyero/property`](https://perceptlayer.com/apis/kyero/property) | `path` | 1 credit | | [GET `/v1/kyero/search`](https://perceptlayer.com/apis/kyero/search) | `location_id` `location_slug` +15 optional | 1 credit | Overview ## About the Kyero API ## 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 estate JSON REST MCP ### More real estate APIs [28Hse](https://perceptlayer.com/apis/28hse) [4zida](https://perceptlayer.com/apis/4zida) [591](https://perceptlayer.com/apis/591-house) [99.co](https://perceptlayer.com/apis/99co) [99acres](https://perceptlayer.com/apis/99acres) [Adondevivir](https://perceptlayer.com/apis/adondevivir) [Apartment List](https://perceptlayer.com/apis/apartment-list) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Aqar](https://perceptlayer.com/apis/aqar) [Aqarmap](https://perceptlayer.com/apis/aqarmap) [Argenprop](https://perceptlayer.com/apis/argenprop) [athome](https://perceptlayer.com/apis/athome) 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 key](https://perceptlayer.com/signup) [Read the docs](https://docs.perceptlayer.com)