Zillow Locations

Get Zillow region and address suggestions.

GET/api/v1/zillow/locations

Costs 1 credit per request; failed requests are refunded. Authentication, the search_metadata envelope and error codes are the same as for every endpoint (see the API reference). Try it in the playground.

Parameters

Request parameters

Get Zillow region and address suggestions.

Parameter	Type	Description
`q`	string	City, ZIP code, neighborhood or street address. Required on the first page; omit with page_token.Up to 200 characters.
`type`	"regions" \| "addresses"	Find regions or addresses. Defaults to regions; omit with page_token.Region suggestions include Zillow region IDs. Address suggestions return names; this route does not return property ZPIDs or coordinates.
`limit`	integer	Suggestions per page, from 1 to 100. Defaults to 10; omit with page_token.Range: 1 to 100.Follow pagination.next or send pagination.next_page_token as page_token. Each lookup supports up to 1,000 suggestions; if pagination.possibly_truncated is true, refine q.
`page_token`	string	Opaque next_page_token from the preceding response. Send it alone to continue the same lookup.Up to 32,768 characters.Continue the same query, suggestion type and page size without repeating previously returned suggestions. If pagination.next is null while has_more is true, send page_token through POST JSON.

Response

A JSON object with search_metadata (request id, credits used and remaining) and the result data: locations. Groups and fields depend on the content of each page, so treat every field as optional.

Examples

cURL

curl "https://serpfast.com/api/v1/zillow/locations?q=Seattle%2C+WA&type=regions&limit=5" \
  -H "Authorization: Bearer $SERPFAST_KEY"

Node.js 18+

const params = new URLSearchParams({
  "q": "Seattle, WA",
  "type": "regions",
  "limit": 5
});
const res = await fetch(`https://serpfast.com/api/v1/zillow/locations?${params}`, {
  headers: { Authorization: `Bearer ${process.env.SERPFAST_KEY}` },
});
const data = await res.json();
console.log(data);

Python

import os, requests

params = {
  "q": "Seattle, WA",
  "type": "regions",
  "limit": 5
}
res = requests.get(
    "https://serpfast.com/api/v1/zillow/locations",
    params=params,
    headers={"Authorization": f"Bearer {os.environ['SERPFAST_KEY']}"},
    timeout=120,
)
print(res.json())