get_sold_summary

com.marketcheck/api · Verify this server

Get comprehensive sold vehicle summary with advanced filtering, ranking, and grouping capabilities for US market only. This provides historical sales data (up to 5 years) for sold vehicles in the United States. Time period: - date_from: Start date for summary period, should be in YYYY-MM-DD format and first day of the month - date_to: End date for summary period, should be in YYYY-MM-DD format and last day of the month Basic filters: - inventory_type: Filter by inventory type (New, Used), defaults to New - dealer_type: Filter by dealer type (Franchise, Independent) - state: Filter by US state, should be a valid 2-letter state code (e.g., CA, TX, NY, etc.) Vehicle filters: - make: Filter by car make (e.g., Toyota, Ford, etc.) - model: Filter by car model (e.g., F-150, Corolla, etc.) - body_type: Filter by car body type (e.g., SUV, Sedan, Pickup, Hatchback, etc.) - fuel_type_category: Filter by fuel type category (ICE, EV, Hybrid, Unknown, Other) Dealership filters: - dealership_group_name: Filter by dealership group name (e.g., Lithia Motors Inc., etc.) Ranking and grouping: - top_n: Limit the number of results returned per group, must be greater than or equal to 1 - ranking_dimensions: Group results by summary for selected fields (comma separated). VALID VALUES ONLY: 'make', 'model', 'body_type', 'dealership_group_name' - ranking_measure: Measure to rank by (sold_count, average_sale_price, total_sale_price, average_days_on_market) - ranking_order: Order of ranking (asc, desc), defaults to desc - summary_by: Group results by state or city_state Pagination: - limit: Maximum number of results to return, must be greater than or equal to 1, Max is 5000 Advanced filters (use operators like >, <, >=, <=, = followed by a number): - sold_count: Filter by sold count (e.g., ">100", "<=50") - average_sale_price: Filter by average sale price (e.g., ">20000", "<=15000.50") - total_sale_price: Filter by total sale price (e.g., ">500000", "<=300000.75") - average_days_on_market: Filter by average days on market (e.g., ">30", "<=60") - price_over_msrp_percentage: Filter by price over MSRP percentage (e.g., ">5", "<=0") Returns: JSON string with sold vehicle summary results including sold count, average sale price, total sale price, price range, standard deviation, price over MSRP percentage, average MSRP, average days on market, and median days on market