Fotocasa: scrapers and the official API, compared

Route map

Each line is one way to get Fotocasa data; each stop is a field you probably need. Green lines are catalogue Actors, ranked by the published formula.

Field matrix: who returns what

Every tool with a published output schema, against the 7 fields most Fotocasa jobs need. A dot means the field name appears in the schema; rows can still leave it empty.

Field dictionary: the exact keys

The same core field has a different key in each Actor's output. Map these before you merge datasets; a dash means the published schema has no matching key. Need a field that is not listed here, such as email? Search every Fotocasa Actor by field.

Download this comparison: CSV · JSON (every tool with a published schema, matching keys per core field, price and score).

All 10 tools, scored

Catalogue Actors link to their detail pages; the score (0 to 100) is the published formula, identical for every tool. Other Store tools follow in their own table, for reference. Price is the published primary-result rate per 1,000 (the Free-plan rate where the price is tiered; higher Apify plans pay less); start events and platform usage are excluded.

Other Store tools, for reference

Scored with the same published formula and listed for comparison only; this site does not link or recommend them.

What to check before you choose

Spanish sale and rental listings support asking-price research, neighbourhood comparisons and agency inventory monitoring. Keep sale and rental collections separate so their prices remain meaningful within each analysis.

Choose a search-results route for a focused listing collection, then check whether a property-detail route adds the information your research needs. Fotocasa has no general public property API; partner arrangements are a separate access route.

Checklist

• Confirm that the chosen route accepts the sale or rental search you need and preserves the intended city, neighbourhood and property filters.
• Check how surface is defined before treating it as the area measure in a price comparison. The published schema does not explain its unit or measurement basis.
• Distinguish agencyName from an agency profile and propertyUrl from a stable property identifier, especially when building a recurring inventory collection.

Where the data is incomplete

The Spain Sale & Rental Listings Scraper lists city and neighborhood, but no street address or coordinates. That coverage supports broad location grouping without establishing the precision needed for street-level analysis.

The same published schema lists price, surface, bedrooms and bathrooms without detailed definitions. It also lacks an explicit sale-or-rental marker, so retain the search context when assembling the dataset.

Official API route

Terms and personal data

Restrict collection to public listings and check Fotocasa's terms before collecting or reusing listing content. Confirm that the planned use fits those conditions. This is general information, not legal advice.

Read Fotocasa's terms. Keep to public data, do not bypass logins or access controls, and check whether personal data is involved before you collect it. The can-I-scrape checklist walks through it.

How to start

1. Configure a narrow sale or rental collection using its documented inputs, retaining the location and transaction context.
2. Run the collection and inspect listing links, price, property size and location coverage before extending the search.

Call Fotocasa Spain Sale & Rental Listings Scraper from code

The example input uses the Actor's published defaults; set your own Fotocasa query before you run it. You need an Apify API token.

from apify_client import ApifyClient

client = ApifyClient("<YOUR_APIFY_TOKEN>")
run_input = {
    "mode": "search",
    "location": "madrid",
    "locationType": "auto",
    "operation": "sale",
    "propertyType": "homes",
    "features": [],
    "publishedSince": "any",
    "rentalType": "any",
    "ownerType": "any",
    "onlyPriceDrops": False,
    "sortBy": "relevance",
    "maxItems": 3,
    "fetchDetails": False,
    "maxDetails": 0,
    "monitorMode": False
}

run = client.actor("vexaloom-labs/fotocasa-spain-sale-and-rental-listings-scraper").call(run_input=run_input)
if run is None:
    raise RuntimeError("The Actor run was not found.")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

import { ApifyClient } from "apify-client";

const client = new ApifyClient({ token: "<YOUR_APIFY_TOKEN>" });
const input = {
    "mode": "search",
    "location": "madrid",
    "locationType": "auto",
    "operation": "sale",
    "propertyType": "homes",
    "features": [],
    "publishedSince": "any",
    "rentalType": "any",
    "ownerType": "any",
    "onlyPriceDrops": false,
    "sortBy": "relevance",
    "maxItems": 3,
    "fetchDetails": false,
    "maxDetails": 0,
    "monitorMode": false
};

const run = await client.actor("vexaloom-labs/fotocasa-spain-sale-and-rental-listings-scraper").call(input);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

curl -X POST "https://api.apify.com/v2/actors/vexaloom-labs~fotocasa-spain-sale-and-rental-listings-scraper/run-sync-get-dataset-items"   -H "Authorization: Bearer $APIFY_TOKEN"   -H "Content-Type: application/json"   -d '{"mode":"search","location":"madrid","locationType":"auto","operation":"sale","propertyType":"homes","features":[],"publishedSince":"any","rentalType":"any","ownerType":"any","onlyPriceDrops":false,"sortBy":"relevance","maxItems":3,"fetchDetails":false,"maxDetails":0,"monitorMode":false}'

{
  "mcpServers": {
    "apify": {
      "url": "https://mcp.apify.com?tools=vexaloom-labs/fotocasa-spain-sale-and-rental-listings-scraper",
      "headers": {
        "Authorization": "Bearer <YOUR_APIFY_TOKEN>"
      }
    }
  }
}

Questions people ask

More on Fotocasa

• Country comparisonSpain property data: Idealista and Fotocasa compared
• Topic groupReal estate data: every website compared
• ToolWhich Fotocasa route fits your job?
• ToolFotocasa cost by Apify plan, rows and runs

Related websites

• Idealista1 Actor
• Immowelt1 Actor

Sources

• Fotocasa Spain Sale & Rental Listings Scraper on Apify Store
• No public listing API documentation
• Fotocasa terms