Happy Endpoint

suggestions

Spanish real estate listings, property search, and market data across Spain.

GET
/suggestions

Authorization

RapidApiKey
X-RapidAPI-Key<token>

In: header

Query Parameters

query*string

Query to get location suggestions for

Length1 <= length <= 100

Header Parameters

X-RapidAPI-Host*string
Default"fotocasa3.p.rapidapi.com"

Response Body

application/json

application/json

application/json

curl -X GET "https://example.com/suggestions?query=madrid" \  -H "X-RapidAPI-Host: fotocasa3.p.rapidapi.com"
{
  "success": true,
  "data": [
    {
      "id": "level-5-id-28079-lang-0",
      "hasChildren": true,
      "childrenLevelId": 7,
      "type": "location",
      "groupCategory": 5,
      "suggestTypeId": 0,
      "localizationLevel5": "Madrid Capital",
      "combinedLocationIds": "724,14,28,173,0,28079,0,0,0",
      "coordinates": {
        "longitude": -3.68624,
        "latitude": 40.4096
      },
      "text": "Madrid Capital, Madrid",
      "baseText": "Madrid Capital",
      "poiCategory": 0,
      "isPoi": false
    }
  ]
}
{
  "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"
}