Sign inGet a free API keyDashboard
Menu

APIs / Real estate / Wikicasa

1 credit per call8 endpoints26 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 keyRun 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 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.

#idintegerurlurltitlestringdescriptionstringtransactionstringpriceintegerprice_saleintegerprice_reservedbooleancurrencystringroomsintegeraddressstringzonestringcitystringcity_idintegerlatitudenumberlongitudenumbertypology_idintegermacro_typology_idintegerconditionstringflagsobjectauctionobjectpublished_atstringimageurlfloor_plan_countintegerproject_unitsintegeragencyobject
124741580https://www.wikicasa.it/annuncio/24741580Rustico in Via Maniago 15, MilanoMM 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 …sale1000010000falseEUR0Via Maniago 15Lambrate, Ortica, CimianoMilano1514645.48770386489.240037993361good_condition{7 fields}{3 fields}2025-05-12https://images.wk-cdn.it/9e88fd8cb8ed9a0a0eb174b1d8dbb12c941c4a05b9354762342cb84232c0b33d/webp/original.webp00{7 fields}
228210779https://www.wikicasa.it/annuncio/28210779Villa in Via Carlo Boncompagni 34, MilanoBOX 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…sale1900019000falseEUR1Via Carlo Boncompagni 34Corvetto, Porto di MareMilano1514645.43878539.22885121—{7 fields}{3 fields}2025-11-08https://storage.wk-cdn.it//img/re/326027/28210779/1311799341_0.jpeg00{7 fields}
328650600https://www.wikicasa.it/annuncio/28650600Appartamento in Via Privata Monte Lungo 5, MilanoRif: 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…sale2500025000falseEUR0Via Privata Monte Lungo 5Precotto, Turro, Viale Monza, GrecoMilano1514645.50113429.218265611—{7 fields}{3 fields}2025-12-23https://images.wk-cdn.it/a143931e754594f3ef3e0a52e79997fac961f52fcab4016b5b4213210a80116c//original00{6 fields}

Recorded from our API · 3 items shown · 26 datapoints per itemGET /v1/wikicasa/search?transaction=sale&city_id=15146&city_slug=milano&price_max=400000&sort=price_asc

26 datapoints

Identity

  • idinteger
  • titlestring
  • typology_idinteger
  • macro_typology_idinteger

Contact

  • urlurl

Location

  • addressstring
  • citystring
  • city_idinteger
  • latitudenumber
  • longitudenumber

Reputation

  • imageurl

Price

  • priceinteger
  • price_saleinteger
  • price_reservedboolean
  • currencystring

Other

  • descriptionstring
  • transactionstring
  • roomsinteger
  • zonestring
  • conditionstring
  • flagsobject
  • auctionobject
  • published_atstring
  • floor_plan_countinteger
  • project_unitsinteger
  • agencyobject

Playground

Run this API

cURLshell
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.

EndpointRequired parametersCost
GET/v1/wikicasa/agencies
city_id+2 optional
1 credit
GET/v1/wikicasa/agency
id
1 credit
GET/v1/wikicasa/agency-agents
agency_id
1 credit
GET/v1/wikicasa/agency-listings
agency_id+2 optional
1 credit
GET/v1/wikicasa/autocomplete
none+2 optional
1 credit
GET/v1/wikicasa/listing
id
1 credit
GET/v1/wikicasa/property-types
none
1 credit
GET/v1/wikicasa/search
transactioncity_idcity_slug+12 optional
1 credit

Overview

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 estateJSONRESTMCP

More real estate APIs

28Hse4zida59199.co99acresAdondevivirApartment ListApartments.comAqarAqarmapArgenpropathome

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 keyRead the docs