Zillow API endpoint
Returns Zillow autocomplete candidates, including region ids and types. Zillow autocomplete does not currently return map bounds.
/zillow/autocompleteMCP tool: zillow_autocomplete
Query parameters: query is required. limit and status are optional. limit defaults to 10 and is clamped to 20. status defaults to for_sale and accepts for_sale, for_rent, or sold (the aliases sale/for-sale and rent/for-rent are also accepted).
Returns Zillow autocomplete candidates, including region_id and region_type when Zillow supplies them. The autocomplete response does not currently include map bounds, so this endpoint cannot provide the west, east, south, and north values accepted by Zillow search. Region-only search remains available as a fallback, but Zillow has returned upstream 403/503 failures for that request shape.
Some semantic candidates are returned by Zillow with region_ids and region_types arrays instead of singular fields. The API keeps those arrays and also fills region_id and region_type from the first array values as compatibility aliases when Zillow omits the singular fields. The upstream result type and query resolution status are intentionally omitted from the public response.
| Field | Filled in, of 20 checked | Values in the sample |
|---|---|---|
| id | 20 | |
| region_id | 17 | |
| region_ids | 3 | |
| region_display_ids | 3 | |
| school_district_ids | 3 | |
| school_ids | 2 | |
| region_type | 2 | 4 to 6, median 4 |
| sub_type | 14 | NEIGHBORHOOD (12), CITY (1), COUNTY (1) |
| state | 14 | CA in all 14 |
| county | 14 | Los Angeles County in all 14 |
| city | 13 | Los Angeles (12), East Los Angeles (1) |
| Parameter | Type | Required | Default | Description | Example |
|---|---|---|---|---|---|
| query | string | Yes | Location query | Los Angeles, CA | |
| limit | integer | No | Maximum results, clamped to 20 | ||
| status | string | No | Search context. Allowed values: for_sale (aliases sale, for-sale), for_rent (aliases rent, for-rent), sold Allowed values: for_sale, sale, for-sale, for_rent, rent, for-rent, sold. | ||
| x-api-key (header) | string | Yes | API key required |
curl -X GET "https://api.crawlora.net/api/v1/zillow/autocomplete?query=Los+Angeles%2C+CA&limit=10&status=for_sale" \ -H "x-api-key: $CRAWLORA_API_KEY"
{
"code": 200,
"msg": "OK",
"data": {
"query": "Los Angeles, CA",
"request_id": "abc123",
"results": [
{
"id": "region-12447",
"region_id": 12447,
"region_type": 6,
"sub_type": "city",
"state": "CA",
"county": "Los Angeles County",
"city": "Los Angeles"
},
{
"id": "semantic",
"region_id": 12447,
"region_type": 6,
"region_ids": [
12447
],
"region_types": [
6
],
"region_display_ids": [
"12447"
]
}
]
}
}Request schema
No body schema
Response schema
#/definitions/zillow.AutocompleteResponse
| Field | Type | Required | Enum | Bounds | Example | Description |
|---|---|---|---|---|---|---|
| query | string | No | Los Angeles, CA | Query that was run. | ||
| request_id | string | No | Identifier Zillow gave to this autocomplete request. | |||
| results | array | No | Location suggestions, in the order Zillow returned them. | |||
| results[].city | string | No | Los Angeles | City name of the suggested place. | ||
| results[].county | string | No | Los Angeles County | County name of the suggested place. | ||
| results[].id | string | No | Identifier of the suggestion, as Zillow returns it. | |||
| results[].latitude | number | No | Latitude of the suggested location, in decimal degrees. | |||
| results[].longitude | number | No | Longitude of the suggested location, in decimal degrees. | |||
| results[].near_me | boolean | No | Whether the suggestion is Zillow's near-me search option. | |||
| results[].plid | string | No | Place identifier of the suggestion, as Zillow returns it. | |||
| results[].region_display_ids | array | No | Display ids of the regions listed in `region_ids`, as Zillow returns them. | |||
| results[].region_id | integer | No | 12447 | Zillow region id of the suggestion. Pass it as `region_id` to the search endpoint. | ||
| results[].region_ids | array | No | Zillow region ids covered by a suggestion that spans several regions. | |||
| results[].region_type | integer | No | 6 | Zillow region type code that goes with `region_id`. Pass it as `region_type` to the search endpoint. | ||
| results[].region_types | array | No | Zillow region type codes that match the region ids in `region_ids`. | |||
| results[].school_district_ids | array | No | Zillow ids of the school districts the suggestion refers to. | |||
| results[].school_ids | array | No | Zillow ids of the schools the suggestion refers to. | |||
| results[].state | string | No | CA | State abbreviation of the suggested place, such as `CA`. | ||
| results[].sub_type | string | No | Kind of place the suggestion is, such as `city`. | |||
| results[].view_latitude_delta | number | No | Latitude span of the map view Zillow suggests for this result. |
| Status | Description | Schema |
|---|---|---|
| 400 | Bad Request | #/definitions/app.Response |
| 429 | Too Many Requests | #/definitions/app.Response |
| 503 | Service Unavailable | #/definitions/app.Response |
Use environment variables for secrets and keep Crawlora API keys server-side.
curl -X GET "https://api.crawlora.net/api/v1/zillow/autocomplete?query=Los+Angeles%2C+CA&limit=10&status=for_sale" \
-H "x-api-key: $CRAWLORA_API_KEY"