---
title: "Search for a Market or Submarket by Search Term or Coordinates."
method: POST
path: "/market/search"
tags: ["market_data", "submarket_data", "listing_data"]
---

# Search for a Market or Submarket by Search Term or Coordinates.

`POST /market/search`

If you need to find AirDNA Markets or Submarkets, this endpoint allows you to find them via a simple
`search_term` or `lat` and `lng`.

Each result will provide:
* A unique `id` that can be used in other endpoints for obtaining data.
* The **Name** of the market
* Whether it is a **Market** or **Submarket**
* Basic **Location** details

## Request body

- union
  - MarketSearchByTermRequestSchema — Request Schema for searching for Markets By Search Term.
    - `search_term` string, required — A search term to find a Market. It's recommended this be a **city**, a **state** or a **neighborhood**
    - `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.
  - MarketSearchByLatLngRequestSchema — Request Schema for searching for Markets by Latitude and Longitude.
    - `lat` number, required — ISO 6709 Latitude coordinate. Must be used with `lng`.
    - `lng` number, required — ISO 6709 Longitude coordinate point. Must be used with `lat`.
    - `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.

## Response `200`

Successful Market Search Response

- object
  - `payload` MarketSearchResponseSchema, required
    - `page_info` object, required — Describes the page information for the results.
      - `page_size` number, required — The number of results actually returned.
      - `offset` number, required — The number of results that were skipped.
    - `results` union[], required — List of Markets and/or Submarkets.
      - union
        - MarketSearchMarketResultSchema — Search result for a Market.
          - `id` integer, required — The ID of the Market.
          - `name` string, required — The Name of the Market.
          - `type` 'market', required — Identifies if the result is a Market.
          - `listing_count` integer, required — The number of Listings in the Market.
          - `location_name` string, required — A more descriptive name of the Location.
          - `location` object, required — Location information for the Market.
            - `state` string, nullable, required — The state where the Market is located.
            - `country` string, required — The country where the Market is located.
            - `country_code` string, required — The ISO code of the country where the Market is located.
          - `legacy_location` object, required — Legacy location information for the Market.
            - `city_names` string[], required — List of city names related to the Market.
            - `zipcodes` string[], required — List of zipcodes related to the Market.
            - `neighborhoods` string[], required — List of neighborhoods names related to the Market.
        - MarketSearchSubmarketResultSchema — Search result for a Submarket.
          - `id` integer, required — The ID of the Submarket.
          - `name` string, required — The Name of the Submarket.
          - `type` 'submarket', required — Identifies if the result is a Submarket.
          - `listing_count` integer, required — The number of Listings in the Submarket.
          - `location_name` string, required — A more descriptive name of the Location.
          - `location` object, required — Location information for the Submarket.
            - `state` string, nullable, required — The state where the Submarket is located.
            - `country` string, required — The country where the Submarket is located.
            - `country_code` string, required — The ISO code of the country where the Submarket is located.
          - `legacy_location` object, required — Legacy location information for the Submarket.
            - `city_names` string[], required — List of city names related to the Submarket.
            - `zipcodes` string[], required — List of zipcodes related to the Submarket.
            - `neighborhoods` string[], required — List of neighborhoods names related to the Submarket.
          - `parent_market` object, nullable, required — The information for the Market that the Submarket belongs to.
            - `id` string, required — The ID of the parent Market.
            - `name` string, required — The Name of the parent Market.
  - `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.
- `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)