Public API & Integrations
Overview
The Super Portal exposes public APIs that power the Bramlett Partners website (bramlettpartners.com via Statamic), agent landing pages, lead capture forms, and third-party integrations.
Public API Endpoints
Properties API:
- Properties by agent -- returns an agent's active listings for display on the website and agent landing pages.
- Property details -- returns full property data for a given MLS ID or address.
- Property search -- supports the same filters as the portal search, exposed via API.
- Options API -- returns available filter options (property types, statuses, counties, etc.).
Forms API:
- Lead capture form submissions from the website and agent pages.
- Source tracking tags applied per entry point (BP Webform, BP One Tap, BP Property Registration, BP Miscellaneous).
Users API:
- Exposed for internal tools (MGMT Portal prototype CRM).
- Fields: first/last name, company, team, role, email, phone, headshot, start date.
- Scoped to company:
v1/companies/{company_id}/users
Agents List API:
- Optimized for performance to handle large agent rosters.
- Powers website team pages and agent directories.
Listings API (Statamic):
- Delivers property listing data to the Statamic-powered public website via public links.
Rate Limiting
All public forms are protected by Redis-backed rate limiting to prevent spam. Rate limiting is configurable per form type.
Default rules:
- Same email: max 3 submissions per form within 72 hours
- Same phone: max 3 submissions per form within 72 hours
- Same IP address: max 3 submissions per form within 72 hours
- Same message content: max 3 submissions per form within 72 hours
IP addresses are collected from the website and stored alongside form submissions.
Public Links
Multiple SP features generate public (no-login-required) URLs:
| Feature | URL Pattern | Content |
|---|---|---|
| CMA | /public/static-cma/{uuid} | Full CMA with selected properties and stats |
| Tour | /public/tour/{uuid} | Tour itinerary with property details and photos |
| Stats | /public/stats/{uuid} | Market statistics report |
| Search | /public/search/{uuid} | Saved search results |
| Agent Page | /agent/{slug} | Agent landing page with search and contact form |
Public links include:
- Agent headshot, name, phone, and email (configurable)
- Team-specific branding for teams with their own FUB instance
Form Submissions Page
Admins can view all form submissions from a dedicated page in the portal, providing visibility into lead capture activity across all public forms.
Website Integration
The Super Portal provides APIs that the Bramlett Partners website (built on Statamic) consumes:
- Property listings for website display
- Agent data and headshots for team pages
- Market data for content pages
Website performance analysis and optimization for the Statamic public site is tracked as a separate initiative. -e