--- title: "Madlan API: JSON data, 36 endpoints, 1 credit per call" description: "Get Madlan data as structured JSON with one API key: search, search popular listings, search report and agent. Free credits every month." url: https://perceptlayer.com/apis/madlan --- [APIs](https://perceptlayer.com/apis) / [Real estate](https://perceptlayer.com/verticals/real-estate) / Madlan 1 credit per call 36 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. [Get a free API key](https://perceptlayer.com/signup) Run it below 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" ``` cURL 1 credit per successful call Run this call below or from your dashboard to see a live response. Playground ## Run this API cURL shell ``` 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. | Endpoint | Required parameters | Cost | | --- | --- | --- | | [GET `/v1/madlan/agent`](https://perceptlayer.com/apis/madlan/agent) | `id` | 1 credit | | [GET `/v1/madlan/agents`](https://perceptlayer.com/apis/madlan/agents) | `ids[]` | 1 credit | | [GET `/v1/madlan/agents-index`](https://perceptlayer.com/apis/madlan/agents-index) | none +4 optional | 1 credit | | [GET `/v1/madlan/analytics-market-stats`](https://perceptlayer.com/apis/madlan/analytics-market-stats) | none | 1 credit | | [GET `/v1/madlan/analytics-sales-history`](https://perceptlayer.com/apis/madlan/analytics-sales-history) | none +1 optional | 1 credit | | [GET `/v1/madlan/autocomplete`](https://perceptlayer.com/apis/madlan/autocomplete) | `query` `types[]` +1 optional | 1 credit | | [GET `/v1/madlan/developer`](https://perceptlayer.com/apis/madlan/developer) | `id` | 1 credit | | [GET `/v1/madlan/developer-history`](https://perceptlayer.com/apis/madlan/developer-history) | `id` | 1 credit | | [GET `/v1/madlan/developers`](https://perceptlayer.com/apis/madlan/developers) | none +6 optional | 1 credit | | [GET `/v1/madlan/geo-addresses`](https://perceptlayer.com/apis/madlan/geo-addresses) | `doc_ids[]` | 1 credit | | [GET `/v1/madlan/geo-doc-info`](https://perceptlayer.com/apis/madlan/geo-doc-info) | `doc_ids[]` | 1 credit | | [GET `/v1/madlan/listings`](https://perceptlayer.com/apis/madlan/listings) | `ids[]` | 1 credit | | [GET `/v1/madlan/listings-ids`](https://perceptlayer.com/apis/madlan/listings-ids) | none +2 optional | 1 credit | | [GET `/v1/madlan/mortgage-offices`](https://perceptlayer.com/apis/madlan/mortgage-offices) | `city_doc_ids[]` +2 optional | 1 credit | | [GET `/v1/madlan/mortgage-offices-by-ids`](https://perceptlayer.com/apis/madlan/mortgage-offices-by-ids) | `office_ids[]` +2 optional | 1 credit | | [GET `/v1/madlan/neighborhood-average-building-year`](https://perceptlayer.com/apis/madlan/neighborhood-average-building-year) | `doc_id` | 1 credit | | [GET `/v1/madlan/neighborhood-data`](https://perceptlayer.com/apis/madlan/neighborhood-data) | `doc_id` | 1 credit | | [GET `/v1/madlan/neighborhood-doc-insights`](https://perceptlayer.com/apis/madlan/neighborhood-doc-insights) | `doc_id` | 1 credit | | [GET `/v1/madlan/neighborhood-insights`](https://perceptlayer.com/apis/madlan/neighborhood-insights) | `doc_id` | 1 credit | | [GET `/v1/madlan/neighborhood-investor-summary`](https://perceptlayer.com/apis/madlan/neighborhood-investor-summary) | `doc_id` | 1 credit | | [GET `/v1/madlan/neighborhood-permits-trend`](https://perceptlayer.com/apis/madlan/neighborhood-permits-trend) | `doc_id` | 1 credit | | [GET `/v1/madlan/neighborhood-price-change`](https://perceptlayer.com/apis/madlan/neighborhood-price-change) | `doc_id` +1 optional | 1 credit | | [GET `/v1/madlan/neighborhood-projects`](https://perceptlayer.com/apis/madlan/neighborhood-projects) | `doc_id` +1 optional | 1 credit | | [GET `/v1/madlan/neighborhoods`](https://perceptlayer.com/apis/madlan/neighborhoods) | `city_doc_id` | 1 credit | | [GET `/v1/madlan/office-agents`](https://perceptlayer.com/apis/madlan/office-agents) | `office_id` +1 optional | 1 credit | | [GET `/v1/madlan/office-listings`](https://perceptlayer.com/apis/madlan/office-listings) | `office_id` +1 optional | 1 credit | | [GET `/v1/madlan/project`](https://perceptlayer.com/apis/madlan/project) | `id` | 1 credit | | [GET `/v1/madlan/project-history`](https://perceptlayer.com/apis/madlan/project-history) | `id` | 1 credit | | [GET `/v1/madlan/projects`](https://perceptlayer.com/apis/madlan/projects) | none +2 optional | 1 credit | | [GET `/v1/madlan/projects-browse`](https://perceptlayer.com/apis/madlan/projects-browse) | none +2 optional | 1 credit | | [GET `/v1/madlan/school`](https://perceptlayer.com/apis/madlan/school) | `school_id` | 1 credit | | [GET `/v1/madlan/schools`](https://perceptlayer.com/apis/madlan/schools) | `doc_id` +2 optional | 1 credit | | [GET `/v1/madlan/search`](https://perceptlayer.com/apis/madlan/search) | none +8 optional | 1 credit | | [GET `/v1/madlan/search-popular-listings`](https://perceptlayer.com/apis/madlan/search-popular-listings) | none | 1 credit | | [GET `/v1/madlan/search-report`](https://perceptlayer.com/apis/madlan/search-report) | none | 1 credit | | [GET `/v1/madlan/valuation-gross-price`](https://perceptlayer.com/apis/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 estate JSON REST MCP ### More real estate APIs [99acres](https://perceptlayer.com/apis/99acres) [Apartments.com](https://perceptlayer.com/apis/apartments-com) [Argenprop](https://perceptlayer.com/apis/argenprop) [Bayut](https://perceptlayer.com/apis/bayut) [Bien'ici](https://perceptlayer.com/apis/bienici) [Boliga](https://perceptlayer.com/apis/boliga) [Booli](https://perceptlayer.com/apis/booli) [Casa.it](https://perceptlayer.com/apis/casa-it) [Centris](https://perceptlayer.com/apis/centris) [Crexi](https://perceptlayer.com/apis/crexi) [Daft.ie](https://perceptlayer.com/apis/daft-ie) [Domain.com.au](https://perceptlayer.com/apis/domain-com-au) 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. [Get a free API key](https://perceptlayer.com/signup) [Read the docs](https://perceptlayer.com/docs)