# Analytics

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

{% hint style="info" %}
Analytics needs scraped listings. Empty charts usually mean no data in the selected time range.
{% endhint %}

### 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.

{% hint style="info" %}
If charts look “wrong”, check your time range first.
{% endhint %}

## Accessing Analytics

{% stepper %}
{% step %}

### Open the dashboard

* In the main app, click **"📊 View Data"** in the sidebar.
* Or open `http://localhost:3000` in a browser.
  {% endstep %}

{% step %}

### Open Analytics

* Click **"📊 Analytics"** in the top navigation.
* Charts load automatically.
  {% endstep %}
  {% endstepper %}

{% hint style="info" %}
**Screenshot placeholder:** Dashboard top navigation with **Analytics** highlighted.\
Also capture the browser URL bar showing `http://localhost:3000`.
{% endhint %}

## 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

{% hint style="info" %}
Price brackets and pricing rules are configurable. Analytics reflects your current settings.
{% endhint %}

{% hint style="info" %}
**Screenshot placeholder:** Analytics header area showing:

* Total Listings / Vehicles / Items / Average Price
* Any visible “time range” selector (if present near the top)
  {% endhint %}

### 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.

{% hint style="info" %}
**Screenshot placeholder:** “Makes” chart showing the top makes list.
{% endhint %}

Example:

```
Honda: ████████████ 45 listings
Toyota: ████████ 32 listings
Ford: ██████ 18 listings
```

### Years Distribution

* **Shows**: Vehicle model year counts.
* **Use it for**: Age mix and year-based filters.

{% hint style="info" %}
**Screenshot placeholder:** “Years distribution” chart.
{% endhint %}

### Transmissions

* **Shows**: Transmission mix for vehicle listings.
* **Use it for**: Inventory availability by transmission.

{% hint style="info" %}
**Screenshot placeholder:** “Transmissions” chart (pie or breakdown).
{% endhint %}

### Price Ranges

* **Shows**: Listing distribution across your configured price brackets.
* **Use it for**: Finding “active” price bands to target.

{% hint style="info" %}
**Screenshot placeholder:** “Price ranges” chart with your current brackets visible.
{% endhint %}

<details>

<summary>Example brackets (may differ in your setup)</summary>

* Under $5,000
* $5,000 - $10,000
* $10,000 - $20,000
* $20,000 - $30,000
* Over $30,000

</details>

## Time-Based Analysis

### Listings Over Time

* **Shows**: Listings captured over time.
* **Use it for**: Scrape cadence and market activity changes.

{% hint style="info" %}
**Screenshot placeholder:** “Listings over time” line chart.\
Try to capture a range with at least one visible peak/valley.
{% endhint %}

### Activity Trends

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

{% hint style="info" %}
**Screenshot placeholder:** “Activity trends” section (whatever cards/metrics appear here).
{% endhint %}

## Category Breakdown

### Vehicle vs. Item Ratio

* **Shows**: Category split between Vehicle and Item listings.
* **Use it for**: Detecting skewed catalogues and gaps.

{% hint style="info" %}
**Screenshot placeholder:** Vehicle vs Item ratio chart.
{% endhint %}

## 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

{% stepper %}
{% step %}

### Select Range

* Use the dropdown at the top of the page.
* Choose a time period.
* The page updates automatically.
  {% endstep %}

{% step %}

### View Updated Data

* All charts refresh
* Statistics update
* New insights appear
  {% endstep %}
  {% endstepper %}

{% hint style="info" %}
**Screenshot placeholder:** Time range dropdown open, showing options (7/30/90/All Time).
{% endhint %}

## Using Analytics

### Identify Trends

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

{% hint style="info" %}
**Screenshot placeholder:** Example “empty state” (charts blank) for a narrow time range.\
Only add this if your UI shows a helpful message.
{% endhint %}

## Tips

{% hint style="success" %}
Scrape regularly. Diversify catalogues. Compare multiple time ranges. Act on stable patterns.
{% endhint %}

### Related pages

* [Web dashboard](/web-dashboard/web-dashboard.md)
* [Troubleshooting](/help/troubleshooting.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.hivefb.app/web-dashboard/analytics.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.