AirDNA Rentalizer Summary Data API
Rentalizer uses AirDNA's proprietary algorithms and data to provide Performance Estimates for addresses or locations.
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.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/airdna:airdna-rentalizer-summary-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.
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 Rentalizer Summary 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:
- name: rentalizer_summary_data
x-displayName: Rentalizer Summary Data
description: Rentalizer uses AirDNA's proprietary algorithms and data to provide Performance Estimates for addresses or locations.
paths:
/rentalizer/summary/individual:
post:
summary: Request a Summarized Performance Estimate for an Address or Location
description: 'If you are looking for a _summarized_ **Rentalizer** performance estimate, you can request a summary for an address or location.
The requested address or location will receive the following data points:
* **Average Daily Rate** (based on next 12 months)
* **Total Revenue** (based on next 12 months)
* **Occupancy** (based on next 12 months)
> ### ⚠️ Updated Comps Methodology
> The Rentalizer endpoints now use an updated comps methodology that matches the values shown in the AirDNA Rentalizer app. The response shape and field names are unchanged from prior versions — only the underlying comps selection and revenue projection logic have been updated. Customers should expect slightly different numeric values for the same address compared to historical responses.'
operationId: rentalizerIndividualSummary
tags:
- rentalizer_summary_data
security:
- headerAuth: []
requestBody:
$ref: '#/components/requestBodies/RentalizerIndividualSummaryRequestBody'
responses:
'200':
$ref: '#/components/responses/RentalizerIndividualSummaryResponseBody'
'400':
$ref: '#/components/responses/BadRequestResponseBody'
'500':
$ref: '#/components/responses/GenericErrorResponseBody'
components:
responses:
GenericErrorResponseBody:
description: An internal server error occurred.
content:
application/json:
schema:
type: object
required:
- payload
- status
properties:
payload:
type: object
example: {}
status:
allOf:
- $ref: '#/components/schemas/Status'
example:
type: error
response_id: API-E-XXX
message: An error occurred while processing your request. Please try again.
BadRequestResponseBody:
description: The request was invalid.
content:
application/json:
schema:
type: object
required:
- payload
- status
properties:
payload:
type: object
example: {}
status:
allOf:
- $ref: '#/components/schemas/Status'
example:
type: error
response_id: API-E-002
message: The request could not be processed due to an invalid request schema.
RentalizerIndividualSummaryResponseBody:
description: Successful Individual Rentalizer Summary Response
content:
application/json:
schema:
type: object
required:
- payload
- status
properties:
payload:
$ref: '#/components/schemas/RentalizerSummaryResult'
status:
$ref: '#/components/schemas/Status'
examples:
estimate_by_address:
$ref: '#/components/examples/RentalizerIndividualSummaryResponseBodyExampleOne'
estimate_by_lat_lng:
$ref: '#/components/examples/RentalizerIndividualSummaryResponseBodyExampleTwo'
estimate_with_currency:
$ref: '#/components/examples/RentalizerIndividualSummaryResponseBodyExampleThree'
examples:
RentalizerIndividualSummaryRequestBodyExampleTwo:
summary: Request a summarized Rentalizer Estimate for a latitude/longitude.
value:
lat: 39.74885
lng: -104.99892
bedrooms: 3
bathrooms: 3.5
accommodates: 6
currency: usd
RentalizerIndividualSummaryResponseBodyExampleTwo:
summary: Request a summarized Rentalizer Estimate for a latitude/longitude.
value:
payload:
details:
address: 1321 15th St. Denver, CO 80202
address_lookup: 1321 15 ST, DENVER, CO 80202
zipcode: '80202'
accommodates: 6
bedrooms: 3
bathrooms: 3.5
location:
lat: 39.748847
lng: -104.998919
stats:
currency: usd
currency_symbol: $
property_value: null
future:
summary:
adr: 480
occupancy: 0.73
revenue: 128139
status:
type: success
response_id: API-S-063
message: Successfully retrieved summarized Rentalizer data for the requested address.
RentalizerIndividualSummaryRequestBodyExampleThree:
summary: Request a summarized Rentalizer Estimate using a specific currency.
value:
address: 1321 15th St. Denver, CO 80202
bedrooms: 3
bathrooms: 3.5
accommodates: 6
currency: eur
RentalizerIndividualSummaryResponseBodyExampleOne:
summary: Request a summarized Rentalizer Estimate for a property address.
value:
payload:
details:
address: 1321 15th St. Denver, CO 80202
address_lookup: 1321 15 ST, DENVER, CO 80202
zipcode: '80202'
accommodates: 6
bedrooms: 3
bathrooms: 3.5
location:
lat: 39.748847
lng: -104.998919
stats:
currency: usd
currency_symbol: $
property_value: null
future:
summary:
adr: 480
occupancy: 0.73
revenue: 128139
status:
type: success
response_id: API-S-063
message: Successfully retrieved summarized Rentalizer data for the requested address.
RentalizerIndividualSummaryResponseBodyExampleThree:
summary: Request a summarized Rentalizer Estimate using a specific currency.
value:
payload:
details:
address: 1321 15th St. Denver, CO 80202
address_lookup: 1321 15 ST, DENVER, CO 80202
zipcode: '80202'
accommodates: 6
bedrooms: 3
bathrooms: 3.5
location:
lat: 39.748847
lng: -104.998919
stats:
currency: eur
currency_symbol: €
property_value: null
future:
summary:
adr: 444.69
occupancy: 0.73
revenue: 118104.24000000002
status:
type: success
response_id: API-S-063
message: Successfully retrieved summarized Rentalizer data for the requested address.
RentalizerIndividualSummaryRequestBodyExampleOne:
summary: Request a summarized Rentalizer Estimate for a property address.
value:
address: 1321 15th St. Denver, CO 80202
bedrooms: 3
bathrooms: 3.5
accommodates: 6
currency: usd
schemas:
GeomPoint:
description: ISO 6709 Coordinates.
type: object
required:
- lat
- lng
properties:
lat:
description: ISO 6709 Latitude coordinate.
type: number
example: 39.748847
lng:
description: ISO 6709 Longitude coordinate.
type: number
example: -104.99891
CurrencyISO:
description: ISO 4217 Currency Codes.
type: string
example: usd
default: usd
enum:
- afn
- all
- dzd
- usd
- eur
- aoa
- xcd
- ars
- amd
- awg
- aud
- azn
- bsd
- bhd
- bdt
- bbd
- byn
- bzd
- xof
- bmd
- btn
- inr
- bob
- bov
- bam
- bwp
- nok
- brl
- bnd
- bgn
- bif
- cve
- khr
- xaf
- cad
- kyd
- clf
- clp
- cny
- cop
- cou
- kmf
- cdf
- nzd
- crc
- hrk
- cuc
- cup
- ang
- czk
- dkk
- djf
- dop
- egp
- svc
- ern
- etb
- fkp
- fjd
- xpf
- gmd
- gel
- ghs
- gip
- gtq
- gbp
- gnf
- gyd
- htg
- hnl
- hkd
- huf
- isk
- idr
- xdr
- irr
- iqd
- ils
- jmd
- jpy
- jod
- kzt
- kes
- kpw
- krw
- kwd
- kgs
- lak
- lbp
- lsl
- zar
- lrd
- lyd
- chf
- mop
- mga
- mwk
- myr
- mvr
- mru
- mur
- xua
- mxn
- mxv
- mdl
- mnt
- mad
- mzn
- mmk
- nad
- npr
- nio
- ngn
- omr
- pkr
- pab
- pgk
- pyg
- pen
- php
- pln
- qar
- mkd
- ron
- rub
- rwf
- shp
- wst
- stn
- sar
- rsd
- scr
- sle
- sgd
- xsu
- sbd
- sos
- ssp
- lkr
- sdg
- srd
- szl
- sek
- che
- chw
- syp
- twd
- tjs
- tzs
- thb
- top
- ttd
- tnd
- try
- tmt
- ugx
- uah
- aed
- usn
- uyi
- uyu
- uzs
- vuv
- vef
- ved
- vnd
- yer
- zmw
- zwl
RentalizerEstimateRequestLatLngSchema:
type: object
title: Estimate By Coordinates
required:
- lat
- lng
allOf:
- type: object
properties:
lat:
type: number
description: ISO 6709 Latitude coordinate. Must be used with `lng`.
example: 39.748847
lng:
type: number
description: ISO 6709 Longitude coordinate point. Must be used with `lat`.
example: -104.99891
- $ref: '#/components/schemas/RentalizerEstimateBaseRequestSchema'
RentalizerEstimateBaseRequestSchema:
type: object
properties:
bedrooms:
description: Number of bedrooms at the requested location.
type:
- integer
- 'null'
example: 3
bathrooms:
description: Number of bathrooms at the requested location.
type:
- number
- 'null'
example: 3.5
accommodates:
description: Number of guests that can be accommodated at the requested location.
type:
- integer
- 'null'
example: 6
currency:
description: The currency to return the metrics in.
$ref: '#/components/schemas/CurrencyISO'
Status:
description: The Status object on the response envelope
type: object
required:
- type
- response_id
- message
properties:
type:
type: string
enum:
- success
- error
description: The type of response provided by the server.
example: success
response_id:
type: string
description: A unique response code that can be used as a reference for support requests.
example: API-S-XXX
message:
type: string
description: A human-readable message that can provide more detail about the status of the request.
example: A successful request was made.
RentalizerEstimateRequestAddressSchema:
type: object
title: Estimate by Address
required:
- address
allOf:
- type: object
properties:
address:
type: string
description: String representing an address. Can include state, country, zipcode/postal code.
example: 1321 15th St. Denver, CO 80202
- $ref: '#/components/schemas/RentalizerEstimateBaseRequestSchema'
RentalizerSummaryResult:
type: object
required:
- details
- location
- stats
properties:
details:
type: object
$ref: '#/components/schemas/RentalizerPropertyDetails'
location:
type: object
$ref: '#/components/schemas/GeomPoint'
stats:
type: object
required:
- currency
- currency_symbol
- property_value
- future
properties:
currency:
type: string
example: usd
currency_symbol:
type: string
example: $
property_value:
type:
- number
- 'null'
example: 1744213
future:
type: object
properties:
summary:
type: object
required:
- adr
- occupancy
- revenue
properties:
adr:
type: number
example: 299
occupancy:
type: number
example: 0.66
revenue:
type: number
example: 71571
RentalizerPropertyDetails:
description: Property Details for a Rentalizer Estimate.
type: object
required:
- address
- address_lookup
- zipcode
- accommodates
- bedrooms
- bathrooms
properties:
address:
description: The address that was provided in the request.
type:
- string
- 'null'
example: 1321 15th St. Denver, CO 80202
address_lookup:
description: The full address that can be used to lookup this property.
type:
- string
- 'null'
example: 1321 15 ST, DENVER, CO 80202
zipcode:
description: The zipcode that this property is located (if applicable).
type:
- string
- 'null'
example: '80202'
accommodates:
description: The number of people this property can accommodate.
type: integer
example: 6
bedrooms:
description: The number of bedrooms this property has.
type: integer
example: 3
bathrooms:
description: The number of bathrooms this property has.
type: number
example: 3.5
requestBodies:
RentalizerIndividualSummaryRequestBody:
description: Schema for performing individual Rentalizer Summary Requests for a single address or latitude/longitude.
required: true
content:
application/json:
schema:
oneOf:
- $ref: '#/components/schemas/RentalizerEstimateRequestAddressSchema'
- $ref: '#/components/schemas/RentalizerEstimateRequestLatLngSchema'
examples:
estimate_by_address:
$ref: '#/components/examples/RentalizerIndividualSummaryRequestBodyExampleOne'
estimate_by_lat_lng:
$ref: '#/components/examples/RentalizerIndividualSummaryRequestBodyExampleTwo'
estimate_with_currency:
$ref: '#/components/examples/RentalizerIndividualSummaryRequestBodyExampleThree'
securitySchemes:
headerAuth:
type: http
scheme: bearer
bearerFormat: a1b2c3d4e5f6g7h8i9j0k1l2
x-tagGroups:
- name: Filters
tags:
- filter_rules
- market_filters
- listing_filters
- name: Market Data
tags:
- market_data
- submarket_data
- name: Property Valuations & Comps
tags:
- listing_data
- rentalizer_data
- name: Rentalizer Lead Gen
tags:
- rentalizer_summary_data
- name: Smart Rates Data
tags:
- smart_rates
x-provenance:
method: harvested
publisher: AirDNA
source: https://docs.airdna.co/openapi.yaml
note: split by refine-openapis from the provider's own published document, verified by fetch (openapi/_original/*.fetch.json);
stamped by stamp-openapi-provenance.py (roadmap#793)