API Documentation

RESTful API for programmatic access to vehicle auction data

Base URL

https://findcars.prasanthsasikumar.com/api/v1

Authentication

Currently, the API is open and does not require authentication. Please use responsibly.

Endpoints

GET /api/v1/stats/overview

Get overview statistics from the most recent 30 days of data

Response Example:
{
  "total_listings": 45000,
  "unique_vehicles": 12000,
  "manufacturers": 500,
  "avg_price": 2500.50,
  "median_price": 1800.00,
  "top_manufacturers": {
    "Toyota": 8500,
    "Mazda": 6200
  }
}
GET /api/v1/stats/price-trends

Get historical price trends (sampled every 7 days)

Response Example:
[
  {
    "date": "2023-05-27",
    "avg_price": 2450.30,
    "median_price": 1750.00,
    "count": 550
  }
]
GET /api/v1/manufacturers

Get statistics by manufacturer from recent 30 days

Response Example:
[
  {
    "manufacturer": "Toyota",
    "avg_price": 3200.50,
    "median_price": 2800.00,
    "count": 8500,
    "unique_models": 45
  }
]
GET /api/v1/damage-analysis

Get frequency analysis of damage types

Response Example:
{
  "Front Damage": 12500,
  "Rear Damage": 10200,
  "Airbags Deployed": 3800
}
GET /api/v1/search

Search and filter vehicle listings

Parameters:
  • manufacturer - Filter by manufacturer (partial match)
  • model - Filter by model (partial match)
  • max_price - Maximum price
  • min_price - Minimum price
Example Request:
GET /api/v1/search?manufacturer=Toyota&max_price=5000
Response Example:
{
  "count": 150,
  "results": [
    {
      "Manufacturer": "Toyota",
      "Model": "Corolla",
      "Price": "$2,500"
    }
  ]
}
GET /api/v1/download/latest

Download the latest raw CSV file

GET /api/v1/download/processed

Download cleaned/processed dataset (460K+ records)

Code Examples

Python
import requests

# Get overview stats
response = requests.get('https://findcars.prasanthsasikumar.com/api/v1/stats/overview')
data = response.json()
print(f"Average price: ${data['avg_price']}")

# Search for vehicles
params = {'manufacturer': 'Toyota', 'max_price': 5000}
response = requests.get('https://findcars.prasanthsasikumar.com/api/v1/search', params=params)
vehicles = response.json()['results']
JavaScript
// Fetch overview stats
fetch('https://findcars.prasanthsasikumar.com/api/v1/stats/overview')
  .then(response => response.json())
  .then(data => {
    console.log(`Average price: $${data.avg_price}`);
  });

// Search with filters  
const params = new URLSearchParams({
  manufacturer: 'Toyota',
  max_price: 5000
});

fetch(`https://findcars.prasanthsasikumar.com/api/v1/search?${params}`)
  .then(response => response.json())
  .then(data => console.log(data.results));

Rate Limits

Please be considerate with API usage. Recommended limits:

For higher limits, please contact us.