Dealerships Search

The Dealerships Search API allows you to find car dealerships across the UK using geographic coordinates, postal 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 with UK-specific features including FCA compliance status.

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

Base Path

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

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

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/dealerships/car/uk',
  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, FCA compliance status, and various other criteria to find dealerships that match your requirements.

Parameters

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

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 dealerships by county or FCA status.

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

Available Field Facets

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 postal_code can be used as the center point for the search.

Example:

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

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/dealerships/car/uk',
  params: {
    api_key: 'YOUR_API_KEY',
    latitude: '53.057886',
    longitude: '-2.463424',
    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/uk',
  params: {
    api_key: 'YOUR_API_KEY',
    mc_dealership_group_name: 'Arnold Clark Automobiles Ltd',
    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/uk',
  params: {
    api_key: 'YOUR_API_KEY',
    mc_website_id: '10038395',
    mc_location_id: '1469881',
    rows: '2'
  },
  headers: {Accept: 'application/json'}
};

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

Find Dealerships by FCA Compliance Status

Using fca_status parameter, you can filter dealerships by their Financial Conduct Authority compliance status, which is specific to UK regulatory requirements.

Example:

Here we're searching for FCA-authorized dealerships in a specific area:

import axios from 'axios';

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

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

Response

The Dealerships Search API returns dealership information in JSON format.

Success Response

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

Error Response

Response 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
  country: string; // Country code (UK)
  county?: string; // County or region if available
  zip: string; // Postal code
  postal_code: string; // Postal code
  latitude: string; // Geographic latitude coordinate
  longitude: string; // Geographic longitude coordinate
  seller_phone: string; // Primary phone number
  seller_email?: string; // Email address if available
  fca_status?: string; // FCA authorization status for UK dealerships
  fca_reference_no?: string; // FCA reference number if available
  created_at: string; // Timestamp when dealership record was created
}

See Also

• Dealers Search
• Dealer Details