GET /searchads

Authorization

RapidApiKey

X-RapidAPI-Key<token>

In: header

Query Parameters

combinedLocations*string

Get the Location from /location-suggestion endpoint.

longitude*string

Get the longitude from /location-suggestion endpoint.

latitude*string

Get the latitude from /location-suggestion endpoint.

pageNumber*string

Page number for pagination

size?string

Number of results per page (default: 30)

transactionType*string

Type of transaction: BUY or RENT

Value in"BUY" | "RENT"

propertyType*string

Type of property: HOMES, GARAGES, LAND, etc.

isNewConstruction?string

Filter for new construction properties (true/false)

sortOrderDesc?string

Sort order: true for descending, false for ascending

sortType*string

Sort criteria: RATING (default), LATEST (newest first), PRICE, SURFACE (area), etc.

conservationStatus?string

Property condition: ALMOST_NEW, VERY_GOOD, GOOD, FOR_RENOVATION, REFURBISHED (comma-separated)

publicationDate*string

Filter by listing age: INDIFFERENT, TWO_DAYS, ONE_WEEK, ONE_MONTH

Value in"INDIFFERENT" | "TWO_DAYS" | "ONE_WEEK" | "ONE_MONTH"

propertySubtypes?string

Specific types of homes (only for HOMES): HOUSE_CHALET, RURAL_PROPERTY, DUPLEX, etc. (comma-separated)

minPrice?string

Minimum price in euros

maxPrice?string

Maximum price in euros

minSurface?string

Minimum property size in square meters

maxSurface?string

Maximum property size in square meters

minRooms?string

Minimum number of rooms (bedrooms)

minBathrooms?string

Minimum number of bathrooms

Header Parameters

X-RapidAPI-Host*string

Default"fotocasa3.p.rapidapi.com"

Response Body

`application/json`

curl -X GET "https://example.com/searchads?combinedLocations=724%2C14%2C28%2C173%2C0%2C28079%2C0%2C0%2C0&longitude=-3.68624&latitude=40.4096&pageNumber=1&transactionType=BUY&propertyType=HOMES&sortType=RATING&publicationDate=INDIFFERENT" \  -H "X-RapidAPI-Host: fotocasa3.p.rapidapi.com"

{
  "success": true,
  "data": null
}

{
  "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"
}

searchads

Authorization

Query Parameters

Header Parameters

Response Body

200application/json

400application/json

500application/json

`application/json`

`application/json`

`application/json`