GET /property-details

Authorization

RapidApiKey

X-RapidAPI-Key<token>

In: header

Query Parameters

transactionType*string

Make sure to match the transaction type with the propertyID

Value in"BUY" | "RENT"

propertyId*string

Property ID from search-ads endpoint

Length1 <= length <= 100

language*string

Value in"en" | "es" | "de" | "ca"

Header Parameters

X-RapidAPI-Host*string

Default"fotocasa3.p.rapidapi.com"

Response Body

`application/json`

curl -X GET "https://example.com/property-details?transactionType=BUY&propertyId=185617904&language=en" \  -H "X-RapidAPI-Host: fotocasa3.p.rapidapi.com"

{
  "success": true,
  "data": {
    "id": "1_182702197",
    "uris": [
      {
        "value": "/es/comprar/vivienda/madrid-capital/aire-acondicionado-calefaccion-ascensor/182702197/d",
        "language": "es_ES"
      }
    ],
    "zone": "",
    "baths": 1,
    "floor": "3",
    "phone": "910923867",
    "rooms": 2,
    "wasId": "string",
    "agency": {
      "id": "9202765062251",
      "web": "http://www.engelvoelkers.com/",
      "logo": "https://static.fotocasa.es/images/client/9202765062251/681089.jpg?rule=original",
      "name": "EV MMC SPAIN S.L.U.",
      "type": "professional",
      "urls": [
        {
          "value": "/inmobiliarias/engel-volkers-madrid-9202765062251",
          "language": "es_ES"
        }
      ],
      "alias": "ENGEL & VÖLKERS MADRID",
      "wasId": "900610580269",
      "publisherId": "01336661-942a-46d2-997a-1f511a6696d0"
    },
    "number": "string",
    "prices": [
      {
        "amount": 325000,
        "amountDrop": 0,
        "periodicity": "0"
      }
    ],
    "street": "string",
    "heating": "string",
    "surface": 70,
    "zipCode": "28012",
    "features": [
      {
        "id": "1"
      }
    ],
    "hotWater": "string",
    "location": {
      "latitude": 40.4062766625279,
      "level1Id": "14",
      "level2Id": "28",
      "level3Id": "173",
      "level4Id": "string",
      "level5Id": "28079",
      "level6Id": "string",
      "level7Id": "672",
      "level8Id": "48",
      "countryId": "724",
      "longitude": -3.6993530007344,
      "level1Name": "Madrid",
      "level2Name": "Madrid",
      "level3Name": "Madrid, Zona de",
      "level4Name": "string",
      "level5Name": "Madrid Capital",
      "level6Name": "string",
      "level7Name": "Centro",
      "level8Name": "Embajadores - Lavapiés",
      "countryName": "España"
    },
    "products": [
      {
        "id": "161"
      }
    ],
    "antiquity": "8",
    "contracts": [
      {
        "productId": "7"
      }
    ],
    "promotion": "string",
    "subsidies": [
      "aval-comprar-casa-nacional",
      "mi-primera-vivienda-madrid"
    ],
    "multimedia": [
      {
        "url": "https://static.fotocasa.es/images/ads/cc2f4b4d-7002-4056-ba8f-3e457f326ce0?rule=original",
        "type": "2",
        "position": 1
      }
    ],
    "propertyId": "182702197",
    "streetType": "string",
    "description": "Engel & Völkers presenta una propiedad innovadora con diseño vanguardista...",
    "orientation": "string",
    "promotionId": "string",
    "qualityRate": 0,
    "creationDate": "2024-03-22T06:22:14.237",
    "propertyType": "2",
    "purchaseType": "2",
    "groundSurface": "string",
    "realEstateAdId": "232c3f5d-d49f-4adb-bb82-e3e404300836",
    "agencyReference": "I-00W4J7-W-02PJ47",
    "propertySubtype": "1",
    "transactionType": "1",
    "showCounterOffer": true,
    "energyCertificate": {
      "id": "string",
      "energyEfficiencyValue": 999,
      "environmentImpactValue": 999,
      "energyEfficiencyRatingType": "7",
      "environmentImpactRatingType": "7",
      "energyPerformanceCertificateType": "1"
    },
    "touristOfficeCode": "string",
    "conservationStatus": "1",
    "externalContactUrl": "string",
    "rentReferenceIndex": "string",
    "hasOnlineGuidedTour": false,
    "addressVisibilityMode": "3",
    "rentWithOptionToBuyRelatedAd": "string"
  }
}

{
  "success": false,
  "message": "Invalid payload provided. Please ensure: 1) 'Content-Type: application/json' is included in your request headers 2) Request body contains valid JSON data.",
  "error": {
    "issues": [
      {
        "code": "too_small",
        "minimum": 1,
        "type": "array",
        "inclusive": true,
        "exact": false,
        "message": "Array must contain at least 1 element(s)",
        "path": [
          "urls"
        ]
      }
    ],
    "name": "ZodError"
  }
}

{
  "success": false,
  "message": "Internal server error"
}

property details

Authorization

Query Parameters

Header Parameters

Response Body

200application/json

400application/json

500application/json

`application/json`

`application/json`

`application/json`