Foundational Data¶
Foundational Data (buildings-scraper) is a real-estate data platform for rental-building
lead discovery, enrichment, and outreach. Given a ZIP code or city, the system discovers the
largest possible set of rental buildings and leads, enriches them with owner/manager
contacts, locator commission terms, floorplans, units, and pricing, grades each lead through
a funnel, persists everything to a Postgres warehouse, and runs a multi-channel outreach
pipeline to building managers and owners to confirm locator commission terms.
What's in this documentation¶
- Getting Started — installation, configuration, and running the pipeline locally.
- Architecture — how the pipeline, warehouse, APIs, and apps fit together.
- Data Pipeline — discovery, enrichment, and the lead funnel in detail.
- Data Model — the Postgres warehouse schema.
- APIs — the client-facing and internal Vercel APIs.
- Operations — deployment, scheduled triggers, and ops procedures.
- Apps — the iOS app, the retired Chrome extension, and the landing page.
System at a glance¶
| Component | What it is |
|---|---|
Python pipeline (src/buildings_scraper/, CLI buildings-scraper) |
The core discovery, enrichment, grading, and outreach pipeline. |
| Postgres warehouse | DigitalOcean Managed Postgres — the system of record since 2026-07-25. |
| client-api | Vercel project; public bulk-sync feed consumed by the "Relive" partner. |
| internal-api | Vercel project; internal-only backend for the ops dashboard, the outreach mail relay, and refresh-queue administration. |
| iOS app "Foundational Locator" | Swift/SwiftUI native locator workspace built on this data. |
| Chrome extension "relive-overlay" | Retired 2026-08. Overlaid Foundational Data intel onto a partner's site; no longer deployed against anything. |
Landing page (landing/) |
Next.js public marketing site. |
Deprecated
The Chrome extension and its backing extension-api/ Vercel project were retired in
August 2026. The code remains in the repository but is legacy and unwired.