For additional support, please contact support@guidingpatients.com

Your account is not verified yet.

Please check your email and click the verification link sent from GuidingPatients. If you have further questions, please reach out to us at info@guidingpatients.com

See the full profile

Enter your email to access physician profiles, booking links, and scheduling.

v1 — Production Ready

GuidingPatients.API_

The physician intelligence API for healthcare applications. Search, match, and book across the largest unified provider dataset.

387K+ Physicians
40 Sources
50-state Coverage
< 500ms Response

Authentication

All requests require an X-API-Key header.

terminal
$ curl -H "X-API-Key: gp_live_your_key_here" \
  https://wak2mya30e.execute-api.us-east-1.amazonaws.com/v1/physicians/search?q=smith

Format: gp_live_<32 hex> — keep your key secret.

Endpoints

Physician Search

GET /v1/physicians/search Search with filters (q, specialty, state, lat/lng, insurance, aco)
GET /v1/physicians/{npi} Full detail by NPI (locations, insurance, booking)
GET /v1/physicians/autocomplete Fast typeahead (name, NPI, specialty)
GET /v1/physicians/stats Database statistics (total, NPI coverage, multi-source)

Filter Options

GET /v1/specialties All specialties for dropdown filters
GET /v1/insurance-carriers All insurance carriers
GET /v1/acos All Accountable Care Organizations

Booking & Network

POST /v1/booking/events Track a booking click-through event
POST /v1/network/match Match NPIs against your tenant network
GET /v1/network List your tenant's in-network physicians

Reports

GET /v1/reports/dashboard Dashboard metrics (bookings, top physicians, utilization)
GET /v1/reports/export/pdf Export report as PDF
GET /v1/reports/export/csv Export report as CSV

Rate Limiting

Default: 120 requests/minute per API key.

X-RateLimit-Limit

Your per-minute limit

X-RateLimit-Remaining

Requests remaining

X-RateLimit-Reset

Seconds until reset

Need higher limits? info@guidingpatients.com

Code Examples

# Search for cardiologists in New York
$ curl -H "X-API-Key: YOUR_KEY" \
  "https://wak2mya30e.execute-api.us-east-1.amazonaws.com/v1/physicians/search?specialty=Cardiology&state=NY"

# Get physician detail by NPI
$ curl -H "X-API-Key: YOUR_KEY" \
  "https://wak2mya30e.execute-api.us-east-1.amazonaws.com/v1/physicians/1234567890"

# Geo search: within 10 miles of Manhattan
$ curl -H "X-API-Key: YOUR_KEY" \
  "https://wak2mya30e.execute-api.us-east-1.amazonaws.com/v1/physicians/search?lat=40.7128&lng=-74.0060&radius=10"
import requests

API_KEY = "gp_live_your_key_here"
BASE = "https://wak2mya30e.execute-api.us-east-1.amazonaws.com"

response = requests.get(
    f"{BASE}/v1/physicians/search",
    headers={"X-API-Key": API_KEY},
    params={"q": "smith", "specialty": "Cardiology", "state": "NY"},
)
data = response.json()
for doc in data["results"]:
    print(f"{doc['name']}{doc['specialty']} — NPI: {doc['npi']}")
const API_KEY = "gp_live_your_key_here";
const BASE = "https://wak2mya30e.execute-api.us-east-1.amazonaws.com";

const res = await fetch(
  `${BASE}/v1/physicians/search?q=smith&state=NY`,
  { headers: { "X-API-Key": API_KEY } }
);
const { results, total } = await res.json();
console.log(`Found ${total} physicians`);
results.forEach(doc =>
  console.log(`${doc.name}${doc.specialty}`)
);

Get your API key in 30 seconds

Free sandbox key with full read access and default rate limits.