AirDNA Submarket Data API

openapi: 3.2.0
info:
  description: '# Introduction

    Welcome to the **All-New** AirDNA API!


    The AirDNA API provides direct access to our industry-leading data & analytics.

    Whether you’re looking to discover a property’s earning potential, compare markets side by side, or run comps to inform

    your revenue management strategy, you can do so with the endpoints found here.


    The AirDNA API is divided into four packages, each with their own value and use cases:

    - **Market Data:** Unlock market-level data to compare entire different locations side by side, and future data to how properties

    in that market are priced for upcoming days.

    - **Property Valuations & Comps:** Conduct property-level research with advanced filtering and comp analysis

    to inform your acquisitions, benchmarking, pricing, and more.

    - **Rentalizer Lead Gen:** Determine the earning potential, occupancy, and nightly rate for any address, anywhere in the world.

    - **Smart Rates Data:** Use Smart Rates — AirDNA’s proprietary dynamic pricing solution – to receive recommended nightly rates for each of your properties.


    For more information on our API and its use cases, **Contact Sales** to get started with an API Key.


    # Authentication

    All requests to AirDNA''s APIs **require** an **Authorization HTTP header** with a Bearer token.

    - You can obtain an API Key by **contacting sales**.


    For example, if your API Key is `a1b2c3d4e5f6g7h8i9j0k1l2`, then your `Authorization` header will be:

    ```

    Authorization: "Bearer a1b2c3d4e5f6g7h8i9j0k1l2"

    ```


    ## Example: Valid Token

    The following example uses `cURL` to demonstrate how to perform a **successful** request. This assumes:

    - Your API Key has not expired.

    - Your account has been authorized to access the API Package that the endpoint belongs to.


    ### Request

    ```bash

    curl -i -X POST \

    https://api.airdna.co/api/enterprise/v2/market/search \

    -H ''Authorization: Bearer a1b2c3d4e5f6g7h8i9j0k1l2'' \

    -H ''Content-Type: application/json'' \

    -d ''{

    "search_term": "Denver",

    "pagination": {

    "page_size": 1,

    "offset": 0

    }

    }''

    ```

    ### Response `200`

    ```json

    {

    "payload": {

    "page_info": {

    "page_size": 1,

    "offset": 0

    },

    "results": [

    {

    "id": "airdna-163",

    "name": "Denver",

    "type": "market",

    "listing_count": 15231,

    "location_name": "Denver, Colorado, United States, US",

    "location": {

    "state": "Colorado",

    "country": "United States",

    "country_code": "us"

    },

    "legacy_location": {

    "city_names": [],

    "zipcodes": [],

    "neighborhoods": []

    }

    }

    ]

    },

    "status": {

    "type": "success",

    "response_id": "API-S-011",

    "message": "Successfully fetched 1 Market for the requested parameters."

    }

    }

    ```


    ## Example: Invalid Token

    The following example uses `cURL` to demonstrate what happens if you provide an **invalid** token.

    ### Request

    ```bash

    curl -i -X POST \

    https://api.airdna.co/api/enterprise/v2/market/search \

    -H ''Authorization: Bearer invalidToken'' \

    -H ''Content-Type: application/json'' \

    -d ''{

    "search_term": "Denver",

    "pagination": {

    "page_size": 1,

    "offset": 0

    }

    }''

    ```

    ### Response `401`

    ```json

    {

    "error": {

    "type": "invalid_credentials",

    "message": "Unauthorized"

    }

    }

    ```


    ## Example: Missing Token

    The following example uses `cURL` to demonstrate what happens if you omit a token.

    ### Request

    ```bash

    curl -i -X POST \

    https://api.airdna.co/api/enterprise/v2/market/search \

    -H ''Content-Type: application/json'' \

    -d ''{

    "search_term": "Denver",

    "pagination": {

    "page_size": 1,

    "offset": 0

    }

    }''

    ```

    ### Response `401`

    ```json

    {

    "error": {

    "type": "invalid_credentials",

    "message": "Authorization token is missing"

    }

    }

    ```'
  version: 2.0.0
  title: AirDNA Enterprise Submarket Data API
  contact:
    email: api@airdna.co
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
servers:
- description: AirDNA API
  url: https://api.airdna.co/api/enterprise/v2
tags:


# --- truncated at 32 KB (292 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/airdna/refs/heads/main/openapi/airdna-submarket-data-api-openapi.yml