Boostt Academy · The Digital City · Chapter 01

How you find contractors,
by the work they’ve actually done near you.

This is the first chapter of The Digital City — a series that explains, in plain terms, how Boostt turns the records a city publishes every day into a real, navigable map of the people who actually work there. No ads, no self-reported listings, no sponsored pins. Just the public record, mapped.

This chapter: every time a contractor does legal construction work in a US city, a permit is filed naming the contractor and the street address of the job. Boostt reads those permits, figures out what kind of work they describe, and attaches each job to the contractor who did it. Over time, every contractor ends up with a map of their real jobs — not their registered office, not a marketing brochure, just the actual addresses where they've actually worked.

So when you search for a plumber near your home, you don't get plumbers whose office happens to be nearby. You get plumbers who have actually repaired sewers on your block, with dates and distances as proof. It's the word-of-mouth question — “who has actually worked around here?” — answered from the public record at city scale.

Sources · Public city permit records Cities · 7 US cities, updated daily Signal · Real jobs, not office addresses 4 frames
01
A city, rebuilt from its own public record.
Every US city publishes records describing work that actually happened: building permits, business licenses, property transfers, professional licenses. When you pin them on a map, the city appears — not as a directory of ads, but as a live picture of who is actually working where. Every pin is a real event at a real address, published by the city itself. Nothing is fabricated. This chapter walks you from those raw records all the way to the search that puts them to work.
A Digital City
Building permits Realtors · public registries Business listings User / curator
Key
Every pin is a real event at a real address. Nothing fabricated.
02
Who has actually worked on your block.
Every other contractor directory — Yelp, Angi, HomeAdvisor — ranks contractors by where their office is. Office addresses are usually meaningless: a home address, a PO box, an accountant's office. It tells you nothing about whether that contractor has ever worked on your street. Boostt ranks by where contractors have actually done the work, using the real permit addresses as proof. Five jobs within a mile of you beats a fancy listing every time.
You
2 mi radius
office only · no jobs
GET /api/v1/contractors/nearby
?lat=&lng=&radius=2mi
&profession_slug=plumber
PINNACLE EXTERIOR
5 jobs · nearest 0.4mi · Apr 8
LAPEYRE CONSTRUCTION
3 jobs · nearest 0.7mi · Apr 6
ATLANTIS DEVELOPMENT
2 jobs · nearest 1.1mi · Apr 2
03
Realtors, creators, contractors — all on the same map.
Boostt doesn't keep separate databases for each kind of professional. A licensed realtor, a TikTok creator, and a contractor named on a building permit all appear on the same map, in the same format. What differs is where each one came from — state registries, city permits, social platforms. The source is always visible, so you can always see why someone appears on the map.
Postgres · Server B
public.businesses
id bigint PK source_platform varchar NOT NULL external_id varchar full_name · username · bio country_code · city · state lat · lng · geo geography(Point,4326) profession_id int (legacy, realtors only) categories · external_metrics jsonb follower_count · engagement_rate
source_platform values
public record
'manual'
116,663 CA DRE realtors
permit extraction
'chicago_permits'
contractors from contact_*
permit extraction
'nyc_permits'
owner_business_name
permit extraction
'nola_permits'
contractors from permits
public profile
'tiktok'
OAuth-connected creators
public profile
'instagram'
same pattern as TikTok
Transparency Every person and business shows where they came from. The map earns its trust by showing its work.
04
What anyone can see, and what signing in unlocks.
Anyone visiting the map sees what's already public record — names, addresses, trades, ratings. Contact information (email, phone, website, social profiles) is only shown to signed-in users. This isn't a policy wrapped around the data; the database itself is set up so the public map cannot return contact columns. There is no version of the map that leaks them, because the part of the system that serves the public map doesn't have permission to read them.
What's shown
Public map
Signed-in users
Name of person or business
Shown
Shown
City, state, job location (map pin)
Shown
Shown
Profession and categories
Shown
Shown
Rating and review count
Shown
Shown
Email address
Hidden
Shown
Phone number
Hidden
Shown
Website and business URL
Hidden
Shown
Social profiles (Instagram, TikTok…)
Hidden
Shown
Public map Names, addresses, trades — things the city already published.  ·  Signed in How to actually reach someone: email, phone, website.