APIs / Real estate / Madlan

1 credit per call36 endpoints

Madlan API

Get Madlan data as structured JSON with one API key: search, search popular listings, search report and agent. Free credits every month.

Madlan
GET/v1/madlan/search?deal_type=unitRent&price_min=0&price_max=6000&beds=3&limit=3
curl "https://api.perceptlayer.com/v1/madlan/search?deal_type=unitRent&price_min=0&price_max=6000&beds=3&limit=3" \
  -H "X-API-Key: $API_KEY"
cURL1 credit per successful call
Run this call below or from your dashboard to see a live response.

Playground

Run this API

cURLshell
curl "https://api.perceptlayer.com/v1/madlan/search?deal_type=unitRent&price_min=0&price_max=6000&beds=3&limit=3" \
  -H "X-API-Key: $API_KEY"

Madlan · 36 endpoints

Endpoints

Every endpoint takes the same key. Open one for its parameters and an example request.

EndpointRequired parametersCost
GET/v1/madlan/agent
id
1 credit
GET/v1/madlan/agents
ids[]
1 credit
GET/v1/madlan/agents-index
none+4 optional
1 credit
GET/v1/madlan/analytics-market-stats
none
1 credit
GET/v1/madlan/analytics-sales-history
none+1 optional
1 credit
GET/v1/madlan/autocomplete
querytypes[]+1 optional
1 credit
GET/v1/madlan/developer
id
1 credit
GET/v1/madlan/developer-history
id
1 credit
GET/v1/madlan/developers
none+6 optional
1 credit
GET/v1/madlan/geo-addresses
doc_ids[]
1 credit
GET/v1/madlan/geo-doc-info
doc_ids[]
1 credit
GET/v1/madlan/listings
ids[]
1 credit
GET/v1/madlan/listings-ids
none+2 optional
1 credit
GET/v1/madlan/mortgage-offices
city_doc_ids[]+2 optional
1 credit
GET/v1/madlan/mortgage-offices-by-ids
office_ids[]+2 optional
1 credit
GET/v1/madlan/neighborhood-average-building-year
doc_id
1 credit
GET/v1/madlan/neighborhood-data
doc_id
1 credit
GET/v1/madlan/neighborhood-doc-insights
doc_id
1 credit
GET/v1/madlan/neighborhood-insights
doc_id
1 credit
GET/v1/madlan/neighborhood-investor-summary
doc_id
1 credit
GET/v1/madlan/neighborhood-permits-trend
doc_id
1 credit
GET/v1/madlan/neighborhood-price-change
doc_id+1 optional
1 credit
GET/v1/madlan/neighborhood-projects
doc_id+1 optional
1 credit
GET/v1/madlan/neighborhoods
city_doc_id
1 credit
GET/v1/madlan/office-agents
office_id+1 optional
1 credit
GET/v1/madlan/office-listings
office_id+1 optional
1 credit
GET/v1/madlan/project
id
1 credit
GET/v1/madlan/project-history
id
1 credit
GET/v1/madlan/projects
none+2 optional
1 credit
GET/v1/madlan/projects-browse
none+2 optional
1 credit
GET/v1/madlan/school
school_id
1 credit
GET/v1/madlan/schools
doc_id+2 optional
1 credit
GET/v1/madlan/search
none+8 optional
1 credit
GET/v1/madlan/search-popular-listings
none
1 credit
GET/v1/madlan/search-report
none
1 credit
GET/v1/madlan/valuation-gross-price
net_price
1 credit

Overview

About the Madlan API

What you can get

The Madlan API returns search, search popular listings, search report and agent as clean JSON. Each successful call costs one credit, and calls that fail are free.

Real estateJSONRESTMCP

More real estate APIs

Use cases

Monitor listing prices and new listings

Use the Madlan API to monitor listing prices and new listings

Pull comparables for valuations

Use the Madlan API to pull comparables for valuations

Power alerts and investment analysis

Use the Madlan API to power alerts and investment analysis

FAQ

Questions

How much does the Madlan API cost?

Each successful call costs one credit. New accounts get free credits every month, and credit packs bring the price down as you scale.

What format are responses in?

Every endpoint returns JSON, with no HTML parsing on your side.

Do I need a separate key for Madlan?

No. One key works for every API in the catalogue.

Try the Madlan API with 1,000 free credits

No credit card. Failed calls are never billed.