DEVELOPER HUB

Free API for US Urgent Care Data

8,500+ verified clinics across 386 cities and 50 states + DC. Public REST API, open dataset (CC-BY-4.0), and SDKs for Python, JavaScript, React. No authentication. Free forever.

🚀 Quick Start 📥 Download Dataset 📋 OpenAPI Spec

8,500+

Verified Clinics

386

Cities Covered

51

States + DC

93+

Networks/Brands

🚀 Quick Start

Try the API right now — no signup needed:

curl

# Get all urgent cares in Boston, MA
curl https://urgentcaremap.health/api/v1/clinics/massachusetts/boston.json

# List all 386 cities
curl https://urgentcaremap.health/api/v1/cities.json

# Site-wide statistics
curl https://urgentcaremap.health/api/v1/stats.json

Python

import requests
r = requests.get(
  "https://urgentcaremap.health/api/v1/clinics/massachusetts/boston.json"
)
clinics = r.json()["clinics"]
print(f"Found {len(clinics)} clinics in Boston")

JavaScript / TypeScript

const res = await fetch(
  'https://urgentcaremap.health/api/v1/clinics/massachusetts/boston.json'
);
const { clinics } = await res.json();
console.log(`Found ${clinics.length} clinics`);

📍 Endpoints

Endpoint Returns
GET /api/v1/index.json API metadata + endpoint catalog
GET /api/v1/stats.json Site-wide aggregate statistics
GET /api/v1/states.json All 50 states + DC with city counts
GET /api/v1/cities.json All 386 cities with paths
GET /api/v1/cities/{state}.json Cities in a specific state
GET /api/v1/clinics/{state}/{city}.json All clinics in a city (~10-80 per city)
GET /api/v1/networks.json All 93+ networks/brands
GET /api/openapi.json OpenAPI 3.0 specification

All endpoints return JSON. CORS open to all origins. No authentication required.

📦 Open Source SDKs

Python · CLI

urgentcaremap-cli

Command-line tool to find urgent care from your terminal.

pip install urgentcaremap

TypeScript · SDK

urgentcaremap-js

Type-safe JavaScript/TypeScript client for the API.

npm install urgentcaremap

React · Component

urgentcaremap-react

Drop-in React component for urgent care finder UI.

npm install urgentcaremap-react

📊 Bulk Data Downloads

Need the entire dataset for analysis or training a model? Download as CSV, JSON, or Parquet. Hosted on Kaggle and Hugging Face.

Browse Datasets →

📜 License & Attribution

Data is licensed under CC-BY-4.0. SDK code is licensed under MIT.

You can:

  • Use the API in commercial and non-commercial projects
  • Redistribute the data with attribution
  • Modify, transform, and build upon the data
  • Train AI/ML models on the data

You must:

  • Provide attribution: "Data from urgentcaremap.health (Lorynec, 2026)"
  • Include a link to https://urgentcaremap.health
  • Indicate if changes were made

💡 Use Cases

🏥 Telemedicine Apps

Refer patients to nearest in-person urgent care when telemedicine is insufficient.

🤖 AI Healthcare Chatbots

Answer "where is urgent care nearby?" with structured, verified data.

🏘️ Real Estate / Relocation

Show "healthcare access" scores per neighborhood or ZIP.

📊 Healthcare Research

Academic studies on US urgent care access, density, and coverage.

🛡️ Insurance Comparison

Display in-network urgent care for plans on comparison sites.

🌆 City / Tourism Sites

Embed "healthcare nearby" widgets for visitors and new residents.

Building something with our data?

Open an issue on our GitHub or tag #urgentcaremap on social. We'd love to feature your project.

View on GitHub →