Find car dealers around - Marketcheck APIs

The dealers API returns a list of dealers around a given point and radius.

{ "dealers": [ { "city": "string", "country": "string", "data_source": "string", "dealer_type": "string", "dealership_group_name": "string", "distance": 0, "id": "string", "inventory_url": "string", "latitude": "string", "listing_count": 0, "location_ll": "string", "longitude": "string", "seller_email": "string", "seller_name": "string", "seller_phone": "string", "state": "string", "status": "string", "street": "string", "zip": "string" } ], "num_found": 0 }

Request

Query Params

api_key

string

optional

The API Authentication Key. Mandatory with all API calls.

latitude

number

optional

Latitude component of location

longitude

number

optional

Longitude component of location

radius

integer

optional

Radius around the search location (Unit - Miles)

rows

integer

optional

Number of results to return. Default is 10. Max is 50

start

integer

optional

Page number to fetch the results for the given criteria. Default is 0. Pagination is allowed only till first 10000 results for the search and sort criteria. The page value can be only between 1 to 10000/rows

country

string

optional

To filter listing on Country in which they are listed

dealer_type

string

optional

Filter based on dealer type independant or franchise

city

string

optional

To filter listing on City in which they are listed

state

string

optional

To filter listing on State in which they are listed

listing_count_range

string

optional

To filter dealers based on their inventory size. Range can be given in the format - min-max e.g. 50-100

inventory_url

string

optional

inventory_url of dealer to be searched

zip

string

optional

To filter listing on ZIP around which they are listed

sort_by

string

optional

Sort by field. Default sort field is distance from the given point

sort_order

string

optional

Sort order - asc or desc. Default sort order is asc

provider

string

optional

boolean param to include site providers name in response

facets

string

optional

The comma separated list of fields for which facets are requested. Facets could be requested in addition to the listings for the search. Please note - The API calls with lots of facet fields may take longer to respond.

range_facets

string

optional

The comma separated list of numeric fields for which range facets are requested. Range facets could be requested in addition to the listings for the search. Please note - The API calls with lots of range facet fields may take longer to respond.

Responses

🟢200List of dealers for the search

application/json

Body

Dealers Response

dealers

array[object (Dealer) {19}]

optional

city

string

optional

City of the dealer

country

string

optional

country of the dealer

data_source

string

optional

Datasource of the dealer

dealer_type

string

optional

Type of dealer (franchise/independent)

dealership_group_name

string

optional

Dealership group name of dealer

distance

number <double>

optional

Distance of dealer from given location

string

optional

The unique id associated with the dealer in the Marketcheck database

inventory_url

string

optional

Website of the dealer

latitude

string

optional

Latutide for the dealer location

listing_count

integer

optional

Listing count of the dealer

location_ll

string

optional

location_ll for the dealer location

longitude

string

optional

Longitude for the dealer location

seller_email

string

optional

Contact email of the dealer

seller_name

string

optional

Name of the dealer

seller_phone

string

optional

Contact no of the dealer

state

string

optional

State of the dealer

status

string

optional

Status of the dealer

street

string

optional

Street of the dealer

zip

string

optional

Zip of the dealer

num_found

integer

optional

number of dealers found

🔴500Error