Drop-in React components and hooks for the free urgentcaremap.health API β 8,500+ US urgent care clinics across 386 cities.
π Powered by urgentcaremap.health β the comprehensive US urgent care directory.
npm install urgentcaremap-react
import { UrgentCareList } from "urgentcaremap-react"; function App() { return <UrgentCareList state="massachusetts" city="boston" limit={10} />; }
That's it! The component handles loading, error, and empty states.
import { useClinics } from "urgentcaremap-react"; function ClinicFinder({ state, city }) { const { clinics, loading, error } = useClinics(state, city); if (loading) return <Spinner />; if (error) return <ErrorBanner message={error.message} />; if (!clinics?.length) return <Empty city={city} />; return ( <MyCustomList> {clinics.map((c) => ( <MyClinicCard key={c.id} clinic={c} /> ))} </MyCustomList> ); }
<UrgentCareList state="texas" city="austin" renderItem={(clinic, i) => ( <div key={clinic.id} className="my-card"> <h3>{clinic.name}</h3> <p>{clinic.address}</p> <a href={clinic.url}>View details β</a> </div> )} />
| Prop | Type | Required | Default | Description |
|---|---|---|---|---|
state |
string |
β | β | State slug (e.g., "massachusetts") |
city |
string |
β | β | City slug (e.g., "boston") |
limit |
number |
10 |
Max clinics to show | |
className |
string |
"" |
CSS class for container | |
renderItem |
(clinic, idx) => ReactNode |
β | Custom item renderer |
| Field | Type | Description |
|---|---|---|
clinics |
Clinic[] | null |
Array of clinics (null while loading) |
loading |
boolean |
True until first response |
error |
Error | null |
Network/parse errors |
Built-in client-side caching: 1 hour TTL per state/city combo.
- Patient apps β show urgent cares near user
- Telemedicine fallback β "Need in-person? Find here"
- Real estate sites β neighborhood healthcare scoring
- HR / corporate wellness β employee benefits portal
- City tourism sites β visitor health resources
Full TypeScript support out of the box. Import types:
import type { Clinic } from "urgentcaremap-react";
See it in action: urgentcaremap.health/developers/examples/
- Code: MIT
- API/Data: CC-BY-4.0 β attribution included automatically by component
@misc{urgentcaremap2026, author = {Lorynec, Oleksandr}, title = {UrgentCareMap: US Urgent Care Centers Database}, year = {2026}, publisher = {urgentcaremap.health}, url = {https://urgentcaremap.health} }
- urgentcaremap (TypeScript SDK) β
npm i urgentcaremap - urgentcaremap (Python CLI) β
pip install urgentcaremap - Open Dataset on Kaggle
Built with β€οΈ on top of urgentcaremap.health β the free directory of urgent care clinics across the USA.