# Fotocasa Scraper: Spain Property Listings, Prices, Agents (`themineworks/fotocasa-scraper`) Actor

Scrape Fotocasa and Habitaclia property listings in Spain by place or search link: price, price per m2, size, rooms, bathrooms, address, coordinates, photos, agency name and phone, published date. Buy, rent, share. No login.

- **URL**: https://apify.com/themineworks/fotocasa-scraper.md
- **Developed by:** [The Mine Works](https://apify.com/themineworks) (community)
- **Categories:** Real estate, Lead generation, Automation
- **Features:** Limited permissions
- **Stats:** 2 total users, 1 monthly users, 100.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $0.63 / 1,000 listings

This Actor is paid per event. You are not charged for the Apify platform usage, but only a fixed price for specific events.
Since this Actor supports Apify Store discounts, the price gets lower the higher subscription plan you have.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## Fotocasa Scraper: Spain Property Listings, Prices, Agents

[![60 Fotocasa listings in Madrid with price, size, rooms and agency phone in 5 seconds](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/fotocasa-scraper-hero.png)](https://console.apify.com/actors/0wCPYdh6dVIOVNKAx/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

Returns Fotocasa property listings in Spain by place name or search link, one row per listing with price, price per m2, size, bedrooms, bathrooms, address, coordinates, photos, published date and the agency with its phone. Habitaclia, Fotocasa's sister site, is in the same actor and adds the agency email and the energy certificate. No login, no cookies, no API key. You pay $0.90 per 1,000 listings on the Free plan and $0.63 per 1,000 on the Gold plan, plus a $0.001 start fee per run.

From **The Mine Works**, with over 335,000 runs across 330+ public actors.

Updated 12 Nov 2026: first release. Fotocasa and Habitaclia, buy, rent, rooms to share and business transfers, homes, garages, land, premises, offices, storage rooms and buildings, price, size, bedroom and bathroom filters, six sort orders and a "published in the last N days" switch for daily alerts, one flat row per listing. Bookmark this Actor on its Store page so it is one click away next time.

### Why choose this actor?

- **Type a place, get listings.** Write Madrid, Chamberi, Marbella or Costa del Sol the way you would on the site; the actor looks the place up in the site's own location search and reads every results page. Or paste a search link with the filters you already set on Fotocasa or Habitaclia.
- **The numbers you compare, in columns.** `price`, `price_per_m2`, `price_drop`, `size_m2`, `rooms`, `bathrooms` and `floor` are separate fields, with `latitude` and `longitude` on every row, so a whole city sorts by euros per m2 in a spreadsheet without cleaning text.
- **The agency next to the listing.** Agency name, page on the site and public phone on Fotocasa; on Habitaclia also the email, website and agency reference. `advertiser_type` tells agencies from private sellers. In our 1,500 row Fotocasa rental test, 1,068 rows carried an agency phone; on Habitaclia 300 of 300 rows carried phone and email.
- **Pay per listing, nothing for errors.** Places the site does not know, links from other sites, the summary row and listings found twice in one run are never charged.

[![Run it on Apify](https://api.apify.com/v2/key-value-stores/cUXz95yxflDho41nn/records/button-run.png)](https://console.apify.com/actors/0wCPYdh6dVIOVNKAx/input?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Part of The Mine Works Real estate family:** [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [99acres Scraper](https://apify.com/themineworks/99acres-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral), [MagicBricks Scraper](https://apify.com/themineworks/magicbricks-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral).

### Try it in one minute

Paste this into the input (JSON view) and press Start. It returns the first 60 homes for sale in Madrid. It took 5 seconds in our test run on Apify:

```json
{
  "locations": ["Madrid"],
  "maxItems": 60
}
```

Put several places on separate lines to run several searches at once, or paste Fotocasa and Habitaclia search links into `startUrls`. A listing that two of your searches find is delivered once.

Apify's free plan includes $5 of credit every month, which covers about 5,500 listings at this actor's price.

#### Copy to your AI assistant

```text
themineworks/fotocasa-scraper on Apify. Reads Spanish property listings from Fotocasa (and Habitaclia) by place name or search link and returns one flat row per listing, no login. Call ApifyClient("TOKEN").actor("themineworks/fotocasa-scraper").call(run_input={"locations": ["Madrid"], "operation": "rent", "maxItems": 200}), then client.dataset(run["defaultDatasetId"]).list_items().items. Give locations (place names in Spain) or startUrls (fotocasa.es or habitaclia.com search results links) or both; up to 100 searches. Optional: site (fotocasa or habitaclia, default fotocasa, for place names), operation (buy, rent, share, transfer), propertyType (homes, garages, land, premises, offices, storage, buildings, industrial), maxItems (default 100, 1 to 10000, per search), sortBy (relevance, newest, cheapest, most_expensive, largest, smallest), minPrice, maxPrice, minSize, maxSize, minRooms, minBathrooms, publishedWithinDays. Listing rows have no _type field and carry site, listing_id, url, title, operation, property_type, property_subtype, price, currency, price_period, price_per_m2, price_drop, size_m2, rooms, bathrooms, floor, features, address, neighborhood, district, municipality, province, region, zip_code, latitude, longitude, description, image_urls, image_count, has_virtual_tour, is_new_construction, development_name, agency_name, agency_id, agency_url, agency_phone, agency_email, agency_website, advertiser_type, energy_rating, energy_consumption, emissions_rating, reference, published_at, updated_at, is_top, search_input, search_location, page, position, scraped_at. Each run also writes one row with _type "summary", one with _type "info" when listings were delivered, and a row with _type "error" for each input that could not be read; none of these is charged. Full spec: GET https://api.apify.com/v2/acts/themineworks~fotocasa-scraper/builds/default (Bearer TOKEN), which returns inputSchema and readme.
```

### Key features

- **Place names or links.** A town, city, district, neighbourhood or province name is matched in the site's own location search; the summary row shows which place was matched. A pasted results link keeps its own location and filters, such as `?maxPrice=1500`.
- **Two portals, one row shape.** Fotocasa covers all of Spain. Habitaclia, from the same group, is strongest in Catalonia and adds `agency_email`, `agency_website`, `reference`, `energy_rating`, `energy_consumption` and `emissions_rating`. Every row says which `site` it came from.
- **Buy, rent, share and transfers.** Homes (flats, houses, penthouses, duplexes, studios), garages, land, commercial premises, offices, storage rooms, buildings and, on Habitaclia, industrial units.
- **Filters and six sort orders.** Price, size, bedrooms and bathrooms, sorted by relevance, newest, cheapest, most expensive, largest or smallest.
- **New listing alerts.** `publishedWithinDays: 1` sorts by newest and stops at the first page older than a day, so a daily scheduled run pays only for what is new.
- **Deep searches.** Fotocasa serves 30 listings a page and Habitaclia 20; the actor reads page after page to the end of the results, 12,000 and more for a big city on Fotocasa (Habitaclia stops at 10,000 per search).
- **Stops cleanly.** A refused call is retried on a new IP; six failed calls in a row end the run; the run stops before its time limit and keeps every row it read. The summary row says why.

### How to use it

#### Basic: homes for sale in one city

```json
{
  "locations": ["Valencia"],
  "maxItems": 300
}
```

#### Rentals with filters in several cities

```json
{
  "locations": ["Barcelona", "Valencia", "Sevilla"],
  "operation": "rent",
  "minRooms": 2,
  "maxPrice": 1800,
  "maxItems": 500
}
```

#### Habitaclia agencies with email in Catalonia

```json
{
  "site": "habitaclia",
  "locations": ["Girona", "Tarragona", "Sabadell"],
  "maxItems": 200
}
```

#### Daily alert: new listings since yesterday

```json
{
  "locations": ["Madrid", "Malaga"],
  "publishedWithinDays": 1,
  "maxItems": 1000
}
```

Save it as a task and schedule it every morning.

#### Your own search link

```json
{
  "startUrls": [
    "https://www.fotocasa.es/es/comprar/viviendas/marbella/todas-las-zonas/l?minPrice=500000",
    "https://www.habitaclia.com/comprar/viviendas/barcelona-provincia/barcelona-capital/s"
  ],
  "maxItems": 150
}
```

### Input parameters

| Parameter | Type | Default | What it does |
|---|---|---|---|
| `locations` | list of text | | Places in Spain, one per line. Each is one search. |
| `site` | text | `fotocasa` | `fotocasa` or `habitaclia`, for place names. Links are read on their own site. |
| `operation` | text | `buy` | `buy`, `rent`, `share` (rooms) or `transfer` (traspasos, Fotocasa only). |
| `propertyType` | text | `homes` | `homes`, `garages`, `land`, `premises`, `offices`, `storage`, `buildings`, `industrial`. |
| `startUrls` | list of links | | Fotocasa or Habitaclia results links. |
| `maxItems` | number | 100 | Most listings per search, 1 to 10,000. |
| `sortBy` | text | `relevance` | `relevance`, `newest`, `cheapest`, `most_expensive`, `largest`, `smallest`. |
| `minPrice`, `maxPrice` | number | | Euros; monthly rent for rentals. |
| `minSize`, `maxSize` | number | | Built area in m2. |
| `minRooms`, `minBathrooms` | number | | Fewest bedrooms or bathrooms. |
| `publishedWithinDays` | number | | Only listings published in the last N days (sorts by newest). |
| `proxyConfiguration` | proxy | Apify datacenter | Change only if you have a reason. |

### What data do you get?

| Field | What it is |
|---|---|
| `site`, `listing_id`, `url` | Portal, listing id and link |
| `title` | Listing title on Habitaclia; type, operation and place on Fotocasa |
| `operation`, `property_type`, `property_subtype` | buy or rent; home, garage and so on; flat, penthouse, studio, house_chalet and so on |
| `price`, `currency`, `price_period` | Asking price in EUR; `month` for rentals |
| `price_per_m2`, `price_drop` | Euros per m2; euros the price was cut by, when the site shows it |
| `size_m2`, `rooms`, `bathrooms`, `floor` | Built area, bedrooms, bathrooms, floor |
| `features` | Amenities such as elevator, parking, terrace, air_conditioner, swimming_pool |
| `address`, `neighborhood`, `district`, `municipality`, `province`, `region`, `zip_code` | Location as the listing shows it |
| `latitude`, `longitude` | Map position |
| `description`, `image_urls`, `image_count`, `has_virtual_tour` | Full text and photo links |
| `is_new_construction`, `development_name` | New build flag and development |
| `agency_name`, `agency_id`, `agency_url`, `agency_phone` | Advertiser and its public phone |
| `agency_email`, `agency_website`, `reference` | Habitaclia only |
| `advertiser_type` | `professional` or `private` |
| `energy_rating`, `energy_consumption`, `emissions_rating` | Energy certificate, Habitaclia only |
| `published_at`, `updated_at`, `is_top` | Dates and paid top placement |
| `search_input`, `search_location`, `page`, `position`, `scraped_at` | Where the row came from |

Private sellers' phones are not shown in search results on either site, so `agency_phone` is empty for them.

#### Output example

```json
{
  "site": "fotocasa",
  "listing_id": "191300433",
  "url": "https://www.fotocasa.es/es/alquiler/vivienda/barcelona-capital/aire-acondicionado-calefaccion-ascensor-amueblado-television-se-aceptan-mascotas-internet/191300433/d",
  "title": "apartment for rent in Carrer de París, 127, Eixample",
  "operation": "rent",
  "property_type": "home",
  "property_subtype": "apartment",
  "price": 2750,
  "currency": "EUR",
  "price_period": "month",
  "price_per_m2": 28.65,
  "price_drop": 763,
  "size_m2": 96,
  "rooms": 3,
  "bathrooms": 2,
  "floor": "11",
  "features": ["air_conditioner", "heater", "elevator"],
  "address": "Carrer de París, 127, Eixample",
  "neighborhood": "L'Antiga Esquerra de l'Eixample",
  "district": "Eixample",
  "municipality": "Barcelona Capital",
  "province": "Barcelona",
  "region": "Cataluña",
  "zip_code": "08036",
  "latitude": 41.390495,
  "longitude": 2.1487722,
  "image_count": 16,
  "agency_name": "Ukio",
  "agency_url": "https://www.fotocasa.es/es/pro/ukio/",
  "agency_phone": "+34623119277",
  "advertiser_type": "professional",
  "published_at": "2026-11-04T10:57:51.47Z",
  "search_input": "Barcelona",
  "page": 1,
  "position": 10
}
```

A Habitaclia row has the same fields plus, for example, `"agency_email": "info@agency.es"`, `"energy_rating": "E"`, `"energy_consumption": 188` and `"reference": "5295V"`.

### Pricing

Pay per event: you pay for the listings you receive, plus a flat $0.001 per run, whatever memory you choose.

| Event | When it is charged | Free plan | Bronze (Starter) | Silver (Scale) | Gold (Business) |
|---|---|---|---|---|---|
| `listing-scraped` | Once per listing row stored in your dataset | $0.90 per 1,000 | $0.81 per 1,000 | $0.72 per 1,000 | $0.63 per 1,000 |
| `run-start` | Once per run, after the first results page returned listings | $0.001 | $0.001 | $0.001 | $0.001 |

The price of one listing is the price per 1,000 divided by 1,000.

Never charged:

- places the site does not know, and links that are not Fotocasa or Habitaclia results (each gets an error row);
- a listing that a second search of the same run finds again;
- listings older than `publishedWithinDays`, and listings past your `maxItems`;
- the summary, info and error rows;
- a run whose searches return no listings: the start fee is charged only once a results page has returned listings;
- anything past your "Max cost per run". The actor checks the budget before each batch of rows and stops while the total is still below your limit, so the run ends SUCCEEDED with a partial result and a status message saying so.

### How it compares

| Actor | Price per 1,000 on the Free plan | Start fee | Input | Habitaclia | Agency phone |
|---|---|---|---|---|---|
| **This actor** | $0.90 | $0.001 per run | Place names or search links | Yes, with email and energy certificate | Yes |
| [Fotocasa Scraper by igolaizola](https://apify.com/igolaizola/fotocasa-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $1.00 | $0.001 per GB of memory | Location name or coordinates and radius | not stated | Yes |
| [Fotocasa.es Spain Real Estate Scraper by azzouzana](https://apify.com/azzouzana/fotocasa-es-search-results-scraper-by-search-url-ppr?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $1.00; full listing details $1.75 more | $0.005 per GB of memory | Search links | not stated | Yes |
| [Fotocasa Property Scraper by memo23](https://apify.com/memo23/fotocasa-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral) | $0.99; detail page data $0.80 more | $0.00005 per GB of memory | Search links or location | not stated | Yes |

Checked 11 Nov 2026 from the public Store listings.

### Run it on a schedule

1. Open the actor in Apify Console, set your input and click **Save as a new task**.
2. In the task, open **Schedules**, click **Add schedule** and pick how often (every day, every Monday at 08:00 and so on).
3. Use `publishedWithinDays: 1` for new listings only, or compare runs on `listing_id` and `price` to see price cuts and listings that left the market.
4. Optional: add an integration (Google Sheets, Slack, a webhook) so each run lands where your team works.

### FAQ

#### What does this actor read?

The same public search results fotocasa.es and habitaclia.com load in your browser when you search a place, as anyone sees them without logging in. It does not log in, contact advertisers or read anything behind an account.

#### Do I need an account, cookies or an API key?

No account, no cookies and no API key. Nothing to set up; the proxy is included.

#### How many listings can I get?

Up to 10,000 per place or link and 100 searches per run. Fotocasa shows every result of a search page by page (12,835 for homes for sale in Madrid in our test); Habitaclia stops at 10,000 per search. For more, split a province into towns or add filters.

#### Which place does a name match?

The best match in the site's own location search, preferring a town whose name is exactly what you typed. The summary row and the `search_location` field show the match. For a district or neighbourhood, type its name (Chamberi, Eixample); for an exact area, paste a results link instead.

#### Why do some rows have no price or no phone?

Some advertisers hide the price ("a consultar") and private sellers' phones are not shown in search results; those fields are then empty rather than guessed. In our tests, 3 of 2,392 rows had no price.

#### What is the difference between Fotocasa and Habitaclia rows?

Same fields and same row shape. Habitaclia also returns the agency email, website and reference and the energy certificate; Fotocasa returns the agency page link. Habitaclia has no rooms to share, transfers, premises or storage rooms filter.

#### How long does a run take?

In our tests on Apify (12 Nov 2026): 5 seconds for the "Try it" input (60 listings), 90 seconds for 1,500 rentals in Barcelona, Valencia and Sevilla, and 35 seconds for 300 Habitaclia listings in three cities.

#### Which formats can I download?

JSON, CSV, Excel, XML, RSS and HTML from the run's Storage tab or through the API. In CSV and Excel, lists such as `image_urls` and `features` are flattened into columns.

#### Can I use it from Claude, ChatGPT or Cursor (MCP)?

Yes, through Apify's MCP server. Connector URL: https://mcp.apify.com/?tools=themineworks/fotocasa-scraper

- Claude: Settings > Connectors > Add custom connector, paste the URL, sign in with Apify.
- ChatGPT: turn on developer mode, add an MCP connector with the URL, sign in with Apify.
- Cursor or VS Code: add it as an HTTP MCP server with that URL.
- Claude Code: `claude mcp add -t http fotocasa-scraper "https://mcp.apify.com/?tools=themineworks/fotocasa-scraper"`

#### Is it legal to scrape Fotocasa?

The actor reads only public listings that anyone can see without logging in: properties, prices and agency contacts that advertisers publish to be found. Listings can include personal data, such as a private seller's name, so you are responsible for how you use the data, including the sites' terms and data protection law such as GDPR and Spain's LOPDGDD. This is general information, not legal advice.

### Integrations

- **Google Sheets**: send each run's listings to a sheet with Apify's Google Sheets integration; one row per listing fits a sheet as is.
- **Make, Zapier and n8n**: start a run and read its dataset with the Apify apps and nodes, for example "new flats under 300,000 EUR in Valencia every morning to Slack".
- **Webhooks**: have Apify call your URL when a run succeeds, then fetch the dataset.
- **API and SDKs**: run it from Python or JavaScript with the Apify client, or with a plain HTTP call (see "Copy to your AI assistant" above).
- **MCP clients**: Claude, ChatGPT, Cursor and VS Code can run it as a tool through the connector URL in the FAQ.

If this actor saved you time, a short rating on the Store helps other buyers find it.

### More from The Mine Works

**Real estate**

- [Zillow Rentals Scraper](https://apify.com/themineworks/zillow-rental-listings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Sold Comps Scraper](https://apify.com/themineworks/zillow-recently-sold?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Real Estate MCP](https://apify.com/themineworks/india-real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Housing.com Scraper](https://apify.com/themineworks/housing-com-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [99acres Scraper](https://apify.com/themineworks/99acres-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [MagicBricks Scraper](https://apify.com/themineworks/magicbricks-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Property Scraper](https://apify.com/themineworks/zillow-property-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zillow Photos Scraper](https://apify.com/themineworks/zillow-photos?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Real Estate MCP](https://apify.com/themineworks/real-estate-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Airbnb Scraper](https://apify.com/themineworks/airbnb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Domain.com.au Property Scraper](https://apify.com/themineworks/domain-property-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [realestate.com.au Scraper](https://apify.com/themineworks/realestate-com-au-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Social media and video**

- [Threads Scraper](https://apify.com/themineworks/threads-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Reddit Scraper](https://apify.com/themineworks/reddit-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Threads Search Scraper](https://apify.com/themineworks/threads-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Instagram Profile Scraper](https://apify.com/themineworks/instagram-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Leads and business directories**

- [B2B Leads Finder](https://apify.com/themineworks/b2b-leads-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Skip Trace Lookup](https://apify.com/themineworks/skip-trace-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Maps Email Scraper](https://apify.com/themineworks/maps-leads?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [2GIS Places Scraper](https://apify.com/themineworks/2gis-places-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Marketing, SEO and reviews**

- [Facebook Ad Library Scraper](https://apify.com/themineworks/meta-ad-library-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google Ads Transparency Scraper](https://apify.com/themineworks/google-ads-transparency?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Similarweb Scraper](https://apify.com/themineworks/similarweb-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Google News Scraper](https://apify.com/themineworks/google-news?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**LinkedIn**

- [LinkedIn Company Scraper](https://apify.com/themineworks/linkedin-company-details?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Post Scraper](https://apify.com/themineworks/linkedin-post-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Employees Scraper](https://apify.com/themineworks/linkedin-employees?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [LinkedIn Profile Scraper](https://apify.com/themineworks/linkedin-profile-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Science, health and government data**

- [Academic Research MCP](https://apify.com/themineworks/academic-research-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [CourtListener Scraper](https://apify.com/themineworks/courtlistener-court-records?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Socrata Open Data Scraper](https://apify.com/themineworks/socrata-open-data?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [OpenAlex Scraper](https://apify.com/themineworks/openalex-scholarly-works?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Jobs and hiring**

- [Foundit Monster India Jobs](https://apify.com/themineworks/foundit-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Hirist Jobs Scraper](https://apify.com/themineworks/hirist-jobs-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [India Jobs MCP](https://apify.com/themineworks/india-jobs-mcp?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naukri Jobs Scraper](https://apify.com/themineworks/naukri-jobs?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Company and business data**

- [Company Domain Finder](https://apify.com/themineworks/company-domain-finder?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GST Taxpayer Lookup](https://apify.com/themineworks/gst-taxpayer-lookup?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Company KYB Resolver](https://apify.com/themineworks/company-identity-resolver?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [SEC EDGAR Filings Scraper](https://apify.com/themineworks/sec-edgar-filings?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**E-commerce and marketplaces**

- [Ozon.ru Scraper](https://apify.com/themineworks/ozon-product-search?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [⭐ Amazon Reviews Scraper](https://apify.com/themineworks/amazon-reviews?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Amazon Product Scraper](https://apify.com/themineworks/amazon-products?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Etsy Listings Scraper](https://apify.com/themineworks/etsy-search-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Food and local services**

- [NoBroker Scraper](https://apify.com/themineworks/nobroker-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Swiggy Restaurant Scraper](https://apify.com/themineworks/swiggy-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Zomato Scraper](https://apify.com/themineworks/zomato-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**Developer and AI tools**

- [Website to Markdown Crawler](https://apify.com/themineworks/rag-crawler?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Skill Finder](https://apify.com/themineworks/github-skill-discovery?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Repo Scraper](https://apify.com/themineworks/github-repo-intelligence?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [GitHub Trending Scraper](https://apify.com/themineworks/github-trending-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

**More tools**

- [G2 Reviews Scraper](https://apify.com/themineworks/g2-reviews-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Naver Blog Scraper](https://apify.com/themineworks/naver-blog-posts-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [WeChat Article Scraper 微信公众号文章](https://apify.com/themineworks/wechat-article-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)
- [Taobao Products Scraper 淘宝 天猫](https://apify.com/themineworks/taobao-products-scraper?fpr=ymnoit\&utm_source=apify-readme\&utm_medium=referral)

### Support

Found a place that returns fewer listings than the site, or a field that comes back empty? Open an issue in the Issues tab with the input and the run ID, and we will look at it. For a field you need or a new source, email dmineworks@gmail.com.

*Search Fotocasa and Habitaclia by place or link and get every property back as one row, with price, price per m2, size, rooms, address, coordinates, photos and the agency with its phone, no login.*

# Actor input Schema

## `locations` (type: `array`):

Towns, cities, districts or provinces in Spain, one per line, as you would type them in the site's search box. Example: Madrid, Sevilla, Chamberi, Marbella. Each place is one search. Up to 100 searches per run.

## `site` (type: `string`):

Which portal the place names are searched on. Fotocasa covers all of Spain. Habitaclia is strongest in Catalonia and adds the agency email and the energy certificate. Pasted links are always read on their own site.

## `operation` (type: `string`):

For sale, for rent, rooms to share or business transfers (traspasos, Fotocasa only).

## `propertyType` (type: `string`):

Homes covers flats, houses, penthouses, duplexes and studios. Premises and storage rooms are on Fotocasa only; industrial units on Habitaclia only.

## `startUrls` (type: `array`):

Fotocasa or Habitaclia search results links copied from your browser, with any filters you set on the site, for example https://www.fotocasa.es/es/alquiler/viviendas/barcelona-capital/todas-las-zonas/l or https://www.habitaclia.com/comprar/viviendas/barcelona-provincia/barcelona-capital/s. The link's own location and filters are used.

## `maxItems` (type: `integer`):

The most listings to return for each place or link, 1 to 10,000. A Fotocasa page holds 30 listings, a Habitaclia page 20.

## `sortBy` (type: `string`):

Order of the results. Largest and smallest work on Fotocasa only.

## `minPrice` (type: `integer`):

Lowest price in euros; monthly rent for rentals. Leave empty for no minimum.

## `maxPrice` (type: `integer`):

Highest price in euros; monthly rent for rentals. Leave empty for no maximum.

## `minSize` (type: `integer`):

Smallest built area in square metres.

## `maxSize` (type: `integer`):

Largest built area in square metres.

## `minRooms` (type: `integer`):

Fewest bedrooms, for example 2.

## `minBathrooms` (type: `integer`):

Fewest bathrooms, for example 2.

## `publishedWithinDays` (type: `integer`):

For new listing alerts: sorts by newest and stops at the first page older than this many days. Example: 1 for a daily run. Leave empty for all listings.

## `proxyConfiguration` (type: `object`):

Apify datacenter proxy is the default and works for both sites. Change it only if you have a reason.

## Actor input object example

```json
{
  "locations": [
    "Madrid"
  ],
  "site": "fotocasa",
  "operation": "buy",
  "propertyType": "homes",
  "maxItems": 60,
  "sortBy": "relevance",
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "locations": [
        "Madrid"
    ],
    "maxItems": 60,
    "proxyConfiguration": {
        "useApifyProxy": true
    }
};

// Run the Actor and wait for it to finish
const run = await client.actor("themineworks/fotocasa-scraper").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "locations": ["Madrid"],
    "maxItems": 60,
    "proxyConfiguration": { "useApifyProxy": True },
}

# Run the Actor and wait for it to finish
run = client.actor("themineworks/fotocasa-scraper").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "locations": [
    "Madrid"
  ],
  "maxItems": 60,
  "proxyConfiguration": {
    "useApifyProxy": true
  }
}' |
apify call themineworks/fotocasa-scraper --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,themineworks/fotocasa-scraper"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/0wCPYdh6dVIOVNKAx/builds/kwgSRLlk7sZpWTgfd/openapi.json
