Fotocasa API

Search Fotocasa, one of Spain's main property portals, and pull listings, prices and agencies as JSON.

The API.SH Fotocasa API returns public listings from Fotocasa.es, the Spanish real estate portal, as structured JSON. Search homes and other property anywhere in Spain to buy, rent, share or rent-to-buy, with the site's filters for place, price, rooms, bathrooms, area, condition, new build and features such as pool, terrace, lift and parking. Open a listing for its price drop, every feature, energy certificate, coordinates and photos, list one agency's listings, and resolve place names to location ids.

Get a free API key Try it in the playground

4 endpoints
from $1 / 1,000 calls
1,000 free credits / month
failed calls free

Fotocasa property search

GET https://api.api.sh/fotocasa/v1/search

{ "success": true }

1 credit · $1 per 1,000 calls

What you can build with the Fotocasa API

Spanish housing market analysis

Search a city or district for sale or rent with price, area and room filters, and compare asking prices, area and rooms by neighborhood.

/places /search

Price drop tracking

Track listings over time and record each price drop to see where sellers are cutting prices.

/search /listing

Rental yield research

Combine sale and rental searches for the same place to estimate gross yields for investors.

/search

Agency competitor monitoring

Pull every listing of a competing agency with its prices and property types to follow its stock.

/agency

Property alerts and apps

Open the newest listing that matches a saved search and push it to a buyer, renter or CRM with full details and photos.

/listing

Fotocasa data you get

Field names from real responses. Numbers come parsed, URLs absolute, dates in ISO 8601.

Fotocasa API endpoints and prices

Every Fotocasa endpoint costs 1 credit per call: credits are $1 per 1,000 on a monthly plan, $2 pay-as-you-go. Pricing

Search and discovery2

Fotocasa place suggestions /fotocasa/v1/places	$1 · $2 PAYG 1 credit
Fotocasa property search /fotocasa/v1/search	$1 · $2 PAYG 1 credit

Products, listings and places2

Fotocasa agency listings /fotocasa/v1/agency	$1 · $2 PAYG 1 credit
Fotocasa listing /fotocasa/v1/listing	$1 · $2 PAYG 1 credit

Call the Fotocasa API

Fotocasa property search: GET https://api.api.sh/fotocasa/v1/search

curl "https://api.api.sh/fotocasa/v1/search?location=Madrid" \
  -H "x-api-key: $APISH_KEY"

import os, requests

res = requests.get(
    "https://api.api.sh/fotocasa/v1/search",
    params={"location": "Madrid"},
    headers={"x-api-key": os.environ["APISH_KEY"]},
    timeout=120,
)
res.raise_for_status()
data = res.json()

const url = new URL("https://api.api.sh/fotocasa/v1/search");
url.searchParams.set("location", "Madrid");

const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json();

# Google Sheets (API.SH add-on)
=APISH("/fotocasa/v1/search", "location", "Madrid")

# Zapier, Make, n8n (verified node): pick the API.SH app,
# choose "Fotocasa" and "Fotocasa property search".

# AI agents (Claude, ChatGPT, Cursor): add the
# API.SH MCP server https://api.sh/mcp

Create a free accountConfirm your email and get 1,000 free credits every month. No card needed.
Create an API keyOne key works for all 482 platforms.
Send the requestJSON back in one call. Add output=csv or output=ndjson for files.

Why API.SH for Fotocasa data

Public data only: no Fotocasa login, cookies or account needed
One key and one response shape for Fotocasa and 481 other platforms
Built and maintained by API.SH, not third-party publishers
Pay per call; errors on our side cost nothing
Live status for every endpoint

API.SH vs the official Fotocasa API

Fotocasa's APIs are for professionals: a legacy SOAP web service and the Fotocasa Pro API key that agencies and CRMs use to publish listings. Neither is a public API for reading market data; API.SH returns public listings as JSON with no account.

Skip maintaining a Python or Selenium scraper for Fotocasa or running an Apify actor: API.SH gives you the site's own filters, one key and a fixed price per call, and blocks and retries are handled for you.

Fotocasa API questions

What Fotocasa data can I get?+

Property search across Spain with the site's filters (/fotocasa/v1/search), one listing with every feature, energy rating, coordinates and photos (/fotocasa/v1/listing), an agency's listings (/fotocasa/v1/agency) and place suggestions with location ids (/fotocasa/v1/places).

How much does the Fotocasa API cost?+

Every Fotocasa endpoint costs 1 credit per call. On a monthly plan 1,000 credits cost $1 (Starter is $50/month for 50,000 credits). Pay-as-you-go is $2 per 1,000 credits, with top-ups from $15 that never expire.

Is there a free trial?+

Yes. Every account gets 1,000 free credits every month. That is 1,000 calls to /fotocasa/v1/agency at 1 credit each.

Is there an official Fotocasa API?+

Only for professionals. Fotocasa offers a web service and a Fotocasa Pro API key so agencies and CRMs can publish their listings. It is not meant for reading market data, which is what API.SH does from public pages.

Do I need a Fotocasa account or login?+

No. API.SH reads public Fotocasa pages only. A private seller's phone number is left out.

Can I scrape Fotocasa with Python?+

You don't need to: call this API from Python with any HTTP library or the API.SH Python SDK and get JSON back. Scraping public listings should follow Fotocasa's terms and Spanish and EU law, especially for personal data.

Can I search by city or neighborhood?+

Yes. Pass a place name as location, or look it up first with /fotocasa/v1/places to get the exact location_id for a city, district or neighborhood.

How do I get started?+

1. Sign up at api.sh. 2. Copy your API key. 3. Call /fotocasa/v1/search with location set to a Spanish city and operation set to buy or rent. Request examples and every parameter are in the docs at https://api.sh/docs. You can also use the JS or Python SDK, Google Sheets, Zapier, Make, n8n or the MCP server at https://api.sh/mcp.