/fotocasa/properties/search

curl --request POST \
  --url https://api.anysite.io/api/fotocasa/properties/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "location": "<string>",
  "count": 2,
  "timeout": 300,
  "transaction": "comprar",
  "property_type": "viviendas",
  "owner": "todos",
  "sort": "relevancia",
  "min_price": 1,
  "max_price": 1,
  "min_surface": 1,
  "max_surface": 1,
  "min_rooms": 1,
  "max_rooms": 1,
  "min_bathrooms": 1,
  "bank_only": false
}
'

[
  {
    "id": "<string>",
    "@type": "@fotocasa_property_card",
    "real_estate_ad_id": "<string>",
    "url": "<string>",
    "property_type": "<string>",
    "transaction_type": "<string>",
    "price": 123,
    "price_drop": 123,
    "price_per_m2": 123,
    "surface": 123,
    "room_count": 123,
    "bathroom_count": 123,
    "floor": 123,
    "condition": "<string>",
    "antiquity": "<string>",
    "orientation": "<string>",
    "is_furnished": true,
    "description": "<string>",
    "created_at": "<string>",
    "is_new": true,
    "is_new_construction": true,
    "is_occupied": true,
    "is_auctioned": true,
    "is_bare_ownership": true,
    "is_rented_with_tenants": true,
    "is_premium": true,
    "has_video": true,
    "has_virtual_tour": true,
    "has_quality_seal": true,
    "features": [],
    "address": {
      "@type": "@fotocasa_address",
      "street": "<string>",
      "street_number": 123,
      "neighborhood": "<string>",
      "district": "<string>",
      "municipality": "<string>",
      "locality": "<string>",
      "region": "<string>",
      "province": "<string>",
      "autonomous_community": "<string>",
      "country": "<string>",
      "zip_code": "<string>",
      "coordinates": {
        "@type": "@fotocasa_coordinates",
        "latitude": 123,
        "longitude": 123
      }
    },
    "images": [],
    "agency": {
      "@type": "@fotocasa_card_agency",
      "client_id": "<string>",
      "name": "<string>",
      "type": "<string>",
      "url": "<string>",
      "publisher_id": "<string>"
    }
  }
]

/fotocasa

/fotocasa/properties/search

Search Fotocasa real estate properties by location (city, municipality or neighbourhood) with transaction (comprar/alquiler), property type, an extra feature or situation filter, publisher type, price, surface, room and bathroom filters and ordering. Returns property cards with property and transaction type, price, price per m², surface, rooms, bathrooms, floor, condition, antiquity, orientation, furnished flag, amenity features, description, publication date, flags, address, photos, the property detail url and the listing agency.

Price: 1 credit

💡 AI Hint: Search Fotocasa properties in a location. location is a city or municipality (‘Madrid’, ‘Barcelona’); transaction selects comprar (for sale) or alquiler (for rent); property_type filters the dwelling type (pisos, casas, chalets, aticos, …); feature applies one extra feature or situation (terraza, ascensor, piscina, obra-nueva, lujo, …); owner filters particular vs all; sort orders by price, surface or date; min_price/max_price, min_surface/max_surface, min_rooms/max_rooms and min_bathrooms narrow the results; bank_only restricts to bank-owned properties. Each result has id, real_estate_ad_id, url, property_type, transaction_type, price, price_drop, price_per_m2, surface, room_count, bathroom_count, floor, condition, antiquity, orientation, is_furnished, features (amenity keys such as elevator, air_conditioner, parking, terrace, storage_room, balcony), description, created_at, flags (is_new, is_new_construction, is_occupied, is_auctioned, is_bare_ownership, is_rented_with_tenants, is_premium, has_video, has_virtual_tour, has_quality_seal), address, images and agency (client_id, name, type, url, publisher_id).

⚠️ Common errors: 412: Location could not be resolved

POST

api

fotocasa

properties

/fotocasa/properties/search

curl --request POST \
  --url https://api.anysite.io/api/fotocasa/properties/search \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "location": "<string>",
  "count": 2,
  "timeout": 300,
  "transaction": "comprar",
  "property_type": "viviendas",
  "owner": "todos",
  "sort": "relevancia",
  "min_price": 1,
  "max_price": 1,
  "min_surface": 1,
  "max_surface": 1,
  "min_rooms": 1,
  "max_rooms": 1,
  "min_bathrooms": 1,
  "bank_only": false
}
'

[
  {
    "id": "<string>",
    "@type": "@fotocasa_property_card",
    "real_estate_ad_id": "<string>",
    "url": "<string>",
    "property_type": "<string>",
    "transaction_type": "<string>",
    "price": 123,
    "price_drop": 123,
    "price_per_m2": 123,
    "surface": 123,
    "room_count": 123,
    "bathroom_count": 123,
    "floor": 123,
    "condition": "<string>",
    "antiquity": "<string>",
    "orientation": "<string>",
    "is_furnished": true,
    "description": "<string>",
    "created_at": "<string>",
    "is_new": true,
    "is_new_construction": true,
    "is_occupied": true,
    "is_auctioned": true,
    "is_bare_ownership": true,
    "is_rented_with_tenants": true,
    "is_premium": true,
    "has_video": true,
    "has_virtual_tour": true,
    "has_quality_seal": true,
    "features": [],
    "address": {
      "@type": "@fotocasa_address",
      "street": "<string>",
      "street_number": 123,
      "neighborhood": "<string>",
      "district": "<string>",
      "municipality": "<string>",
      "locality": "<string>",
      "region": "<string>",
      "province": "<string>",
      "autonomous_community": "<string>",
      "country": "<string>",
      "zip_code": "<string>",
      "coordinates": {
        "@type": "@fotocasa_coordinates",
        "latitude": 123,
        "longitude": 123
      }
    },
    "images": [],
    "agency": {
      "@type": "@fotocasa_card_agency",
      "client_id": "<string>",
      "name": "<string>",
      "type": "<string>",
      "url": "<string>",
      "publisher_id": "<string>"
    }
  }
]

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

location

string

required

City, municipality or neighbourhood to search in

Minimum string length: 1

Examples:

"Madrid"

"Barcelona"

"Valencia"

count

integer

required

Max number of results to return

Required range: x >= 1

timeout

integer

default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

transaction

enum<string>

default:comprar

Transaction type

Available options:

comprar,

alquiler

property_type

enum<string>

default:viviendas

Property type filter

Available options:

viviendas,

pisos,

apartamentos,

aticos,

duplex,

estudios,

lofts,

plantas-intermedias,

bajos,

chalets,

adosados,

casas-rurales,

locales,

oficinas,

garajes,

trasteros,

naves-industriales,

edificios,

terrenos,

terrenos-residenciales,

terrenos-urbanizables,

terrenos-industriales

feature

enum<string> | null

Single extra feature or situation filter

Available options:

obra-nueva,

terraza,

ascensor,

piscina,

jardin,

amueblado,

no-amueblado,

subasta,

nuda-propiedad,

ocupado,

con-inquilino,

con-ayudas,

chimenea,

vistas-al-mar,

en-primera-linea-de-mar,

chollo,

aisladas,

lujo,

modernas,

campo,

prefabricadas,

unifamiliares,

villa,

vpo

owner

enum<string>

default:todos

Publisher type filter

Available options:

todos,

particular

sort

enum<string>

default:relevancia

Result ordering

Available options:

relevancia,

recientes,

precio-asc,

precio-desc,

superficie-desc,

superficie-asc

min_price

integer | null

Minimum price filter

Required range: x >= 0

max_price

integer | null

Maximum price filter

Required range: x >= 0

min_surface

integer | null

Minimum surface filter in m²

Required range: x >= 0

max_surface

integer | null

Maximum surface filter in m²

Required range: x >= 0

min_rooms

integer | null

Minimum number of rooms filter

Required range: x >= 0

max_rooms

integer | null

Maximum number of rooms filter

Required range: x >= 0

min_bathrooms

integer | null

Minimum number of bathrooms filter

Required range: x >= 0

bank_only

boolean

default:false

Only properties from banks

Response

Successful Response

string

required

@type

string

default:@fotocasa_property_card

real_estate_ad_id

string | null

url

string | null

property_type

string | null

transaction_type

string | null

price

integer | null

price_drop

integer | null

price_per_m2

number | null

surface

integer | null

room_count

integer | null

bathroom_count

integer | null

floor

integer | null

condition

string | null

antiquity

string | null

orientation

string | null

is_furnished

boolean | null

description

string | null

created_at

string | null

is_new

boolean | null

is_new_construction

boolean | null

is_occupied

boolean | null

is_auctioned

boolean | null

is_bare_ownership

boolean | null

is_rented_with_tenants

boolean | null

is_premium

boolean | null

has_video

boolean | null

has_virtual_tour

boolean | null

has_quality_seal

boolean | null

features

string[]

address

FotocasaAddress · object

Show child attributes

images

string[]

agency

FotocasaCardAgency · object

Show child attributes

/fotocasa/properties /funda/agents