B2B API
Healthcare Data API
Access 9M+ providers and real-time self-pay pricing through a single endpoint
Quick Start
2
Add Header
Include x-api-key in your requests
3
Search Providers
POST a query and location to get providers with pricing
curl -X POST "https://sytjhslzedcesudozwwm.supabase.co/functions/v1/widget-search" \
-H "x-api-key: your_key_here" \
-H "Content-Type: application/json" \
-d '{"query": "family doctor", "location": "90210"}'Endpoint
POST
https://sytjhslzedcesudozwwm.supabase.co/functions/v1/widget-searchSearch healthcare providers by query and location. Returns providers with self-pay pricing estimates.
Request Body (JSON)
| Field | Type | Required | Description |
|---|---|---|---|
query | string | Yes | Search term (e.g., "family doctor", "MRI", "dentist") |
location | string | Yes | ZIP code or city name |
api_key | string | Alt | Alternative to x-api-key header |
Example Request
POST https://sytjhslzedcesudozwwm.supabase.co/functions/v1/widget-search
Content-Type: application/json
x-api-key: your_key_here
{
"query": "family doctor",
"location": "90210"
}Example Response
{
"providers": [
{
"provider_name": "Dr. Sarah Chen",
"specialty": "Family Medicine",
"city": "Beverly Hills",
"state": "CA",
"price_low": 85,
"price_mid": 145,
"price_high": 220,
"source": "cms_transparency"
},
{
"provider_name": "Pacific Family Health",
"specialty": "Family Practice",
"city": "Los Angeles",
"state": "CA",
"price_low": 95,
"price_mid": 160,
"price_high": 250,
"source": "payer_negotiated"
}
],
"total": 47,
"radius_miles": 25
}Code Examples
curl -X POST "https://sytjhslzedcesudozwwm.supabase.co/functions/v1/widget-search" \
-H "x-api-key: your_key_here" \
-H "Content-Type: application/json" \
-d '{"query": "family doctor", "location": "90210"}'Authentication
All requests require an API key. Pass it via the x-api-key header or in the request body as api_key.
// Header (recommended)
x-api-key: fvh_live_abc123...
// Or in request body
{ "query": "dentist", "location": "10001", "api_key": "fvh_live_abc123..." }Keys are prefixed with fvh_live_ (production) or fvh_test_ (sandbox).
Rate Limits
| Tier | Requests/Day | Price |
|---|---|---|
| Free | 100 | $0 |
| Basic | 1,000 | $99/mo |
| Pro | 10,000 | $499/mo |
| Enterprise | 100,000+ | Custom |
Rate Limit Headers
Every response includes these headers to help you manage usage:
| Header | Description | Example |
|---|---|---|
X-RateLimit-Limit | Max requests per day for your tier | 1000 |
X-RateLimit-Remaining | Requests remaining in current window | 847 |
X-RateLimit-Reset | Unix timestamp when the limit resets | 1709337600 |
Example response headers:
HTTP/1.1 200 OK Content-Type: application/json X-RateLimit-Limit: 1000 X-RateLimit-Remaining: 847 X-RateLimit-Reset: 1709337600
When you exceed your limit, the API returns 429 Too Many Requests. Upgrade your tier or wait until the reset time.
API Pricing
Free
$0
100/day requests
- ✓Provider search
- ✓Price lookups
- ✓Community support
Most Popular
Basic
$99/mo
1,000/day requests
- ✓All Free features
- ✓Priority queue
- ✓Email support
- ✓Usage dashboard
Pro
$499/mo
10,000/day requests
- ✓All Basic features
- ✓Priority support
- ✓Bulk endpoints
- ✓SLA guarantee
Enterprise
Custom
100,000+/day requests
- ✓All Pro features
- ✓Dedicated support
- ✓White-label options
- ✓Custom integrations