Retrieve detailed information about specific private party (For Sale By Owner) automotive listings using their unique listing identifier.
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:
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);
}
Available parameters for retrieving detailed private party listing information:
Your MarketCheck API authentication key. Required for every request, unless OAuth is used.
The following parameters are required for private party listing detail requests:
The Private Party Listing Details API returns detailed information about the specified FSBO listing in a structured JSON format.
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.
Status Code | Description | Common Causes |
---|---|---|
400 | Bad Request | Invalid parameter values |
401 | Unauthorized | Missing/invalid API key |
403 | Forbidden | Access denied to resource |
422 | Unprocessable Entity | Invalid listing_id |
429 | Too Many Requests | Rate limit exceeded |
500 | Internal Server Error | Temporary server issues |
502 | Bad Gateway | Issues with upstream services |
503 | Service Unavailable | API maintenance or downtime |
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:
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);
}
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:
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);
}
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:
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);
}
Car Listing Details
Retrieve detailed information about specific dealer car listings with complete vehicle specifications, media content, dealer information, and marketplace data.
Auction Listing Details
Retrieve comprehensive details about specific auction vehicle listings with complete vehicle specifications, auction house information, media content, and marketplace data.