Python CLI and library for the free urgentcaremap.health API — 8,500+ US urgent care clinics across 386 cities.
🌐 Built on data from urgentcaremap.health — the comprehensive US urgent care directory.
pip install urgentcaremapNo external dependencies (uses Python stdlib only).
# Find urgent cares in a city
urgentcaremap find massachusetts boston
# Find nearest 5 clinics to coordinates
urgentcaremap nearest 42.3467 -71.0972 massachusetts boston
# List all 50 states + DC with clinic counts
urgentcaremap states
# Show site-wide statistics
urgentcaremap stats
# Output as JSON for scripting
urgentcaremap find california los-angeles --json | jq '.[] | .name'from urgentcaremap_cli import UrgentCareClient
client = UrgentCareClient()
# Get all clinics in a city
clinics = client.find_clinics("massachusetts", "boston")
print(f"Found {len(clinics)} clinics in Boston")
# Find nearest clinics by coordinates
nearest = client.find_nearest(
lat=42.3467,
lon=-71.0972,
state="massachusetts",
city="boston",
limit=5,
)
for c in nearest:
print(f"{c['name']} — {c['distance_km']:.2f} km away")
# Site-wide statistics
stats = client.get_stats()
print(f"Total clinics: {stats['coverage']['total_clinics']}")
# Per-state browsing
ca_cities = client.cities_in_state("california")
networks = client.list_networks()| Method | Description |
|---|---|
client.find_clinics(state, city) |
All clinics in a city |
client.find_nearest(lat, lon, state, city, limit) |
Nearest by coordinates |
client.list_states() |
50 states + DC with counts |
client.list_cities() |
All 386 cities |
client.cities_in_state(state) |
Cities in one state |
client.list_networks() |
93+ urgent care networks |
client.get_stats() |
Site-wide statistics |
client.get_index() |
API metadata |
- Telemedicine apps — refer patients to in-person care
- Healthcare research — academic studies on access/density
- Insurance comparison — show in-network urgent care
- Real estate apps — neighborhood healthcare scoring
- Chatbots — answer "where is urgent care nearby?"
Full API documentation: urgentcaremap.health/developers/
OpenAPI 3.0 spec: urgentcaremap.health/api/openapi.json
- Code: MIT (see LICENSE)
- API/Data: CC-BY-4.0 — attribution required when republishing data
If you use this in research or publications:
@misc{urgentcaremap2026,
author = {Lorynec, Oleksandr},
title = {UrgentCareMap: US Urgent Care Centers Database},
year = {2026},
publisher = {urgentcaremap.health},
url = {https://urgentcaremap.health}
}- urgentcaremap-js — TypeScript/JavaScript SDK
- urgentcaremap-react — React component library
- Open Dataset on Kaggle — Bulk download (CSV/JSON/Parquet)
Pull requests welcome! Please open an issue first to discuss major changes.
Built with ❤️ on top of urgentcaremap.health — the free directory of urgent care clinics across the USA.