For the complete documentation index, see llms.txt. This page is also available as Markdown.

📈Analytics

The Analytics page shows trends and breakdowns across your scraped listings.

Analytics needs scraped listings. Empty charts usually mean no data in the selected time range.

Quick ways to use Analytics

  • Validate scrape coverage and cadence.

  • Spot supply by make, year, and transmission.

  • Find active price bands for your searches.

  • Compare short-term vs. long-term changes.

If charts look “wrong”, check your time range first.

Accessing Analytics

1

Open the dashboard

  • In the main app, click "📊 View Data" in the sidebar.

  • Or open http://localhost:3000 in a browser.

2

Open Analytics

  • Click "📊 Analytics" in the top navigation.

  • Charts load automatically.

Screenshot placeholder: Dashboard top navigation with Analytics highlighted. Also capture the browser URL bar showing http://localhost:3000.

Overview Statistics

The top section shows high-level metrics for the selected time range.

Total Statistics

  • Total Listings: Complete count of all scraped listings

  • Vehicles: Number of vehicle listings

  • Items: Number of general item listings

  • Average Price: Mean of listings with a numeric price

Price brackets and pricing rules are configurable. Analytics reflects your current settings.

Screenshot placeholder: Analytics header area showing:

  • Total Listings / Vehicles / Items / Average Price

  • Any visible “time range” selector (if present near the top)

Breakdown

  • Vehicle vs. Item Ratio: Percentage split

  • Price Ranges: Distribution across your configured brackets

  • Time Period: Uses the selected time range filter

Vehicle Analytics

Makes Chart

  • Shows: Most common vehicle makes, sorted by count.

  • Use it for: Supply signals and catalogue planning.

Screenshot placeholder: “Makes” chart showing the top makes list.

Example:

Years Distribution

  • Shows: Vehicle model year counts.

  • Use it for: Age mix and year-based filters.

Screenshot placeholder: “Years distribution” chart.

Transmissions

  • Shows: Transmission mix for vehicle listings.

  • Use it for: Inventory availability by transmission.

Screenshot placeholder: “Transmissions” chart (pie or breakdown).

Price Ranges

  • Shows: Listing distribution across your configured price brackets.

  • Use it for: Finding “active” price bands to target.

Screenshot placeholder: “Price ranges” chart with your current brackets visible.

Example brackets (may differ in your setup)
  • Under $5,000

  • $5,000 - $10,000

  • $10,000 - $20,000

  • $20,000 - $30,000

  • Over $30,000

Time-Based Analysis

Listings Over Time

  • Shows: Listings captured over time.

  • Use it for: Scrape cadence and market activity changes.

Screenshot placeholder: “Listings over time” line chart. Try to capture a range with at least one visible peak/valley.

Metrics Shown:

  • Listings added per day/week/month

  • Scraping frequency

  • Data growth over time

How to Use:

  • Monitor data collection progress

  • See growth trends

  • Identify inactive periods

  • Plan maintenance

Screenshot placeholder: “Activity trends” section (whatever cards/metrics appear here).

Category Breakdown

Vehicle vs. Item Ratio

  • Shows: Category split between Vehicle and Item listings.

  • Use it for: Detecting skewed catalogues and gaps.

Screenshot placeholder: Vehicle vs Item ratio chart.

Time Range Selection

Time range filters every stat and chart on the page.

Time ranges use your local machine time.

Available Ranges

7 Days:

  • Last week's data

  • Recent trends

  • Quick insights

30 Days:

  • Last month's data

  • Medium-term trends

  • Balanced view

90 Days:

  • Last quarter's data

  • Long-term trends

  • Comprehensive analysis

All Time:

  • Complete dataset

  • Full history

  • Maximum insights

Changing Time Range

1

Select Range

  • Use the dropdown at the top of the page.

  • Choose a time period.

  • The page updates automatically.

2

View Updated Data

  • All charts refresh

  • Statistics update

  • New insights appear

Screenshot placeholder: Time range dropdown open, showing options (7/30/90/All Time).

Using Analytics

Market Trends:

  • See which vehicle types are most common

  • Understand price distributions

  • Identify seasonal patterns

  • Track availability changes

Your Activity:

  • Monitor scraping frequency

  • See data growth over time

  • Identify active periods

  • Plan future sessions

Make Decisions

Search Strategy:

  • Adjust search terms based on availability

  • Focus on price ranges with good inventory

  • Target high-availability makes/models

  • Optimize scraping parameters

Deal Hunting:

  • Identify price sweet spots

  • Focus on common vehicle types

  • Understand market conditions

  • Time your searches effectively

Data Quality

Verify Scraping:

  • Check if data looks complete

  • Identify gaps in coverage

  • See if certain categories missing

  • Ensure good data collection

Screenshot placeholder: Example “empty state” (charts blank) for a narrow time range. Only add this if your UI shows a helpful message.

Tips

Last updated