--- title: "Explore Markets within a Country." method: POST path: "/country/{countryCode}/markets" tags: ["market_data"] --- # Explore Markets within a Country. `POST /country/{countryCode}/markets` If you're looking to explore & compare top Markets, you can do so either by general Market characteristics, or even compare them based on specific types of Listings! Each Market includes the following summary metrics (**Last 12 months**): * **Market Score** * **Occupancy** * **Revenue** * **RevPAR** Here are some _**examples**_ of the many things you can do: * Sort Markets by highest **Market Score**, **Occupancy**, **Revenue**, **Average Daily Rate** or **Review Count**. * Compare specific Markets in the same country by using the [**Market ID Filter**](/#section/Market-ID). * Find Markets that have a high [**Seasonality**](/#section/Seasonality) score (a higher score means the Market is more stable throughout the year). * Find Markets that have a high [**Regulation**](#section/Regulation) score (a higher score means it's less regulated/strict). * Find Markets that have a high [**Rental Demand**](/#section/Rental-Demand) score (a higher score means the booking demand is higher). * Use [**Listing Filters**](/#tag/listing_filters) to compare Market performance for certain types of STR Listings. ## Path parameters - `countryCode` 'ad' | 'ae' | 'af' | 'ag' | 'ai' | 'al' | 'am' | 'ao' | 'aq' | 'ar' | 'as' | 'at' | 'au' | 'aw' | 'ax' | 'az' | 'ba' | 'bb' | 'bd' | 'be' | 'bf' | 'bg' | 'bh' | 'bi' | 'bj' | 'bl' | 'bm' | 'bn' | 'bo' | 'bq' | 'br' | 'bs' | 'bt' | 'bv' | 'bw' | 'by' | 'bz' | 'ca' | 'cc' | 'cd' | 'cf' | 'cg' | 'ch' | 'ci' | 'ck' | 'cl' | 'cm' | 'cn' | 'co' | 'cr' | 'cu' | 'cv' | 'cw' | 'cx' | 'cy' | 'cz' | 'de' | 'dj' | 'dk' | 'dm' | 'do' | 'dz' | 'ec' | 'ee' | 'eg' | 'eh' | 'er' | 'es' | 'et' | 'fi' | 'fj' | 'fk' | 'fm' | 'fo' | 'fr' | 'ga' | 'gb' | 'gd' | 'ge' | 'gf' | 'gg' | 'gh' | 'gi' | 'gl' | 'gm' | 'gn' | 'gp' | 'gq' | 'gr' | 'gs' | 'gt' | 'gu' | 'gw' | 'gy' | 'hk' | 'hm' | 'hn' | 'hr' | 'ht' | 'hu' | 'id' | 'ie' | 'il' | 'im' | 'in' | 'io' | 'iq' | 'ir' | 'is' | 'it' | 'je' | 'jm' | 'jo' | 'jp' | 'ke' | 'kg' | 'kh' | 'ki' | 'km' | 'kn' | 'kp' | 'kr' | 'kw' | 'ky' | 'kz' | 'la' | 'lb' | 'lc' | 'li' | 'lk' | 'lr' | 'ls' | 'lt' | 'lu' | 'lv' | 'ly' | 'ma' | 'mc' | 'md' | 'me' | 'mf' | 'mg' | 'mh' | 'mk' | 'ml' | 'mm' | 'mn' | 'mo' | 'mp' | 'mq' | 'mr' | 'ms' | 'mt' | 'mu' | 'mv' | 'mw' | 'mx' | 'my' | 'mz' | 'na' | 'nc' | 'ne' | 'nf' | 'ng' | 'ni' | 'nl' | 'no' | 'np' | 'nr' | 'nu' | 'nz' | 'om' | 'pa' | 'pe' | 'pf' | 'pg' | 'ph' | 'pk' | 'pl' | 'pm' | 'pn' | 'pr' | 'ps' | 'pt' | 'pw' | 'py' | 'qa' | 're' | 'ro' | 'rs' | 'ru' | 'rw' | 'sa' | 'sb' | 'sc' | 'sd' | 'se' | 'sg' | 'sh' | 'si' | 'sj' | 'sk' | 'sl' | 'sm' | 'sn' | 'so' | 'sr' | 'ss' | 'st' | 'sv' | 'sx' | 'sy' | 'sz' | 'tc' | 'td' | 'tf' | 'tg' | 'th' | 'tj' | 'tk' | 'tl' | 'tm' | 'tn' | 'to' | 'tr' | 'tt' | 'tv' | 'tw' | 'tz' | 'ua' | 'ug' | 'um' | 'us' | 'uy' | 'uz' | 'va' | 'vc' | 've' | 'vg' | 'vi' | 'vn' | 'vu' | 'wf' | 'ws' | 'xk' | 'ye' | 'yt' | 'za' | 'zm' | 'zw', required — ISO Country Code in the format defined by ISO 3166-1 Alpha-2. ## Request body - CountryMarketsRequestSchema — Schema representing the base request for retrieving a list of Markets, Submarkets or Listings relative to a Country. - `pagination` PaginationRequestSchema, required — Use this object to request a specific page of data. - `offset` number, required — The number of results to skip. (e.g. for the third page where `page_size=10`, you can set `offset=20`) - `page_size` number, required — The number of results to return per page. - `bounding_box` BoundingBoxRequestSchema — Use this object to include only results found within a given geographic rectangle. The rectangle is defined by two coordinates, the North East (`ne`) and South West (`se`) corners. - `ne` GeomPoint — ISO 6709 Coordinates. - `lat` number, required — ISO 6709 Latitude coordinate. - `lng` number, required — ISO 6709 Longitude coordinate. - `sw` GeomPoint — ISO 6709 Coordinates. - `lat` number, required — ISO 6709 Latitude coordinate. - `lng` number, required — ISO 6709 Longitude coordinate. - `filters` union[] — Array of filters that can be used to refine your search results. - union - union - object — Filter the `field` by numerical data. Used for numeric comparison operations. - `field` 'accommodates', required — Field to filter on (i.e. "accommodates"). - `type` 'gt' | 'gte' | 'lt' | 'lte', required — Numeric Equality Filter type | enum | operator | description | | ---- | ------ | ----------- | | `"gt"` | `>` | Greater Than | | `"gte"` | `>=` | Greater Than or Equal | | `"lt"` | `<` | Less Than | | `"lte"` | `<=` | Less Than or Equal | - `value` number, required — Filter value. Must be a single `number`. - object — Filter the `field` by numeric data. Used for `==` operations. - `field` 'accommodates', required — Field to filter on (i.e. "accommodates"). - `type` 'select', required — Filter type (i.e. "select"). - `value` number, required — Filter value. Must be a `number`. - object — Filter the `field` by a numeric minimum and maximum range. - `field` 'accommodates', required — Field to filter on (i.e. "accommodates"). - `type` 'range', required — Filter type (i.e. "range"). - `value` number[], required — An `array` of two `number` values representing the minimum and maximum. * e.g. `[minimum, maximum]`. - union - object — Filter the `field` by numerical data. Used for numeric comparison operations. - `field` 'bathrooms', required — Field to filter on (i.e. "bathrooms"). - `type` 'gt' | 'gte' | 'lt' | 'lte', required — Numeric Equality Filter type | enum | operator | description | | ---- | ------ | ----------- | | `"gt"` | `>` | Greater Than | | `"gte"` | `>=` | Greater Than or Equal | | `"lt"` | `<` | Less Than | | `"lte"` | `<=` | Less Than or Equal | - `value` number, required — Filter value. Must be a single `number`. - object — Filter the `field` by numeric data. Used for `==` operations. - `field` 'bathrooms', required — Field to filter on (i.e. "bathrooms"). - `type` 'select', required — Filter type (i.e. "select"). - `value` number, required — Filter value. Must be a `number`. - object — Filter the `field` by a numeric minimum and maximum range. - `field` 'bathrooms', required — Field to filter on (i.e. "bathrooms"). - `type` 'range', required — Filter type (i.e. "range"). - `value` number[], required — An `array` of two `number` values representing the minimum and maximum. * e.g. `[minimum, maximum]`. - union - object — Filter the `field` by numerical data. Used for numeric comparison operations. - `field` 'bedrooms', required — Field to filter on (i.e. "bedrooms"). - `type` 'gt' | 'gte' | 'lt' | 'lte', required — Numeric Equality Filter type | enum | operator | description | | ---- | ------ | ----------- | | `"gt"` | `>` | Greater Than | | `"gte"` | `>=` | Greater Than or Equal | | `"lt"` | `<` | Less Than | | `"lte"` | `<=` | Less Than or Equal | - `value` number, required — Filter value. Must be a single `number`. - object — Filter the `field` by numeric data. Used for `==` operations. - `field` 'bedrooms', required — Field to filter on (i.e. "bedrooms"). - `type` 'select', required — Filter type (i.e. "select"). - `value` number, required — Filter value. Must be a `number`. - object — Filter the `field` by a numeric minimum and maximum range. - `field` 'bedrooms', required — Field to filter on (i.e. "bedrooms"). - `type` 'range', required — Filter type (i.e. "range"). - `value` number[], required — An `array` of two `number` values representing the minimum and maximum. * e.g. `[minimum, maximum]`. - union - object — Listing is hosted on **at least one** of the selected channels (set overlap). The Listing may also be present on channels you did not select. - `field` 'channels', required — Field to filter on (i.e. "channels"). - `type` 'jsonb_array', required — Filter type for the overlap matching mode. - `value` ChannelOption[], required — Non-empty array of channels to match. A Listing matches if it is on at least one of these. - object — Listing's channel set is a **non-empty subset** of the selected channels — it is on at least one selected channel and on none of the unselected ones. - `field` 'channels', required — Field to filter on (i.e. "channels"). - `type` 'jsonb_array_subset', required — Filter type for the non-empty-subset matching mode. - `value` ChannelOption[], required — Non-empty array of channels. A Listing matches if its channel set is a non-empty subset of this list. - object — Listing is hosted on **exactly** the selected channels — no more, no fewer (set-equality). - `field` 'channels', required — Field to filter on (i.e. "channels"). - `type` 'jsonb_array_exact', required — Filter type for the exact set-equality matching mode. - `value` ChannelOption[], required — Non-empty array of channels. A Listing matches if its channel set equals this list exactly. - union - object — Filter the `field` by numerical data. Used for numeric comparison operations. - `field` 'investability', required — Field to filter on (i.e. "investability"). - `type` 'gt' | 'gte' | 'lt' | 'lte', required — Numeric Equality Filter type | enum | operator | description | | ---- | ------ | ----------- | | `"gt"` | `>` | Greater Than | | `"gte"` | `>=` | Greater Than or Equal | | `"lt"` | `<` | Less Than | | `"lte"` | `<=` | Less Than or Equal | - `value` number, required — Filter value. Must be a single `number`. - object — Filter the `field` by numeric data. Used for `==` operations. - `field` 'investability', required — Field to filter on (i.e. "investability"). - `type` 'select', required — Filter type (i.e. "select"). - `value` number, required — Filter value. Must be a `number`. - object — Filter the `field` by a numeric minimum and maximum range. - `field` 'investability', required — Field to filter on (i.e. "investability"). - `type` 'range', required — Filter type (i.e. "range"). - `value` number[], required — An `array` of two `number` values representing the minimum and maximum. * e.g. `[minimum, maximum]`. - union - object — Filter the `field` by numerical data. Used for numeric comparison operations. - `field` 'listing_count', required — Field to filter on (i.e. "listing_count"). - `type` 'gt' | 'gte' | 'lt' | 'lte', required — Numeric Equality Filter type | enum | operator | description | | ---- | ------ | ----------- | | `"gt"` | `>` | Greater Than | | `"gte"` | `>=` | Greater Than or Equal | | `"lt"` | `<` | Less Than | | `"lte"` | `<=` | Less Than or Equal | - `value` number, required — Filter value. Must be a single `number`. - object — Filter the `field` by numeric data. Used for `==` operations. - `field` 'listing_count', required — Field to filter on (i.e. "listing_count"). - `type` 'select', required — Filter type (i.e. "select"). - `value` number, required — Filter value. Must be a `number`. - object — Filter the `field` by a numeric minimum and maximum range. - `field` 'listing_count', required — Field to filter on (i.e. "listing_count"). - `type` 'range', required — Filter type (i.e. "range"). - `value` number[], required — An `array` of two `number` values representing the minimum and maximum. * e.g. `[minimum, maximum]`. - union - object — Filter the `field` to a specific single value. Used for `==` operations. - `field` 'listing_type', required — Field to filter on (i.e. "listing_type"). - `type` 'select', required — Filter type (i.e. "select"). - `value` 'entire_place' | 'private_room' | 'shared_room', required — The room type of the Listing. - object — Filter the `field` by multiple values. Each option in the `value` array will be treated like an "IN/OR" operation. - `field` 'listing_type', required — Field to filter on (i.e. "listing_type"). - `type` 'multi_select', required — Filter type (i.e. "multi_select"). - `value` ListingType[], required — Filter value. Must be an array of values. - union - object — Filter the `field` to a specific single value. Used for `==` operations. - `field` 'market_id', required — Field to filter on (i.e. "market_id"). - `type` 'select', required — Filter type (i.e. "select"). - `value` string, required — Filter value. Must be a `number`, `string`, or `boolean`. - object — Filter the `field` by multiple values. Each option in the `value` array will be treated like an "IN/OR" operation. - `field` 'market_id', required — Field to filter on (i.e. "market_id"). - `type` 'multi_select', required — Filter type (i.e. "multi_select"). - `value` string[], required — Filter value. Must be an array of values. - union - object — Filter the `field` to a specific single value. Used for `==` operations. - `field` 'market_type', required — Field to filter on (i.e. "market_type"). - `type` 'select', required — Filter type (i.e. "select"). - `value` 'urban_metro' | 'mountains_lakes' | 'coastal' | 'suburban' | 'rural' | 'mid_size_city', required — The type of the Market/Submarket. - object — Filter the `field` by multiple values. Each option in the `value` array will be treated like an "IN/OR" operation. - `field` 'market_type', required — Field to filter on (i.e. "market_type"). - `type` 'multi_select', required — Filter type (i.e. "multi_select"). - `value` MarketType[], required — Filter value. Must be an array of values. - union - object — Filter the `field` to a specific single value. Used for `==` operations. - `field` 'price_tier', required — Field to filter on (i.e. "price_tier"). - `type` 'select', required — Filter type (i.e. "select"). - `value` 'budget' | 'economy' | 'midscale' | 'upscale' | 'luxury', required — The price category of the Listing. - object — Filter the `field` by multiple values. Each option in the `value` array will be treated like an "IN/OR" operation. - `field` 'price_tier', required — Field to filter on (i.e. "price_tier"). - `type` 'multi_select', required — Filter type (i.e. "multi_select"). - `value` PriceTier[], required — Filter value. Must be an array of values. - object — Filter the `field` by a boolean value. - `field` 'professionally_managed', required — Field to filter on (i.e. "professionally_managed"). - `type` 'select', required — Filter type (i.e. "select"). - `value` boolean, required — Filter value. Must be `true` or `false`. - union - object — Filter the `field` by numerical data. Used for numeric comparison operations. - `field` 'ratings', required — Field to filter on (i.e. "ratings"). - `type` 'gt' | 'gte' | 'lt' | 'lte', required — Numeric Equality Filter type | enum | operator | description | | ---- | ------ | ----------- | | `"gt"` | `>` | Greater Than | | `"gte"` | `>=` | Greater Than or Equal | | `"lt"` | `<` | Less Than | | `"lte"` | `<=` | Less Than or Equal | - `value` number, required — Filter value. Must be a single `number`. - object — Filter the `field` by numeric data. Used for `==` operations. - `field` 'ratings', required — Field to filter on (i.e. "ratings"). - `type` 'select', required — Filter type (i.e. "select"). - `value` number, required — Filter value. Must be a `number`. - object — Filter the `field` by a numeric minimum and maximum range. - `field` 'ratings', required — Field to filter on (i.e. "ratings"). - `type` 'range', required — Filter type (i.e. "range"). - `value` number[], required — An `array` of two `number` values representing the minimum and maximum. * e.g. `[minimum, maximum]`. - union - object — Filter the `field` to a specific single value. Used for `==` operations. - `field` 'real_estate_type', required — Field to filter on (i.e. "real_estate_type"). - `type` 'select', required — Filter type (i.e. "select"). - `value` 'apartment' | 'bed_and_breakfast' | 'house' | 'unique', required — The real estate type of the Listing. - object — Filter the `field` by multiple values. Each option in the `value` array will be treated like an "IN/OR" operation. - `field` 'real_estate_type', required — Field to filter on (i.e. "real_estate_type"). - `type` 'multi_select', required — Filter type (i.e. "multi_select"). - `value` RealEstateType[], required — Filter value. Must be an array of values. - union - object — Filter the `field` by numerical data. Used for numeric comparison operations. - `field` 'regulation', required — Field to filter on (i.e. "regulation"). - `type` 'gt' | 'gte' | 'lt' | 'lte', required — Numeric Equality Filter type | enum | operator | description | | ---- | ------ | ----------- | | `"gt"` | `>` | Greater Than | | `"gte"` | `>=` | Greater Than or Equal | | `"lt"` | `<` | Less Than | | `"lte"` | `<=` | Less Than or Equal | - `value` number, required — Filter value. Must be a single `number`. - object — Filter the `field` by numeric data. Used for `==` operations. - `field` 'regulation', required — Field to filter on (i.e. "regulation"). - `type` 'select', required — Filter type (i.e. "select"). - `value` number, required — Filter value. Must be a `number`. - object — Filter the `field` by a numeric minimum and maximum range. - `field` 'regulation', required — Field to filter on (i.e. "regulation"). - `type` 'range', required — Filter type (i.e. "range"). - `value` number[], required — An `array` of two `number` values representing the minimum and maximum. * e.g. `[minimum, maximum]`. - union - object — Filter the `field` by numerical data. Used for numeric comparison operations. - `field` 'rental_demand', required — Field to filter on (i.e. "rental_demand"). - `type` 'gt' | 'gte' | 'lt' | 'lte', required — Numeric Equality Filter type | enum | operator | description | | ---- | ------ | ----------- | | `"gt"` | `>` | Greater Than | | `"gte"` | `>=` | Greater Than or Equal | | `"lt"` | `<` | Less Than | | `"lte"` | `<=` | Less Than or Equal | - `value` number, required — Filter value. Must be a single `number`. - object — Filter the `field` by numeric data. Used for `==` operations. - `field` 'rental_demand', required — Field to filter on (i.e. "rental_demand"). - `type` 'select', required — Filter type (i.e. "select"). - `value` number, required — Filter value. Must be a `number`. - object — Filter the `field` by a numeric minimum and maximum range. - `field` 'rental_demand', required — Field to filter on (i.e. "rental_demand"). - `type` 'range', required — Filter type (i.e. "range"). - `value` number[], required — An `array` of two `number` values representing the minimum and maximum. * e.g. `[minimum, maximum]`. - union - object — Filter the `field` by numerical data. Used for numeric comparison operations. - `field` 'revenue_growth', required — Field to filter on (i.e. "revenue_growth"). - `type` 'gt' | 'gte' | 'lt' | 'lte', required — Numeric Equality Filter type | enum | operator | description | | ---- | ------ | ----------- | | `"gt"` | `>` | Greater Than | | `"gte"` | `>=` | Greater Than or Equal | | `"lt"` | `<` | Less Than | | `"lte"` | `<=` | Less Than or Equal | - `value` number, required — Filter value. Must be a single `number`. - object — Filter the `field` by numeric data. Used for `==` operations. - `field` 'revenue_growth', required — Field to filter on (i.e. "revenue_growth"). - `type` 'select', required — Filter type (i.e. "select"). - `value` number, required — Filter value. Must be a `number`. - object — Filter the `field` by a numeric minimum and maximum range. - `field` 'revenue_growth', required — Field to filter on (i.e. "revenue_growth"). - `type` 'range', required — Filter type (i.e. "range"). - `value` number[], required — An `array` of two `number` values representing the minimum and maximum. * e.g. `[minimum, maximum]`. - union - object — Filter the `field` by numerical data. Used for numeric comparison operations. - `field` 'seasonality', required — Field to filter on (i.e. "seasonality"). - `type` 'gt' | 'gte' | 'lt' | 'lte', required — Numeric Equality Filter type | enum | operator | description | | ---- | ------ | ----------- | | `"gt"` | `>` | Greater Than | | `"gte"` | `>=` | Greater Than or Equal | | `"lt"` | `<` | Less Than | | `"lte"` | `<=` | Less Than or Equal | - `value` number, required — Filter value. Must be a single `number`. - object — Filter the `field` by numeric data. Used for `==` operations. - `field` 'seasonality', required — Field to filter on (i.e. "seasonality"). - `type` 'select', required — Filter type (i.e. "select"). - `value` number, required — Filter value. Must be a `number`. - object — Filter the `field` by a numeric minimum and maximum range. - `field` 'seasonality', required — Field to filter on (i.e. "seasonality"). - `type` 'range', required — Filter type (i.e. "range"). - `value` number[], required — An `array` of two `number` values representing the minimum and maximum. * e.g. `[minimum, maximum]`. - `currency` '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' — ISO 4217 Currency Codes. - `sort_order` 'market_score' | 'revenue' | 'occupancy' | 'adr' | 'review_count' — The attribute by which the retrieved results will be sorted. * Sorted in **descending** order (Highest to Lowest). - `include_geoms` boolean — Set this to `true` if you want to include the approximate geometric boundaries for the returned data. ## Response `200` Successfully retrieved Markets within a Country. - object - `payload` CountryMarketsResponseSchema, required - `page_info` PaginationResponseSchema, required — Describes the page information for the results. - `total_count` number, required — The number of total results available. - `offset` number, required — The number of results that were skipped. - `page_size` number, required — The number of results actually returned. - `sort_order` 'market_score' | 'revenue' | 'occupancy' | 'adr' | 'review_count', required — The attribute by which the retrieved results will be sorted. * Sorted in **descending** order (Highest to Lowest). - `markets` Market[], required — A list of Markets that match the requested parameters. - `id` string, required — Unique ID to identify the Market. - `name` string, required — Name of the Market. - `market_type` 'urban_metro' | 'mountains_lakes' | 'coastal' | 'suburban' | 'rural' | 'mid_size_city', required — The type of the Market/Submarket. - `images` string[], required — List of image URLs representing the Market. - `metrics` MarketMetrics, required — Provides a high-level performance summary of the Listings within a Market/Submarket. - `market_score` number, required — Score based on how the Market/Submarket has performed across demand, revenue growth, seasonality and regulation. - `revenue` number, required — Average Revenue for a Listing within the Market/Submarket. * Calculated based on the Listings that meet the requested `filters`. * Calculated based on data from the **Last 12 Months** - `booked` number, required — Percentage representing how often the Listings in the Market/Submarket have been booked against their availability. * Expressed as a decimal value from 0.0 to 1.0. * Calculated based on the Listings that meet the requested `filters`. * Calculated based on data from the **Last 12 Months** - `daily_rate` number, required — The average daily booking rate for the Listings in the Market/Submarket. * Calculated based on the Listings that meet the requested `filters`. * Calculated based on data from the **Last 12 Months** - `revpar` number, nullable, required — The RevPAR (Revenue Per Available Rental) for the Listings in the Market/Submarket. * Calculated based on the Listings that meet the requested `filters`. * Calculated based on data from the **Last 12 Months** - `geospatial` GeoSpatial, required — The geographical location of the data. - `geom` Geom - `MultiPolygon` object — GeoJson Mulipolygon - `coordinates` array[], required - … - `geom_pt` GeomPoint — ISO 6709 Coordinates. - `lat` number, required — ISO 6709 Latitude coordinate. - `lng` number, required — ISO 6709 Longitude coordinate. - `status` Status, required — The Status object on the response envelope - `type` 'success' | 'error', required — The type of response provided by the server. - `response_id` string, required — A unique response code that can be used as a reference for support requests. - `message` string, required — A human-readable message that can provide more detail about the status of the request. ## Other responses - `400` — The request was invalid. - `404` — Failed to find data matching your request. - `500` — An internal server error occurred. --- [API](https://skmtc.net/airdna/apis/airdna-enterprise-api.md) · [All operations](https://skmtc.net/airdna/apis/airdna-enterprise-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/airdna/airdna-enterprise-api/versions/aeed3678926f/schema)