Search Markets

Gets a list of unique identifiers (<parcl_id>) for markets that correspond to specific keywords or parameters defined by the user. The <parcl_id> is key to navigating the Parcl Labs API, serving as the core mechanism for retrieving market-level information.

Query Params
string
length between 3 and 57

User's search criteria, used to filter <parcl_id>s where the market name meets the specified search criteria

string
enum
Defaults to ALL

Specifies the type of geographic boundary used to filter search results. This field allows users to narrow down search results to specific geographic levels

string
enum
Defaults to ALL

Specifies the region of the United States used to filter search results. This field is designed to help users focus their search within specific large geographic areas, aligning with common federal statistical divisions

string
enum
Defaults to ALL

Specifies the state within the United States used to filter search results. This field is designed to help users focus their search within specific states, using standard state abbreviations

string
enum
Defaults to ALL

Specifies the state within the United States used to filter search results, using the Federal Information Processing Standards (FIPS) code for geographic identification

integer

A unique id for a given geographic market in the Parcl Labs API. Parcl_ids are unique and independent of each other, without any hierarchical structure. For example, the parcl_id for Brooklyn, NY bears no relationship to the parcl_id for the New York Metropolitan Statistical Area (MSA), even though Brooklyn is a part of the New York MSA

string
length between 5 and 7

Specifies the Geographic Identifier (GEOID) used to filter search results. GEOIDs are unique codes assigned to various geographic entities by the U.S. Census Bureau. The Parcl Labs API currently supports GEOIDs for Census zip codes, counties, places, and metros, which range from 5-7 digits in length. For more information, please visit: https://www.census.gov/programs-surveys/geography/guidance/geo-identifiers.html

string
enum
Defaults to TOTAL_POPULATION

Specifies the sorting order for <parcl_id> results. Allows users to sort markets by population size, median income, and other market types

Allowed:
string
enum
Defaults to DESC

Specifies the direction of the sorting for <parcl_id> results. For example, use sort_order desc with population_size to list more populous markets first.

Allowed:
integer
1 to 1000
Defaults to 12

Page size limit

integer
≥ 0
Defaults to 0

Page offset

Responses

Language
Credentials
Header
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json