Dealers Search

The Dealers Search API allows you to find heavy equipment dealers in the US based on various criteria such as geographic location, dealer type, and inventory characteristics. This API is useful for locating heavy equipment dealers near a specific area or filtering by business attributes.

Overview

• MarketCheck's dealer directories from the US are accessible
• These are the dealers whose heavy equipment inventory is monitored by MarketCheck
• Only active dealers are made available and included in the search results

Base Path

GET https://api.marketcheck.com/v2/dealers/heavy-equipment

The following example demonstrates a basic request to the Heavy Equipment Dealers Search API:

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/dealers/heavy-equipment',
  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 Dealers Search API provides extensive filtering and search capabilities for dealer directory information. You can search by geographic location, dealer type, inventory characteristics, and numerous other criteria to find dealers 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 dealer_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:

Range Facets

Range facets help create buckets for numeric fields.

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

Available Range Facets:

Response

The Heavy Equipment Dealers Search API returns dealer information in JSON format with pagination metadata for multiple results.

Schema

interface DealersResponse {
  num_found: number; // Total number of dealers matching search criteria
  dealers: Dealer[]; // Array of dealer objects
}

interface Dealer {
  id: string; // Unique dealer identifier in MarketCheck system
  seller_name: string; // Display name of the dealer
  inventory_url: string; // URL to dealer's inventory page
  data_source: string; // Source system identifier
  status: string; // Current status of the dealer (active, inactive)
  listing_count: number; // Number of heavy equipment currently listed by dealer
  dealer_type: string; // Type classification (franchise, independent)
  street: string; // Street address of the dealer
  city: string; // City where dealer is located
  state: string; // State or province abbreviation
  country: string; // Country code (US)
  zip: string; // ZIP code
  latitude: string; // Geographic latitude coordinate
  longitude: string; // Geographic longitude coordinate
  seller_phone: string; // Primary phone number
  seller_email?: string; // Email address if available
  created_at: string; // Timestamp when dealer record was created
}

Success Response

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

Error Response

Use Cases & Examples

Search Dealers Near a Location

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

Example:

Here in this example, we are searching for dealers within a 100-mile radius of a specific latitude and longitude.

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/dealers/heavy-equipment',
  params: {
    api_key: 'YOUR_API_KEY',
    latitude: '27.72844',
    longitude: '-97.414846',
    radius: '100',
    rows: 2
  },
  headers: {Accept: 'application/json'}
};

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

Find Dealers Carrying Inventory Above a Certain Count

You can filter heavy equipment dealers based on the number of listings they have using listing_count_range parameter. This is useful for finding larger dealers with more heavy equipment inventory or smaller dealers with specialized offerings.

Example:

Here we are searching for heavy equipment dealers with inventory counts between 10 and 100. Sorting based on listing count in descending order.

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/dealers/heavy-equipment',
  params: {
    api_key: 'YOUR_API_KEY',
    listing_count_range: '10-100',
    sort_by: 'listing_count',
    sort_order: 'desc',
    rows: 2
  },
  headers: {Accept: 'application/json'}
};

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

Check If a Dealer Exists Using Inventory URL

You can verify if a heavy equipment dealer exists with MarketCheck by using the inventory_url parameter. This is useful for validating dealer information or checking if a specific dealer is monitored by MarketCheck.

Example:

Here we are searching for a heavy equipment dealer by their inventory URL.

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/dealers/heavy-equipment',
  params: {api_key: 'YOUR_API_KEY', inventory_url: 'laufequipment.com'},
  headers: {Accept: 'application/json'}
};

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

Find Low Volume Independent Dealers

Using dealer_type parameter, you can filter dealers by their type, such as franchise or independent. This is useful for finding specific types of heavy equipment dealers based on your business needs.

Example:

Here we are searching for low volume independent heavy equipment dealers that carry less than 20 units in inventory.

import axios from 'axios';

const options = {
  method: 'GET',
  url: 'https://api.marketcheck.com/v2/dealers/heavy-equipment',
  params: {
    api_key: 'YOUR_API_KEY',
    dealer_type: 'independent',
    listing_count_range: '1-20',
    rows: 2
  },
  headers: {Accept: 'application/json'}
};

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

See Also

• Dealer Details
• Inventory Search