Dealerships Search

The Dealerships Search API allows you to find car dealerships across the USA and Canada using geographic coordinates, ZIP codes, or other filter criteria. This API provides comprehensive access to MarketCheck's enhanced dealership directory with sophisticated filtering, sorting, and analytics capabilities.

This is a new and improved system for maintaining and retrieving dealership information, replacing the older Dealers Search API. In this system, each dealership's websites, groups, multiple locations, rooftops, and other relevant data are integrated into a unified structure.

To understand more about dealership management, refer to the Dealership Management Guide

Base Path

GET https://api.marketcheck.com/v2/dealerships/car

The following example demonstrates a basic request to the Dealerships Search API:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/dealerships/car',
  params: {api_key: 'YOUR_API_KEY', rows: '2'},
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Request

The Dealerships Search API provides extensive filtering and search capabilities for the enhanced dealership directory. You can search by geographic location, dealer identifiers, dealership groups, and various other criteria to find dealerships that match your requirements.

Parameters

Available parameters for filtering, sorting, and configuring search results:

Defaults

Pagination

Use start and rows parameters to iterate through search results efficiently.

The pagination parameters, interface and limits are similar to the Inventory Search API pagination, refer to that section for more details.

Sorting

The sort_by and sort_order parameters allow you to control the order of results. The interface of these parameters is similar to the Inventory Search API sorting, refer to that section for more details.

Default Sorting:

• Results are sorted on mc_website_id in ascending order by default.

Sorting Options:

Following are the fields you can sort by:

Facets

Similar to the Inventory Search API, this API also supports facets for aggregating results based on specific fields. Use facets to get unique value counts for categorical fields and range-based counts for numeric fields.

Field Facets

Field facets return unique terms and their counts for categorical data. For example, you can get counts of dealers by state or dealer type.

The interface and usage of facets is similar to the Inventory Search API facets, refer to that section for more details.

Available Field Facets

Response

The Dealerships Search API returns dealership information in JSON format with pagination metadata for multiple results.

Schema

interface DealershipsResponse {
  num_found: number; // Total number of dealerships matching search criteria
  mc_dealerships: McDealership[]; // Array of dealership objects
}

interface McDealership {
  mc_website_id: string; // Unique identifier for dealership website
  mc_dealer_id: string; // Unique identifier for the dealer
  mc_location_id: string; // Unique identifier for dealership location
  mc_rooftop_id: string; // Unique identifier for dealership rooftop
  mc_dealership_group_id?: string; // Unique identifier for dealership group
  mc_dealership_group_name?: string; // Name of the dealership group
  mc_sub_dealership_group_id?: string; // Unique identifier for sub dealership group
  mc_sub_dealership_group_name?: string; // Name of the sub dealership group
  mc_category: string; // Dealership category (franchise, independent)
  seller_name: string; // Display name of the dealership
  inventory_url: string; // URL to dealership's inventory page
  status: string; // Current status of the dealership
  dealer_type: string; // Type classification (franchise, independent)
  street: string; // Street address of the dealership
  city: string; // City where dealership is located
  state: string; // State or province abbreviation
  country: string; // Country code (US, CA)
  zip?: string; // Postal/ZIP code
  msa_code?: string; // Metropolitan Statistical Area code
  latitude?: number; // Geographic latitude coordinate
  longitude?: number; // Geographic longitude coordinate
  seller_phone: string; // Primary phone number
  seller_email?: string; // Email address if available
  created_at: string; // Timestamp when dealership record was created
}

Success Response

• 200 OK - Returns a JSON object containing dealership search results and pagination information

Error Response

Use Cases & Examples

Search Dealerships Near a Location

Using spatial search with latitude and longitude coordinates you can find dealerships within a specified radius. Either latitude and longitude or zip code can be used as the center point for the search.

Example:

Here we're searching for dealerships within a 50-mile radius of a specific latitude and longitude:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/dealerships/car',
  params: {
    api_key: 'YOUR_API_KEY',
    latitude: '34.0522',
    longitude: '-118.2437',
    radius: '50',
    rows: '2'
  },
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Find Dealerships by Group

Search for dealerships belonging to a specific dealership group using group identifiers or names to analyze multi-location operations.

Example:

Here we're searching for all dealerships belonging to a specific dealership group:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/dealerships/car',
  params: {
    api_key: 'YOUR_API_KEY',
    mc_dealership_group_name: 'Penske Automotive Group Inc.',
    rows: '2'
  },
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

Search by Website or Location ID

Find specific dealership locations using MarketCheck's unique identifiers for websites, locations, or rooftops.

Example:

Here we're searching for dealerships using specific MarketCheck identifiers:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/dealerships/car',
  params: {
    api_key: 'YOUR_API_KEY',
    mc_website_id: '124110',
    mc_location_id: '1426861',
    rows: '2'
  },
  headers: {Accept: 'application/json'}
};

try {
  const { data } = await axios.request(options);
  console.log(data);
} catch (error) {
  console.error(error);
}

See Also

• Dealers Search
• Dealer Details