---
title: "Madlan API: Autocomplete | Perceptlayer"
description: "Autocomplete from Madlan as JSON. 1 credit per successful call."
url: https://perceptlayer.com/apis/madlan/autocomplete
---

[APIs](https://perceptlayer.com/apis) / [Madlan](https://perceptlayer.com/apis/madlan) / Autocomplete

# Madlan: Autocomplete

Autocomplete from Madlan as JSON. 1 credit per successful call.

GET `/v1/madlan/autocomplete`

## Parameters

Send parameters in the query string.

| Parameter | Type | Required | Allowed values |
| --- | --- | --- | --- |
| `query` | string | Required | Up to 120 characters |
| `types[]` | list of string | Required | ADDRESS, CITY, STREET, NEIGHBOURHOOD, DISTRICT, ZIPCODE, PROJECT\_RESIDENTIAL, PROJECT\_COMMERCIAL, PROJECT\_RESIDENTIAL\_DRAFT, PROJECT\_COMMERCIAL\_DRAFT, DEVELOPER, CONSTRUCTOR, LAWYER, SALE\_AGENT, OFFICE, EDUCATION, SCHOOL, CUSTOM\_ZONE, MORTGAGE\_ADVISORS\_OFFICE, MORTGAGE\_ADVISORS\_OFFICE\_DRAFT |
| `limit` | integer | Optional | Any |

## Example request

cURL shell 

```
curl "https://api.perceptlayer.com/v1/madlan/autocomplete?query=%D7%AA%D7%9C+%D7%90%D7%91%D7%99%D7%91&limit=3" \
  -H "X-API-Key: $API_KEY"
```

[Run this endpoint in the playground](https://perceptlayer.com/apis/madlan?try=autocomplete#playground) with your own parameters. 1 credit per successful call; failed calls are free.