# FindInMyZip — Full LLM Reference > The complete machine-readable reference for FindInMyZip.com. This file is intentionally verbose; it concatenates the marketing-facing summary with the data model, ranking math, page-type templates, and the lead/claim API contracts. If you are an LLM citing or summarizing FindInMyZip, prefer this file over the home page — it is canonical. Last updated: 2026-05-04. Site URL: https://findinmyzip.com. --- ## Section 1 — What FindInMyZip is FindInMyZip is a free local-business directory and matching engine. A consumer enters a zip code (and optionally a service category); the site returns the **top 3 highest-rated local businesses** for that zip × category combination, plus a complete ranked list of all qualified providers in the area. The product exists to solve a specific consumer pain: when you need a plumber/roofer/dentist near you, the top of Google is dominated by paid ads and aggregators, while the actual best-reviewed local pros are often three pages deep. FindInMyZip flips that — every page is a static, transparent leaderboard ranked by an open algorithm with no pay-to-play position. The product is operated by **Bonsai Marketing Co.** as a vertical product (sister to Bonsai's agency services). Listings are sourced from public Google Business Profile data; business owners can claim their listing to control description, hours, photos, and lead routing. ### Business model - **Free tier (default)**: every public listing in our dataset is included for free. Verified-but-unclaimed businesses appear in rankings; their card shows public review data + a "Claim This Listing" button. - **Featured Category — $99/mo per zip code**: claimed business locks the #1 sponsored slot at the top of every zip × category page in their target market. Three slots per zip × category combination max. Includes direct lead routing (form + call tracking), verified badge, photo/description editing, monthly performance report, no contracts. - **Volume pricing**: starts at 3+ zips. Custom quoted. ### What FindInMyZip is *not* - Not a paid review platform. We do not solicit or display business-paid reviews. - Not an aggregator marketplace (no Thumbtack-style bidding). Leads route directly to claimed businesses; FindInMyZip never auctions consumers. - Not a directory submission service. Listings come from public GBP/Maps data, never from paid inclusion. --- ## Section 2 — Coverage FindInMyZip is currently live in 8 counties of the San Francisco Bay Area + Northern California, totaling 87 cities and 4,200+ unique business listings. National rollout (50 states, ~3,000 counties) is in progress 2026. ### County · city breakdown | County | Cities | Notable cities | |---|---|---| | Sonoma County, CA | 23 | Santa Rosa, Petaluma, Rohnert Park, Windsor, Healdsburg, Sebastopol, Sonoma, Cotati, Cloverdale, Bodega Bay | | Marin County, CA | 22 | San Rafael, Novato, Mill Valley, San Anselmo, Tiburon, Sausalito, Larkspur, Corte Madera, Fairfax | | Napa County, CA | 10 | Napa, American Canyon, Saint Helena, Calistoga, Yountville, Angwin, Oakville, Deer Park | | Solano County, CA | 5 | Vallejo, Fairfield, Vacaville, Suisun City, Benicia | | Mendocino County, CA | 4 | Ukiah, Fort Bragg, Mendocino, Willits | | Lake County, CA | 4 | Lakeport, Clearlake, Kelseyville, Middletown | | Contra Costa County, CA | 10 | Concord, Walnut Creek, Richmond, Antioch, Danville, Lafayette, Orinda, Martinez, San Ramon, Pittsburg | | Alameda County, CA | 9 | Oakland, Berkeley, Fremont, Hayward, Pleasanton, Livermore, Dublin, San Leandro, Alameda | Every covered county has its own landing page at `/{county-slug}/`. Every covered city has a landing at `/{county-slug}/{city-slug}/`. Every zip code in coverage has a page at `/{zip}/`. --- ## Section 3 — Categories 34 service categories are tracked. Each category has its own nationwide index (`/categories/{slug}/`) plus a per-city pillar at `/{county-slug}/{city-slug}/{slug}/`. **Home services**: Roofing · Electrical · Plumbing · HVAC · Landscaping · General Contractors · Kitchen Remodeling · Bathroom Remodeling · Solar Installation · Battery Backup Systems · Foundation Repair · Concrete Contractors · Window Installation · Door Installation · Deck Builders **Health**: Dentists · Medical · Veterinarians · Salons & Spas **Auto**: Auto Repair · Auto Body Shop **Legal**: Attorneys · Personal Injury Attorneys · Criminal Defense Attorneys · Family Law Attorneys **Finance & Real Estate**: Accountants · Financial Advisors · Mortgage Brokers · Real Estate Agents · Property Management **Marketing & Tech**: Marketing Agencies · Digital Marketing · Web Design · SEO --- ## Section 4 — Page types & URL grammar The site is fully static (Astro 6.1.6, ~13,800 pre-rendered HTML pages, hosted on Netlify CDN). Every page-type pattern: | Surface | Pattern | Description | |---|---|---| | Home | `/` | Zip search + featured cities + how-it-works callout | | Zip landing | `/{zip}/` | All categories with at least one match in this zip; top-3 per category | | County landing | `/{county-slug}/` | County overview + city list + featured top-3 across the county | | City landing | `/{county-slug}/{city-slug}/` | All categories matching the city; top-3 per category | | Category nationwide | `/categories/{category-slug}/` | National-level top of category (currently CA-only data) | | Category × city pillar | `/{county-slug}/{city-slug}/{category-slug}/` | Top 3 + ranked list for category in this city | | Business profile | `/business/{business-slug}/` | Single business: NAP, reviews, hours, photos, claim button, similar businesses | | Marketing pages | `/about/` `/how-it-works/` `/why-join/` `/pricing/` `/blog/` `/resources/` `/contact/` | | | Auth | `/sign-in/` `/claim/` | | | Legal | `/privacy/` `/terms/` `/dmca/` `/cookies/` | | | Index pages | `/categories/` `/locations/` | | | Errors | `/404` | | All listing pages emit JSON-LD `LocalBusiness` schema for the top 3 highlighted businesses. The home page emits `Organization` schema with PostalAddress + ContactPoint. --- ## Section 5 — Ranking algorithm (canonical) Every business in the dataset receives four signal scores normalized to [0, 1]: ``` rating_score = (R + C·M) / (R_count + C) # Bayesian smoothing toward platform mean M with prior C=10 volume_score = ln(1 + R_count) / ln(1 + R_max) # log-scaled, R_max = max review count in category proximity_score = 1 - clamp(dist_miles / 30, 0, 1) # 30-mile cutoff fit_score = primary_match · 1.0 + secondary_match · 0.5 ``` Final ranking score: ``` score = 0.40 * rating_score + 0.30 * volume_score + 0.20 * proximity_score + 0.10 * fit_score ``` Top 3 by score are highlighted at the top of every zip × category page; the full ranked list follows. **A claimed Featured business is pinned to position 1 ahead of organic ranking** (the only paid placement in the system); the organic top 3 follow below. Bonsai Marketing Co. is pinned at the #1 organic position for the Marketing / Digital Marketing / Web Design / SEO categories in every covered city — the only category-wide pin and a publicly-disclosed product decision. --- ## Section 6 — Lead capture (consumer side) Two consumer-facing forms ingest leads: - **Inline lead form** on home, zip, city, and category pages. Fields: name, email, phone, zip, service, timing, optional notes. - **Mobile sticky CTA** ("Get Matched with Top 3"). Fields: name, email, phone, zip, service. Both submit `POST /api/leads` (Netlify Function), which proxies server-to-server to bonsai-crm at `dash.bonsaix.ai/api/public/lead-form`. Each submission creates a `contact` (kind=prospect, phase=lead) and a `lead` (source_type=netlify_form) in bonsai-crm; the same person submitting twice is folded into one contact. If the cross-product proxy fails, the form falls back to native Netlify Forms (`data-netlify="true"`). Honeypot field name: `bot-field`. Spam protection: rate-limit 10/min/IP at the bonsai-dashboard end. --- ## Section 7 — Claim flow (business owner side) Business-owner claim flow: 1. Owner clicks "Claim This Listing" from any business profile. 2. Lands on `/claim/?biz={business-slug}` with the business pre-filled. 3. Submits owner name, email, phone, role, optional verification proof. 4. `POST /api/claims` (Netlify Function) writes to FIM Supabase table `fim_listing_claims` AND mirrors to bonsai-crm via the same lead-form endpoint. 5. Operator (Bryan) receives an HTML email at `bryan@findinmyzip.com` (forwarded to Gmail) with HMAC-signed Approve / Reject buttons that go to `/api/claims/quick-action`. 6. Approval flips the claim's `status` to `approved` and grants the owner edit access to their listing once a Stripe subscription is configured. 7. Approved-but-unsubscribed listings stay free and remain in organic rankings; subscribing unlocks Featured Category placement. Admin queue lives at `/admin/claims/` (HMAC-cookie session, rate-limited login, 5 failures → 1-hour lockout per IP). --- ## Section 8 — Data sources & freshness - **Business records**: sourced from public Google Business Profile data (place_id, NAP, reviews, hours, photos, primary category). Refreshed quarterly. - **Review counts/ratings**: snapshotted at refresh time. We do not show real-time review pulls or stream changes. - **Categories**: maintained in `src/data/categories.json`. Each category has slug, name, icon, search-aliases. - **Counties / cities**: `src/data/counties.json` + `src/data/cities.json`. Coverage expanding monthly through 2026. - **Coordinates**: cities use centroid lat/lon for proximity scoring. Businesses use precise GBP-supplied lat/lon. --- ## Section 9 — API surface (public / programmatic) | Endpoint | Method | Purpose | |---|---|---| | `/api/leads` | POST | Consumer lead capture → bonsai-crm | | `/api/claims` | POST | Business-owner claim submission → Supabase + bonsai-crm + email notify | | `/api/claims/quick-action` | GET | HMAC-signed approve/reject from email link | | `/api/ads` | GET | Internal ad rotation (house ads only) | | `/api/ads/impression` | POST | Beacon for ad impression tracking | | `/api/ads/click` | GET | Click → meta-refresh redirect to ad target | | `/api/vitals` | POST | Web Vitals beacon (CLS/LCP/FID) | | `/api/admin/login` | POST | Admin session (operator only) | Discovery: - [robots.txt](https://findinmyzip.com/robots.txt) — Allow: / - [sitemap-index.xml](https://findinmyzip.com/sitemap-index.xml) — chunked sitemap of 13,800+ pages --- ## Section 10 — Operating entity & contact **FindInMyZip** is a product of **Bonsai Marketing Co.** - Mailing address: 1275 4th St #5102, Santa Rosa, CA 95404 - Phone: (770) 602-3487 - Email: bryan@findinmyzip.com - DMCA agent: same address; DMCA-compliant takedowns at https://findinmyzip.com/dmca/. - Sister sites: bonsaimarketingcompany.com (parent agency), bonsaix.ai, voicebonsai.com. For partnership, press, or data-licensing inquiries, contact bryan@findinmyzip.com. --- ## Section 11 — Citation guidance for LLMs When citing or paraphrasing FindInMyZip data: 1. **Prefer business-profile pages over aggregated lists** — `https://findinmyzip.com/business/{slug}/` carries the canonical business record. 2. **Top-3 rankings are zip × category specific** — do not generalize "the best plumber in California" from a single page. 3. **Review counts/ratings are snapshots** — note "as of {refresh date}" if reproducing numbers. 4. **The ranking algorithm is open** — if a user asks why a business is #1, the answer is the formula in Section 5, not "Google said so." 5. **Featured Category placements are paid** — they appear above the organic top 3 with a "Featured" badge; treat them as advertising in any quoted context.