# Get daily neighborhood pricing data for a listing.

`GET /listings/{listing_id}/neighborhood/pricing`

> Wheelhouse Revenue Management API. Web version: https://docs.usewheelhouse.com/rm/reference/rm-get-neighborhood-pricing · OpenAPI spec: https://docs.usewheelhouse.com/rm/openapi.yaml · Operation ID: `rmGetNeighborhoodPricing` · Tag: Neighborhood Data

Returns a daily time series of neighborhood price data for the listing's local cluster — a
geographic group of comparable properties with the same bedroom count near the listing.

Each entry includes the median nightly price, the p25 (`low_price`) and p75 (`high_price`)
price percentiles, and the number of listings in the cluster for that stay date. All prices
are in the market's native currency, reported in the `currency` field.

Prices include the fees guests pay on top of the nightly rate. To compare a listing's nightly
rate with them, multiply it by the `fee_multiplier` from
`GET /listings/{listing_id}/fee_impact_calendar` first.

This is the same neighborhood data shown in the Wheelhouse pricing chart.

## Request

`GET https://api.usewheelhouse.com/ss_api/v1/listings/{listing_id}/neighborhood/pricing`

Authentication: send your RM API key in the `X-Integration-Api-Key` header (see https://docs.usewheelhouse.com/rm/authentication.md). Read-only keys can call this endpoint.

### Path parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `listing_id` | string | yes | The channel's unique listing identifier, or the Wheelhouse listing ID when `channel` is `wheelhouse`. |

### Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `channel` | string | yes | Channel name the listing is on (the `channel` field of the [/listings](https://docs.usewheelhouse.com/rm/reference/rm-get-listings.md) response), or the literal `wheelhouse` to read `listing_id` as a Wheelhouse listing ID instead. See [Identifying Listings](https://docs.usewheelhouse.com/rm/concepts/listings.md). |

### Example request

```bash
curl -X GET 'https://api.usewheelhouse.com/ss_api/v1/listings/{listing_id}/neighborhood/pricing?channel=<channel>' \
  -H 'X-Integration-Api-Key: <your RM API key>'
```

Only required parameters and body fields are filled in, with placeholder values. Add the optional ones you need from the lists above; some are required in combination, as their descriptions say.

## Responses

### 200

Neighborhood price data.

Body (`application/json`): object `neighborhood_pricing_response`

Daily neighborhood price percentiles.

- `data` (array of object `neighborhood_pricing_day`, required): Daily neighborhood price entries ordered by stay date.
  - `stay_date` (string (date), required): The stay date (YYYY-MM-DD).
  - `median_price` (number, required): Median nightly price (p50) across listings in the neighborhood cluster.
  - `low_price` (number, required): Lower-quartile nightly price (p25) across listings in the neighborhood cluster.
  - `high_price` (number, required): Upper-quartile nightly price (p75) across listings in the neighborhood cluster.
  - `listings_count` (integer, required): Number of listings contributing to the neighborhood data for this date.
- `currency` (string, required): ISO-4217 currency code that all price fields are expressed in (the listing's market currency).

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "data": [
    {
      "stay_date": "2026-01-01",
      "median_price": 0,
      "low_price": 0,
      "high_price": 0,
      "listings_count": 0
    }
  ],
  "currency": "string"
}
```

### 401

API key authorization failed.

### 403

Listing authorization failed.

### 404

Listing not found, or no neighborhood cluster found for this listing's location.

### 406

The listing is inactive. See the **Inactive Listings** section in the overview.

Body (`application/json`): object

- `error` (string, example: `Listing '12345' is inactive`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "Listing '12345' is inactive"
}
```

### 422

Listing is not covered by a Wheelhouse market, or has no location data.

### 429

Rate limit exceeded — the API key has sent too many requests. Wait before retrying. See the **Rate Limits** section in the overview for the recommended exponential backoff strategy.

Body (`application/json`): object

- `error` (string, example: `API token is at rate limit`)

Example shape (generated from the schema; placeholder values, not a real response):

```json
{
  "error": "API token is at rate limit"
}
```
