AirDNA

AirDNA Listing Data API

This section provides data for individual Short-Term Rental listings from Airbnb, Vrbo, and Booking.com. It is ideal for searching for listings within certain parameters and also fetching metrics for individual listings. ### Explore Listings Our endpoints can help you explore and evaluate listings. You can search for: * Listings within a **Country** * Listings within a **Market** * **Comps** for a Listing * **Future Pricing** for a Listing ### Historical Listing Data We provide between **12 and 60 months** of monthly historical data for individual and multiple listings including the following: * **Metrics such as date, occupancy, revenue, and ADR** * **Details such as number of bedrooms, ratings, reviews, and market** ### Recommendations: * Use [Listing Filters](/#tag/listing_filters) to narrow down your search results for listings. * To find the `market_id` for a known Market, you can use our [Market Search](/#tag/listing_data/operation/marketSearch) endpoint.

Documentation GitHub OpenAPI

Operations 10

POST /market/search Search for a Market or Submarket by Search Term or Coordinates #

POST /country/{countryCode}/listings Explore Listings within a Country #

POST /market/{marketId}/listings Explore Listings within a Market #

POST /submarket/{submarketId}/listings Explore Listings within a Submarket #

POST /listing/comps/area Explore Listings Within a Given Radius #

GET /listing/{listingId} Fetch details about a specific Listing #

POST /listing/bulk/fetch Fetch details about multiple Listings #

POST /listing/{listingId}/metrics Fetch Historical Metrics for a specific Listing #

POST /listing/{listingId}/comps Fetch Comps for a Listing #

POST /listing/{listingId}/future/pricing Fetch Future Pricing for a Listing #

Documentation

📖

Documentation

https://docs.airdna.co/

📖

APIReference

https://airdna.redoc.ly/

Specifications

⚙

OpenAPI

https://raw.githubusercontent.com/api-evangelist/airdna/refs/heads/main/openapi/airdna-listing-data-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/airdna:airdna-listing-data-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

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 Listing 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 (301 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/airdna/refs/heads/main/openapi/airdna-listing-data-api-openapi.yml