/fotocasa/properties

curl --request POST \
  --url https://api.anysite.io/api/fotocasa/properties \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "property": "<string>",
  "timeout": 300
}
'

[
  {
    "id": "<string>",
    "@type": "@fotocasa_property",
    "url": "<string>",
    "title": "<string>",
    "property_type": "<string>",
    "transaction_type": "<string>",
    "construction_type": "<string>",
    "description": "<string>",
    "price": 123,
    "price_drop": 123,
    "price_per_m2": 123,
    "surface": 123,
    "land_surface": 123,
    "room_count": 123,
    "bathroom_count": 123,
    "floor": 123,
    "condition": "<string>",
    "antiquity": "<string>",
    "orientation": "<string>",
    "heating": "<string>",
    "is_furnished": true,
    "energy_class": "<string>",
    "emissions_class": "<string>",
    "is_auctioned": true,
    "is_bare_ownership": true,
    "is_occupied": true,
    "is_rented_with_tenants": true,
    "is_temporary_rental": true,
    "has_quality_seal": true,
    "created_at": "<string>",
    "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_property_agency",
      "id": "<string>",
      "name": "<string>",
      "alias": "<string>",
      "type": "<string>",
      "phone": "<string>",
      "web": "<string>",
      "image": "<string>",
      "publisher_id": "<string>"
    }
  }
]

/fotocasa

/fotocasa/properties

Get full Fotocasa real estate property details by property id (or property URL): title, property and transaction type, price, price drop and price per m², living and land surface, number of rooms and bathrooms, floor, condition, antiquity, orientation, heating, furnished flag, energy and emissions classes, full description, features, address (street, neighborhood, district, municipality, province, zip code and coordinates), photos and the listing agency.

Price: 1 credit

💡 AI Hint: Fetch a single Fotocasa property (vivienda) by numeric property id or a property URL. Returns one item with id, url, title, property_type, transaction_type, construction_type, description, price, price_drop, price_per_m2, surface, land_surface, room_count, bathroom_count, floor, condition, antiquity, orientation, heating, is_furnished, energy_class, emissions_class, is_auctioned, is_bare_ownership, is_occupied, is_rented_with_tenants, is_temporary_rental, has_quality_seal, created_at, features, address (street, street_number, neighborhood, district, municipality, locality, region, province, autonomous_community, country, zip_code, coordinates), images and agency (id, name, alias, type, phone, web, image, publisher_id).

⚠️ Common errors: 412: Property not found (well-formed but nonexistent or expired property id)

POST

api

fotocasa

properties

/fotocasa/properties

curl --request POST \
  --url https://api.anysite.io/api/fotocasa/properties \
  --header 'Content-Type: application/json' \
  --header 'access-token: <api-key>' \
  --data '
{
  "property": "<string>",
  "timeout": 300
}
'

[
  {
    "id": "<string>",
    "@type": "@fotocasa_property",
    "url": "<string>",
    "title": "<string>",
    "property_type": "<string>",
    "transaction_type": "<string>",
    "construction_type": "<string>",
    "description": "<string>",
    "price": 123,
    "price_drop": 123,
    "price_per_m2": 123,
    "surface": 123,
    "land_surface": 123,
    "room_count": 123,
    "bathroom_count": 123,
    "floor": 123,
    "condition": "<string>",
    "antiquity": "<string>",
    "orientation": "<string>",
    "heating": "<string>",
    "is_furnished": true,
    "energy_class": "<string>",
    "emissions_class": "<string>",
    "is_auctioned": true,
    "is_bare_ownership": true,
    "is_occupied": true,
    "is_rented_with_tenants": true,
    "is_temporary_rental": true,
    "has_quality_seal": true,
    "created_at": "<string>",
    "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_property_agency",
      "id": "<string>",
      "name": "<string>",
      "alias": "<string>",
      "type": "<string>",
      "phone": "<string>",
      "web": "<string>",
      "image": "<string>",
      "publisher_id": "<string>"
    }
  }
]

Authorizations

access-token

string

header

required

API token from the dashboard

Headers

access-token

string

required

Body

application/json

property

string

required

Fotocasa property id or a property URL containing it

Minimum string length: 1

Examples:

"189190562"

"https://www.fotocasa.es/es/comprar/vivienda/madrid-capital/x/189190562/d"

timeout

integer

default:300

Max scrapping execution timeout (in seconds)

Required range: 20 <= x <= 1500

Response

Successful Response

string

required

@type

string

default:@fotocasa_property

url

string | null

title

string | null

property_type

string | null

transaction_type

string | null

construction_type

string | null

description

string | null

price

integer | null

price_drop

integer | null

price_per_m2

number | null

surface

integer | null

land_surface

integer | null

room_count

integer | null

bathroom_count

integer | null

floor

integer | null

condition

string | null

antiquity

string | null

orientation

string | null

heating

string | null

is_furnished

boolean | null

energy_class

string | null

emissions_class

string | null

is_auctioned

boolean | null

is_bare_ownership

boolean | null

is_occupied

boolean | null

is_rented_with_tenants

boolean | null

is_temporary_rental

boolean | null

has_quality_seal

boolean | null

created_at

string | null

features

string[]

address

FotocasaAddress · object

Show child attributes

images

string[]

agency

FotocasaPropertyAgency · object

Show child attributes

/fotocasa/agencies/search /fotocasa/properties/search