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