MarketCheck Home

Dealer Directory

Full reference for the search_dealerships and search_dealers tools — find US and Canada dealerships and dealer groups by name, location or identifier, and connect them to inventory and sold-summary analysis.

Two tools search MarketCheck's dealer directory for the US and Canada. Use search_dealerships for new work — it is multi-rooftop and dealership-group aware. search_dealers is the legacy directory, kept for dealer_id-style records and the listing_count_range inventory-size filter.

search_dealerships

PropertyValue
Tool namesearch_dealerships
MarketsUS, Canada
Requiredcountry
API endpointGET /v2/dealerships/car

Key parameters

GroupParameters
Locationlatitude + longitude or zip, plus radius (miles, max 7000); city, state, msa_code
Identityinventory_url, mc_website_id, mc_dealer_id, mc_location_id, mc_rooftop_id
Groupsmc_dealership_group_id, mc_dealership_group_name, mc_sub_dealership_group_id, mc_sub_dealership_group_name
Typedealer_type, mc_category (Dealer, Retailer, Dealership Group, Aggregator, Marketing, Financing)
Outputrows (default 10, max 50), start, sort_by, sort_order, facets, range_facets

Using it with get_sold_summary

  • One dealer's sales: pass the dealership's inventory_url as source in get_sold_summary. Several rooftops: a comma-separated list of inventory_urls.
  • A dealership group's sales: pass mc_dealership_group_name as dealership_group_name.

Example

search_dealerships(
  country="us",
  city="Austin",
  state="TX",
  mc_dealership_group_name="Lithia Motors Inc."
)

search_dealers (legacy)

PropertyValue
Tool namesearch_dealers
MarketsUS, Canada
Requiredcountry
API endpointGET /v2/dealers/car

Takes the same location filters as search_dealerships, plus dealer_type, inventory_url and listing_count_range. It has no dealership-group fields.

Use Cases

  • "List Honda dealerships in Austin, TX."
  • "Which rooftops belong to Lithia Motors in California?"
  • "How many used cars did this dealer sell last month?" (search_dealerships → get_sold_summary)