Skip to main content
POST
Competitive set (POST body)
Returns competing dealers near the dealership for a segment, with price, mileage, and days on market. Scope required: market_data:read
Plan required: Unlimited
Also available as GET /market/competitive-set.

Authorizations

X-API-Key
string
header
required

Your Hrizn API key (prefix hzk_)

Body

application/json
make
string
model
string
trim
string
year_min
integer
Required range: 1980 <= x <= 2100
year_max
integer
Required range: 1980 <= x <= 2100
car_type
enum<string>
Available options:
new,
used,
certified
zip
string
Required string length: 3 - 12
state
string
Required string length: 2
radius_miles
integer
Required range: 1 <= x <= 500
sample_size
integer
Required range: 1 <= x <= 10
price_min
integer
Required range: x >= 0
price_max
integer
Required range: x >= 0
miles_min
integer
Required range: x >= 0
miles_max
integer
Required range: x >= 0

Response

Competitive set

data
object

Live market payload (shape varies by endpoint)

Last modified on July 26, 2026