Builder Statistics API

Overview

The Builder Stats API endpoint provides administrators with a comprehensive overview of scraped property data, including total counts, source breakdowns, builder distributions, and recent additions. This helps monitor scraper performance and data quality across the platform.

Accessing Builder Stats

1. Log in with an admin account
2. Navigate to /api/admin/builder-stats
3. View JSON response with statistics

What It Returns

Total Counts

• Total properties: All properties in the database
• Scraper properties: Properties added via scraper (vs. manual entry)
• Total subdivisions: All subdivisions tracked
• Total builder companies: Companies classified as builders

By Source

Properties grouped by how they were added:

• scraper: Automatically discovered properties
• manual: Manually entered properties
• null: Properties without source tracking

By Status

Properties grouped by current status (available, sold, pending, etc.)

By Builder

Top 10 builders by property count:

• Builder name: Resolved from company records
• Property count: Number of properties associated with that builder

Recent Properties

Last 10 properties added, showing:

• Address: Full street address, city, and state
• Plan name: Home plan or model
• Source: How it was added
• Status: Current property status
• Builder: Associated builder company
• Subdivision: Development or neighborhood
• Date: When the property was created

Use Cases

Monitor Scraper Performance

Check how many properties are being added via scraper vs. manual entry to ensure automated data collection is working.

Builder Coverage

See which builders have the most properties in the system and identify gaps in coverage.

Data Quality

Review recent properties to spot issues with scraper accuracy, missing data, or incorrect categorization.

Questions

Q: Who can access this endpoint? A: Only admin accounts have access to builder statistics.

Q: How often is this data updated? A: Statistics reflect real-time data from the database.

Q: What if builder names show IDs instead of names? A: This indicates the builder company record exists but may be missing a name field. Check the company record and update it.