---
title: "List Greystar markets, neighborhoods, cities, and states"
method: GET
path: "/greystar/markets"
tags: ["Greystar"]
---

# List Greystar markets, neighborhoods, cities, and states

`GET /greystar/markets`

## Request

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

Returns every value accepted by the /greystar/search market_area, neighborhood, city, state, and country_code filters, each with the number of communities currently published. Derived from the full live community list, so it is the complete value space.

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GreystarMarkets
  - `cities` GreystarCityItem[]
    - `city` string
    - `count` integer
    - `country_code` string
    - `state` string
  - `countries` GreystarCountryItem[]
    - `count` integer
    - `country_code` string
  - `market_areas` GreystarMarketItem[]
    - `count` integer
    - `country_code` string
    - `market_area` string
  - `neighborhoods` GreystarNeighborhood[]
    - `count` integer
    - `country_code` string
    - `market_area` string
    - `neighborhood` string
  - `states` GreystarStateItem[]
    - `count` integer
    - `country_code` string
    - `state` string
    - `state_name` string
  - `total_properties` integer

## Other responses

- `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/0497899e2016?raw)