DATA FEEDS
Private Party Listings Feed
DATA FEEDS
Private Party Listings Feed – Data Dictionary
| Field | Format | Length | Source | Description | Sample | Available Since |
| id | string | 36 | MC Generated | This is a GUID and unique in the feed. In History feed VIN number is prefixed | 74803a66-c3ba | Jan 17 |
| vin | string | 17 | MC Scraped | 17 char long VIN of the car | JH4DC2389RS005574 | Jan 17 |
| heading | string | 256 | MC Scraped | The car heading as listed on the inventory page of the website | Used 1994 Acura Legend L | Jan 17 |
| more_info | string | 1024 | MC Scraped | The listing details page url | https://providence.craigslist.org//cto/7621492643.html | Jan 17 |
| price | number | 12 | MC Scraped | The car price as listed on the website | 33000 | Jan 17 |
| msrp | number | 12 | MC Scraped | The car retail price as listed on the website | 33000 | Jan 17 |
| miles | number | 12 | MC Scraped | The car miles/odometer as listed on the website | 132000 | Jan 17 |
| year | number | 4 | VIN Decoder | Model Year of the car (VIN Decoded) | 2005 | Jan 17 |
| make | string | 32 | VIN Decoder | Make of the car (VIN Decoded) | Ford | Jan 17 |
| model | string | 256 | VIN Decoder | Model of the car (VIN Decoded) | Cooper | Jan 17 |
| trim | string | 256 | VIN Decoder | Trim of the car (VIN Decoded) | Chateau | Jan 17 |
| vehicle_type | string | 64 | VIN Decoder | Vehicle type of the car (VIN Decoded) | Truck | Jan 17 |
| body_type | string | 64 | VIN Decoder | Body type of the car (VIN Decoded) | Commercial Wagon | Jan 17 |
| body_subtype | string | 64 | VIN Decoder | Body subtype of the car (VIN Decoded) | Wagon | Jan 17 |
| drivetrain | string | 64 | VIN Decoder | Drivetrain of the car (VIN Decoded) | FWD | Jan 17 |
| fuel_type | string | 64 | VIN Decoder | Fuel type of the car (VIN Decoded) | Premium Unleaded | Jan 17 |
| engine | string | 64 | VIN Decoder | Engine of the car (VIN Decoded) | 5.6L V8 | Jan 17 |
| engine_block | string | 8 | VIN Decoder | Engine block of the car (VIN Decoded) | V | Jan 17 |
| engine_size | string | 16 | VIN Decoder | Engine size of the car (VIN Decoded) | 6.8 | Jan 17 |
| transmission | string | 32 | VIN Decoder | Transmission of the car (VIN Decoded) | Automatic | Jan 17 |
| doors | number | 5 | VIN Decoder | Doors of the car (VIN Decoded) | 4 | Jan 17 |
| cylinders | string | 5 | VIN Decoder | Cylinders of the car (VIN Decoded) | 3 | Jan 17 |
| city_mpg | number | 8 | VIN Decoder | City miles per gallon (VIN Decoded) | 47 | Jan 17 |
| highway_mpg | number | 8 | VIN Decoder | Highway miles per gallon (VIN Decoded) | 87 | Jan 17 |
| interior_color | string | 64 | MC Scraped | This field provides details on interior color and in some cases it provides color with some extra information like Jet Black, Perforated leather-appointed front outboard seat trim , Very Dark Atmosphere, Leather-appointed front outboard seat trim | Black | Jan 17 |
| exterior_color | string | 64 | MC Scraped | This field provides details on exterior color and in some cases it provides color with some extra information like Supersonic Red/Midnight Black Metallic Roof [extra_cost_color] , Ext. / Int. Mosaic Black Metallic / Jet Black With Red Accents | Silver | Jan 17 |
| base_exterior_color | string | 64 | MC Calculated | Basic normalised color calculated from exterior color. E.g. Metallic black exterior is saved as Black in this field. Possible values in this field are Gray, Green, Gold, Blue, Brown, Purple, Red, Black, White, Pink, Orange, Yellow, Silver and Beige | Purple | Jan 18 |
| base_interior_color | string | 64 | MC Calculated | Basic normalised color calculated from interior color. E.g. Metallic black interior is saved as Black in this field Possible values in this field are Gray, Green, Gold, Blue, Brown, Purple, Red, Black, White, Pink, Orange, Yellow, Silver and Beige | Blue | Jan 18 |
| taxonomy_vin | string | 10 | MC Calculated | This is a squish VIN obtained from 17 character VIN by selecting first 8 letters appended with 10th and 11th character | JT8BD42ST0 | Jan 17 |
| model_code | string | 24 | MC Scraped | Model code of the car listed on the website | WKJS74 | Jan 17 |
| *scraped_at | string (YYYY-MM-DDTHH:MM:SSZ) | 32 | MC Calculated | This is the time when the listing was scraped for the first time. This value is retained even if the listing has an update in the subsequent scraping cycles. The time period between scraped_at and status_date is the duration for which the source website has not done any significant (+-10%) change in either price or miles. Please use the reference links given at the bottom of this table for more information. | 2023-06-05T13:24:40Z | Jan 17 |
| *status_date | string (YYYY-MM-DDTHH:MM:SSZ) | 32 | MC Calculated | The last seen at time. Please use the reference links given at the bottom of this table for more information. | 2023-06-11T13:20:25Z | Jan 17 |
| *first_scraped_at | string (YYYY-MM-DDTHH:MM:SSZ) | 32 | MC Calculated | This time is the oldest scraped_at date for the car with respect to the MarketCheck historical database. This is a Car or VIN Level attribute and hence will only be elevated to and made available with the most recent listing of the car. For a car which was introduced in MarketCheck database for the very first time and is still active, this field has a null value. | 2023-06-05T13:24:40Z | Jan 17 |
| source | string | 256 | MC Scraped | Website domain | autotrader.com | Jan 17 |
| seller_name | string | 512 | MC Scraped | Seller Name | cargurus | Jan 17 |
| street | string | 512 | MC Scraped | Seller location fields | 4100 West Wall Street | Jan 17 |
| city | string | 128 | MC Scraped | Charleston | Jan 17 | |
| state | string | 128 | MC Scraped | MI | Jan 17 | |
| zip | string | 10 | MC Scraped | 90291 | Jan 17 | |
| latitude | decimal number | 8 | MC Calculated | 33.99432 | Jan 17 | |
| longitude | decimal number | 8 | MC Calculated | -118.46196 | Jan 17 | |
| country | string | 2 | MC Scraped | US | Jan 17 | |
| seller_type | string | 32 | MC Calculated | It takes any one of these values dealer / fsbo / auction, same as that of listing_type | fsbo | Jan 17 |
| listing_type | string | 32 | MC Calculated | It takes any one of these values dealer / fsbo / auction, same as that of seller_type | dealer | Jan 17 |
| inventory_type | string | 16 | MC Calculated | It takes any one of these values used / new | used | Jan 17 |
| seller_comments | string | variable length text | MC Scraped | Seller comments as listed on details page | lamborghini gallardo 5.0 v10 with 29k miles. 19″ Cassiopeia wheels, a transparent engine cover, | Jan 17 |
| options | string | variable length text | MC Scraped | Pipe separated list of options found on details page | Leather Seats|Navigation System|Steel Wheels | Jan 17 |
| features | string | variable length text | MC Scraped | Pipe separated list of features found on details page | ABS (4-Wheel)|AM/FM Stereo|Air Conditioning|Alarm System | Jan 17 |
| photo_links | string | variable length text | MC Scraped | Pipe separated list of photo links found on details page of the car | https://static.cargurus.com/images/forsale/2023/06/03/14/32/2018_nissan_nv_passenger-pic-2101712915064378580-1024×768.jpeg|https://static.cargurus.com/images/forsale/2023/06/03/14/32/2018_nissan_nv_passenger-pic-3640607247143611346-1024×768.jpeg | Jan 17 |
| photo_url | string | 1024 | MC Scraped | Main photo url found on details page of the car | https://static.cargurus.com/images/forsale/2023/06/03/14/32/2018_nissan_nv_passenger-pic-2101712915064378580-1024×768.jpeg | Jan 17 |
| **dom | number | 5 | MC Calculated | The total days on market of the car. The DOM of a car is a sum of all days the car is reported online by all its online sources (i.e. the combined period between scraped_at and status_date) with the overlapping periods considered only ones. Please use the reference links given at the bottom of this table for more information. | 114 | Jan 17 |
| **dom_180 | number | 5 | MC Calculated | The sum of the days on market of the Car considering only the last 6 months. Please use the reference links given at the bottom of this table for more information. | 139 | Jan 18 |
| **dom_active | number | 5 | MC Calculated | The sum of the days on market of the Car considering only the last 30 days period. Please use the reference links given at the bottom of this table for more information. | 103 | Jan 18 |
| currency_indicator | string | 32 | MC Calculated | Currency unit. It is USD for US listings and CAD for Canadian listings | USD | March 18 |
| miles_indicator | string | 32 | MC Calculated | Mileage unit. It is MILES for US listings and KILOMETERS for Canadian listings | MILES | March 18 |
| is_dealer_listing | number | 1 | MC Calculated | Boolean flag to check wheather this FSBO listing listed on any of dealer website or not | 1 | March 23 |
* References that explain various date fields:
PPT – https://storage.googleapis.com/marketcheck-sample-feeds/dates_in_mc_feed.pptx
Medium Link – https://medium.com/marketcheck-apis/marketcheck-api-listing-dates-explained-ec67477ee800
** Reference that explains DOM fields and how those are calculated:
PPT – https://storage.googleapis.com/marketcheck-sample-feeds/Days_on_Market(DOM).pptx
AUTOMOTIVE DATA
Active FSBO Data Feed
We process private listings from the largest online classified websites in real-time, collecting 70 key details per listing, including VIN, price, price history, mileage, and days on market.
While private sellers may leave out key details, Marketcheck ensures you get full VIN-level data for every listing, offering reliable and complete information to enhance your platform’s listings. Our unmatched ability to provide OEM-level build specs for private party listings ensures accurate vehicle information with just a VIN.
CONTACT US
We want to hear from you
Whether it’s questions about how we can best serve your business or if you want to learn more, get in touch! Emails are usually answered the same day they’re sent.
For client support, please visit our Support Center or contact us directly at support@marketcheck.com.
