---
title: "List Greystar unit search locations"
method: GET
path: "/greystar/unit-locations"
tags: ["Greystar"]
---

# List Greystar unit search locations

`GET /greystar/unit-locations`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/greystar/unit-locations`
- Auth: API key in header `x-api-key`

Lists every location accepted by /greystar/units: the nationwide us listing, states, metros, cities, and neighborhoods (nested ones carry their parent), taken from the site's own search pages. Locations Greystar has no unit listing for are dropped once detected.

## Query parameters

- `query` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GreystarUnitLocationList
  - `locations` GreystarUnitLocation[]
    - `location` string
    - `parent` string
    - `url` string
  - `total_count` integer

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)