--- title: "Wikicasa API: JSON data, 8 endpoints, 1 credit per call" description: "Wikicasa API for Italian homes for sale or rent, listings, auctions, agencies and their agents, and place lookups as JSON. 1 credit per successful call." url: https://perceptlayer.com/apis/wikicasa --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Wikicasa 1 credit per call 8 endpoints 26 datapoints # Wikicasa API Wikicasa API for Italian homes for sale or rent, listings, auctions, agencies and their agents, and place lookups as JSON. 1 credit per successful call. [Get a free API key](https://perceptlayer.com/signup) Run it below Wikicasa GET /v1/wikicasa/search?transaction=sale&city\_id=15146&city\_slug=milano&price\_max=400000&sort=price\_asc ``` { "success": true, "data": { "count": 4211, "items": [ { "id": 24741580, "url": "https://www.wikicasa.it/annuncio/24741580", "title": "Rustico in Via Maniago 15, Milano", "description": "MM Lambrate – Via Maniago 15, in stabile civile anni 60, proponiamo cantina finestrata di circa 5 mq.\nPer ulteriori informazioni, per fissare un appuntamento per visitare l'immobile o per una valutazione gratuita e senza impegno del Vostro …", "transaction": "sale", "price": 10000, "price_sale": 10000, "price_reserved": false, "currency": "EUR", "rooms": 0, "address": "Via Maniago 15", "zone": "Lambrate, Ortica, Cimiano", "city": "Milano", "city_id": 15146, "latitude": 45.4877038648, "longitude": 9.2400379933, "typology_id": 6, "macro_typology_id": 1, "condition": "good_condition", "flags": { "garden": false, "luxury": false, "recent": false, "opportunity": false, "furnished": false, "bare_ownership": false, "short_rent": false }, "auction": { "is_auction": false, "days_left": 0, "discount_percent": 0 }, "published_at": "2025-05-12", "image": "https://images.wk-cdn.it/9e88fd8cb8ed9a0a0eb174b1d8dbb12c941c4a05b9354762342cb84232c0b33d/webp/original.webp", "floor_plan_count": 0, "project_units": 0, "agency": { "id": 33687, "name": "Affiliato Tecnocasa: TECNOUDINE SRL - Tecnocasa", "city": "Milano", "latitude": 45.4907304, "longitude": 9.2361057, "premium": false, "image_id": 843885631 } }, { "id": 28210779, "url": "https://www.wikicasa.it/annuncio/28210779", "title": "Villa in Via Carlo Boncompagni 34, Milano", "description": "BOX SINGOLO IN VENDITA IN VIA BONCOMPAGNI 34! \n Stai cercando un box per la tua auto o la tua moto? ICONACASA MILANO CORVETTO propone in vendita un box di circa 12 mq posto al primo piano interrato. \n Il box è adatto per una city car di pic…", "transaction": "sale", "price": 19000, "price_sale": 19000, "price_reserved": false, "currency": "EUR", "area_sqm": 12, "rooms": 1, "bathrooms": 0, "address": "Via Carlo Boncompagni 34", "zone": "Corvetto, Porto di Mare", "city": "Milano", "city_id": 15146, "latitude": 45.4387853, "longitude": 9.228851, "typology_id": 2, "macro_typology_id": 1, "energy_class": "A4", "flags": { "garden": false, "luxury": false, "recent": false, "opportunity": false, "furnished": false, "bare_ownership": false, "short_rent": false }, "auction": { "is_auction": false, "days_left": 0, "discount_percent": 0 }, "published_at": "2025-11-08", "image": "https://storage.wk-cdn.it//img/re/326027/28210779/1311799341_0.jpeg", "floor_plan_count": 0, "project_units": 0, "agency": { "id": 326027, "name": "iconacasa milano corvetto - Iconacasa", "city": "Milano", "latitude": 45.4405949, "longitude": 9.2262742, "premium": true, "image_id": 875443752 } }, { "id": 28650600, "url": "https://www.wikicasa.it/annuncio/28650600", "title": "Appartamento in Via Privata Monte Lungo 5, Milano", "description": "Rif: box5 - TEMPOCASA TURRO/GORLA propone in vendita Il box di 12mq, si trova al piano terra. Ottimo anche come soluzione d'appoggio o deposito per condomini dello stabile o della zona. La posizione di questa soluzione è indubbiamente…", "transaction": "sale", "price": 25000, "price_sale": 25000, "price_reserved": false, "currency": "EUR", "area_sqm": 12, "rooms": 0, "bathrooms": 0, "address": "Via Privata Monte Lungo 5", "zone": "Precotto, Turro, Viale Monza, Greco", "city": "Milano", "city_id": 15146, "latitude": 45.5011342, "longitude": 9.2182656, "typology_id": 1, "macro_typology_id": 1, "flags": { "garden": false, "luxury": false, "recent": false, "opportunity": false, "furnished": false, "bare_ownership": false, "short_rent": false }, "auction": { "is_auction": false, "days_left": 0, "discount_percent": 0 }, "published_at": "2025-12-23", "image": "https://images.wk-cdn.it/a143931e754594f3ef3e0a52e79997fac961f52fcab4016b5b4213210a80116c//original", "floor_plan_count": 0, "project_units": 0, "agency": { "id": 58555, "name": "Milano - Turro/Gorla - Tempocasa", "city": "Milano", "latitude": 45.5030305, "longitude": 9.2214376, "premium": true } } ] }, "meta": { "endpoint_family": "search", "page": 1, "per_page": 25, "has_more": true, "filtered_out": 1, "request_id": "req_24892b92e82c47689461f63ee07ddfc0", "credits_charged": 1, "credits_remaining": 1802 } } ``` 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 | url url | title string | description string | transaction string | price integer | price\_sale integer | price\_reserved boolean | currency string | rooms integer | address string | zone string | city string | city\_id integer | latitude number | longitude number | typology\_id integer | macro\_typology\_id integer | condition string | flags object | auction object | published\_at string | image url | floor\_plan\_count integer | project\_units integer | agency object | | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | --- | | 1 | 24741580 | https://www.wikicasa.it/annuncio/24741580 | Rustico in Via Maniago 15, Milano | MM Lambrate – Via Maniago 15, in stabile civile anni 60, proponiamo cantina finestrata di circa 5 mq. Per ulteriori informazioni, per fissare un appuntamento per visitare l'immobile o per una valutazione gratuita e senza impegno del Vostro … | sale | 10000 | 10000 | false | EUR | 0 | Via Maniago 15 | Lambrate, Ortica, Cimiano | Milano | 15146 | 45.4877038648 | 9.2400379933 | 6 | 1 | good\_condition | {7 fields} | {3 fields} | 2025-05-12 | https://images.wk-cdn.it/9e88fd8cb8ed9a0a0eb174b1d8dbb12c941c4a05b9354762342cb84232c0b33d/webp/original.webp | 0 | 0 | {7 fields} | | 2 | 28210779 | https://www.wikicasa.it/annuncio/28210779 | Villa in Via Carlo Boncompagni 34, Milano | BOX SINGOLO IN VENDITA IN VIA BONCOMPAGNI 34! Stai cercando un box per la tua auto o la tua moto? ICONACASA MILANO CORVETTO propone in vendita un box di circa 12 mq posto al primo piano interrato. Il box è adatto per una city car di pic… | sale | 19000 | 19000 | false | EUR | 1 | Via Carlo Boncompagni 34 | Corvetto, Porto di Mare | Milano | 15146 | 45.4387853 | 9.228851 | 2 | 1 | — | {7 fields} | {3 fields} | 2025-11-08 | https://storage.wk-cdn.it//img/re/326027/28210779/1311799341\_0.jpeg | 0 | 0 | {7 fields} | | 3 | 28650600 | https://www.wikicasa.it/annuncio/28650600 | Appartamento in Via Privata Monte Lungo 5, Milano | Rif: box5 - TEMPOCASA TURRO/GORLA propone in vendita Il box di 12mq, si trova al piano terra. Ottimo anche come soluzione d'appoggio o deposito per condomini dello stabile o della zona. La posizione di questa soluzione è indubbiamente… | sale | 25000 | 25000 | false | EUR | 0 | Via Privata Monte Lungo 5 | Precotto, Turro, Viale Monza, Greco | Milano | 15146 | 45.5011342 | 9.2182656 | 1 | 1 | — | {7 fields} | {3 fields} | 2025-12-23 | https://images.wk-cdn.it/a143931e754594f3ef3e0a52e79997fac961f52fcab4016b5b4213210a80116c//original | 0 | 0 | {6 fields} | Recorded from our API · 3 items shown · 26 datapoints per item GET /v1/wikicasa/search?transaction=sale&city\_id=15146&city\_slug=milano&price\_max=400000&sort=price\_asc 26 datapoints ### Identity - id integer - title string - typology\_id integer - macro\_typology\_id integer ### Contact - url url ### Location - address string - city string - city\_id integer - latitude number - longitude number ### Reputation - image url ### Price - price integer - price\_sale integer - price\_reserved boolean - currency string ### Other - description string - transaction string - rooms integer - zone string - condition string - flags object - auction object - published\_at string - floor\_plan\_count integer - project\_units integer - agency object Playground ## Run this API cURL shell ``` curl "https://api.perceptlayer.com/v1/wikicasa/search?transaction=sale&city_id=15146&city_slug=milano&price_max=400000&sort=price_asc" \ -H "X-API-Key: $API_KEY" ``` Wikicasa · 8 endpoints ## Endpoints Every endpoint takes the same key. Open one for its parameters and an example request. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/wikicasa/agencies`](https://perceptlayer.com/apis/wikicasa/agencies) | `city_id` +2 optional | 1 credit | | [GET `/v1/wikicasa/agency`](https://perceptlayer.com/apis/wikicasa/agency) | `id` | 1 credit | | [GET `/v1/wikicasa/agency-agents`](https://perceptlayer.com/apis/wikicasa/agency-agents) | `agency_id` | 1 credit | | [GET `/v1/wikicasa/agency-listings`](https://perceptlayer.com/apis/wikicasa/agency-listings) | `agency_id` +2 optional | 1 credit | | [GET `/v1/wikicasa/autocomplete`](https://perceptlayer.com/apis/wikicasa/autocomplete) | none +2 optional | 1 credit | | [GET `/v1/wikicasa/listing`](https://perceptlayer.com/apis/wikicasa/listing) | `id` | 1 credit | | [GET `/v1/wikicasa/property-types`](https://perceptlayer.com/apis/wikicasa/property-types) | none | 1 credit | | [GET `/v1/wikicasa/search`](https://perceptlayer.com/apis/wikicasa/search) | `transaction` `city_id` `city_slug` +12 optional | 1 credit | Overview ## About the Wikicasa API ## What you can get The Wikicasa API returns Wikicasa property data as JSON through 8 endpoints. - **Search:** `search` takes a `transaction` (sale, vendita, rent or affitto), a `city_id` and a `city_slug`, with `page`, `price_min`, `price_max`, `area_min`, `area_max`, `rooms_min`, `rooms_max`, `bathrooms_min`, `bathrooms_max`, `property_type`, `condition` (new, refurbished or to\_refurbish) and `sort` (most\_recent, price\_asc, price\_desc or area\_desc). - **Listings:** `listing` takes an `id`. - **Agencies:** `agencies` takes a `city_id`, with `page` and `limit`; `agency` takes an `id`; `agency-agents` takes an `agency_id`; `agency-listings` takes an `agency_id`, with `page` and the same `sort` values. - **Lookups:** `autocomplete` takes a `query` or a `url`; `property-types` takes no parameters. The recorded `search` for homes for sale in Milan ( `city_id=15146`, `city_slug=milano`) up to €400,000, sorted by `price_asc`, returns a `count` of 4,211 and `items`, each with `id`, `url`, `title`, `description`, `transaction`, `price`, `price_reserved`, `currency`, `rooms`, `address`, `zone`, `city`, `city_id`, `latitude`, `longitude`, `typology_id`, `condition`, `flags`, `auction`, `published_at`, `image` and `agency`. ## How a call works Search a city: `GET /v1/wikicasa/search?transaction=sale&city_id=15146&city_slug=milano&price_max=400000&sort=price_asc` with your key in the `X-API-Key` header. Each item's `id` is what `listing` takes, and the `id` inside its `agency` feeds `agency`, `agency-agents` and `agency-listings`. Check `has_more` in `meta` before asking for the next `page`. 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 by zone in Milan and other Italian cities `Use the Wikicasa API to track asking prices by zone in Milan and other Italian cities` ### Watch property auctions with \`auction\` (\`is\_auction\`, \`days\_left\`, \`discount\_percent\`) `` Use the Wikicasa API to watch property auctions with `auction` (`is_auction`, `days_left`, `discount_percent`) `` ### List the agencies in a city and the agents at each `Use the Wikicasa API to list the agencies in a city and the agents at each` ### Filter homes by condition, new or to refurbish `Use the Wikicasa API to filter homes by condition, new or to refurbish` FAQ ## Questions **Do I need a Wikicasa account?** No. You call this Wikicasa API with your Perceptlayer key in the \`X-API-Key\` header, with no Wikicasa login. **How much does the Wikicasa 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. **Can I use Italian values for \`transaction\`?** Yes. \`transaction\` takes sale or vendita, and rent or affitto. **Should I build a Wikicasa scraper instead?** You can, but a Wikicasa scraper is code you maintain: page changes break it, requests get blocked, and Wikicasa's terms govern how you collect data. The Wikicasa API gives you 8 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 Wikicasa 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)