Private Party Listing Details

Retrieve comprehensive details about specific private party (FSBO) vehicle listings with complete vehicle specifications, media content, and marketplace data.

Retrieve detailed information about specific private party (For Sale By Owner) automotive listings using their unique listing identifier.

Base Path

GET https://api.marketcheck.com/v2/listing/car/fsbo/{listing_id}

Path Parameter:

  • listing_id - The unique identifier for the private party listing you want to retrieve. This parameter is case-sensitive and must be provided in the URL path.

The following example demonstrates how to use the Private Party Listing Details API to retrieve information about a specific FSBO listing:

request.js
import axios from 'axios';

const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/listing/car/fsbo/3GKALVEG0PL154529-a6dd2360-8210',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};

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

Request

Available parameters for retrieving detailed private party listing information:

1 Params
api_key
string required

Your MarketCheck API authentication key. Required for every request, unless OAuth is used.

Required Parameters

The following parameters are required for private party listing detail requests:

  • listing_id - The unique identifier for the FSBO listing (provided in URL path)
    • Case-sensitive string identifier returned from private party search APIs or VIN history lookups
    • Must be provided as a path parameter in the URL structure

Required Parameters

  • listing_id (path parameter) - The unique listing identifier

Response

The Private Party Listing Details API returns detailed information about the specified FSBO listing in a structured JSON format.

Schema

The response schema for Private Party Listing Details is identical to the Car Listing Details API, but focuses on private party listings. The data structure includes all the same vehicle specifications, pricing information, and media content, but with marketplace-specific seller information appropriate for FSBO listings.

Refer to the Car Listing Details API response schema for complete field definitions, data types, and detailed descriptions of all response components.

Success Response

  • 200 OK - Returns detailed JSON object with complete private party listing information
  • Includes vehicle specifications, pricing data, marketplace information, and media content
  • Provides data suitable for FSBO listing display and market analysis

Error Response

Status CodeDescriptionCommon Causes
400Bad RequestInvalid parameter values
401UnauthorizedMissing/invalid API key
403ForbiddenAccess denied to resource
422Unprocessable EntityInvalid listing_id
429Too Many RequestsRate limit exceeded
500Internal Server ErrorTemporary server issues
502Bad GatewayIssues with upstream services
503Service UnavailableAPI maintenance or downtime

Use Cases & Examples

Private Party Market Analysis

Retrieve detailed information about private party listings to analyze FSBO market trends, pricing patterns, and vehicle availability compared to dealer inventory.

Example:

Here we're retrieving complete details for a specific private party listing including specifications, pricing, and marketplace information:

request.js
import axios from 'axios';

const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/listing/car/fsbo/5XYKUDA60DG350915-b6084fe1-5314',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};

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

Post-Search FSBO Detail Retrieval

After performing searches using the Private Party Search API, use the returned listing IDs to fetch complete vehicle details for selected FSBO listings.

Example:

Here we're retrieving detailed information for a private party listing discovered through FSBO search:

request.js
import axios from 'axios';

const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/listing/car/fsbo/1FDXE4FS8KDC59231-450ae038-4d6e',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};

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

VIN History FSBO Analysis

When VIN history lookups return private party listings (seller_type=fsbo), use listing IDs to get complete details about the FSBO market activity for specific vehicles.

Example:

Here we're retrieving FSBO listing details for a vehicle identified through VIN history analysis:

request.js
import axios from 'axios';

const options = {
method: 'GET',
url: 'https://api.marketcheck.com/v2/listing/car/fsbo/1FTFW1EF5FFC00633-9ef16e97-c51f',
params: {api_key: 'YOUR_API_KEY'},
headers: {Accept: 'application/json'}
};

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

See Also