v1

latestOpenAPI 3.1.0Apache 2.02026-07-1336147941.0 KB
market_data

Fetch Active Listings Count for a Market.

This endpoint provides 12 to 60 months of active listings count data for a Market.

  • Supports some Listing Filters to calculate active listings count data for certain types of STR Listings within the Market.
post/market/{marketId}/metrics/active_listings_count

Path parameters

marketIdstring required

AirDNA ID for the Market. This can often be found as market_id.

Example:airdna-163

Request body

num_monthsinteger required

The number of months to request metrics for.

Example request

{
  "num_months": 12,
  "filters": [
    {
      "type": "gte",
      "field": "accommodates",
      "value": 4
    }
  ]
}

Response

Successful Market Active Listings Count Response

Example response

{
  "payload": {
    "metrics": [
      {
        "date": "2023-05",
        "listing_count": 2839
      }
    ],
    "monthly_pct_change": -4.56,
    "yearly_pct_change": 3.78
  },
  "status": {
    "type": "success",
    "response_id": "API-S-XXX",
    "message": "A successful request was made."
  }
}