Logo
Iniciar sesiónComenzar
Hospitals API
DatosMANTENIDA1 token / llamada

Hospitals API

5.419 hospitales de EE. UU. certificados por Medicare con calificaciones de estrellas de CMS, urgencias y coordenadas

Directorio de hospitales de EE. UU. con más de 5.400 hospitales certificados por Medicare, construido a partir de datos oficiales de CMS Hospital Compare y enriquecido con atributos geográficos y de infraestructura: nombre, dirección completa, condado, teléfono, tipo de hospital (cuidados agudos, acceso crítico, psiquiátrico, infantil...), propiedad, indicadores de servicios de urgencias y de atención al parto, calificación general de estrellas de CMS (1-5) con resúmenes de los grupos de medidas de mortalidad, seguridad, reingresos, experiencia del paciente y puntualidad — además de coordenadas, número de camas, nivel de centro de trauma, helipuerto y sitio web para el ~86% de hospitales georreferenciados con la capa de infraestructura HIFLD del DHS. Busca por nombre o ciudad; filtra por estado, ciudad, código postal, condado, tipo, propiedad, urgencias, calificación mínima o centros de trauma; encuentra hospitales cerca de cualquier coordenada ordenados por distancia; agrega estados (con calificación promedio) y tipos. Conjunto de datos autoalojado actualizado a diario desde CMS — sin llamadas a terceros al momento de la consulta.

Cada llamada necesita la cabecera X-Api-Key. Una clave gratuita incluye 500 tokens al mes, sin tarjeta. 1 token por llamada, así que el plan gratuito cubre unas 500 llamadas al mes.

Start free — 500 tokens / mo →See all plans
Sin tarjeta de créditoAcceso a más de 125 APIsCancela cuando quieras
response.json
{
  "total": 5419,
  "count": 1,
  "results": [
    {
      "ccn": "050625",
      "name": "CEDARS-SINAI MEDICAL CENTER",
      "address": {
        "city": "LOS ANGELES",
        "state": "CA"
      },
      "type": "Acute Care Hospitals",
      "emergencyServices": true,
      "overallRating": 5,
      "beds": 886
    }
  ]
}
Listo para producción
Infraestructura probada en producción con un SLA de disponibilidad del 99,9 %. Límites de uso generosos y respuestas consistentes.
Integración sencilla
REST + JSON estándar. Funciona con cualquier cliente HTTP. Fragmentos de código listos para copiar en 4 lenguajes.
Una clave, más de 125 APIs
Tu suscripción a DataAndAPIs desbloquea todas las APIs de la plataforma: anime, finanzas, deportes y más.

Casos de uso de Hospitals API

  • Encontrar el servicio de urgencias más cercano a la ubicación de un paciente en una herramienta de telemedicina o de despacho de ambulancias.

  • Mostrar las calificaciones de estrellas de CMS y los resúmenes de seguridad, reingresos y experiencia del paciente en una página de comparación de hospitales.

  • Filtrar hospitales por tipo, titularidad, nivel de trauma o indicador de maternidad para un directorio de derivaciones.

  • Enriquecer registros de reclamaciones o proveedores con dirección, teléfono, número de camas y sitio web del hospital a partir de su número de CMS.

Endpoints de Hospitals API

Todos los endpoints con sus parámetros y una respuesta de ejemplo real.

GETGet Hospital

https://api-hospitals.dataandapis.com/v1/hospitals/{ccn}

Este endpoint no recibe parámetros.

Petición de ejemplo

curl "https://api-hospitals.dataandapis.com/v1/hospitals/{ccn}" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "ccn": "050625",
  "name": "CEDARS-SINAI MEDICAL CENTER",
  "address": {
    "street": "8700 BEVERLY BLVD",
    "city": "LOS ANGELES",
    "state": "CA",
    "zip": "90048",
    "county": "LOS ANGELES"
  },
  "phone": "(310) 423-3277",
  "type": "Acute Care Hospitals",
  "ownership": "Voluntary non-profit - Private",
  "emergencyServices": true,
  "overallRating": 5,
  "latitude": 34.0757,
  "longitude": -118.3803,
  "beds": 886,
  "birthingFriendly": true,
  "measureGroups": {
    "mortality": {
      "measures": 8,
      "better": 3,
      "no_different": 5,
      "worse": 0
    },
    "safety": {
      "measures": 8,
…
Ver la respuesta completa
{
  "ccn": "050625",
  "name": "CEDARS-SINAI MEDICAL CENTER",
  "address": {
    "street": "8700 BEVERLY BLVD",
    "city": "LOS ANGELES",
    "state": "CA",
    "zip": "90048",
    "county": "LOS ANGELES"
  },
  "phone": "(310) 423-3277",
  "type": "Acute Care Hospitals",
  "ownership": "Voluntary non-profit - Private",
  "emergencyServices": true,
  "overallRating": 5,
  "latitude": 34.0757,
  "longitude": -118.3803,
  "beds": 886,
  "birthingFriendly": true,
  "measureGroups": {
    "mortality": {
      "measures": 8,
      "better": 3,
      "no_different": 5,
      "worse": 0
    },
    "safety": {
      "measures": 8,
      "better": 4,
      "no_different": 4,
      "worse": 0
    },
    "readmission": {
      "measures": 11,
      "better": 2,
      "no_different": 8,
      "worse": 1
    },
    "patient_experience": {
      "measures": 15,
      "better": null,
      "no_different": null,
      "worse": null
    },
    "timely_effective": {
      "measures": 9,
      "better": null,
      "no_different": null,
      "worse": null
    }
  },
  "trauma": "LEVEL I",
  "helipad": true,
  "website": "https://www.cedars-sinai.org",
  "countyFips": "06037",
  "facilityOwner": "NON-PROFIT",
  "geoMatched": true
}

GETHospital Types

https://api-hospitals.dataandapis.com/v1/hospitals/types

Este endpoint no recibe parámetros.

Petición de ejemplo

curl "https://api-hospitals.dataandapis.com/v1/hospitals/types" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "count": 8,
  "types": [
    {
      "type": "Acute Care Hospitals",
      "count": 3107
    },
    {
      "type": "Critical Access Hospitals",
      "count": 1382
    },
    {
      "type": "Psychiatric",
      "count": 624
    }
  ]
}

GETHospitals By State

https://api-hospitals.dataandapis.com/v1/hospitals/states

Este endpoint no recibe parámetros.

Petición de ejemplo

curl "https://api-hospitals.dataandapis.com/v1/hospitals/states" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "count": 56,
  "states": [
    {
      "state": "TX",
      "count": 467,
      "avgRating": 3.38
    },
    {
      "state": "CA",
      "count": 377,
      "avgRating": 3.1
    },
    {
      "state": "FL",
      "count": 221,
      "avgRating": 3.06
    }
  ]
}

GETList Hospitals

https://api-hospitals.dataandapis.com/v1/hospitals

Parámetros de consulta

ParámetroEjemplo
cityLos AngelesOpcional
countyLos AngelesOpcional
emergencytrueOpcional
limit20Opcional
minRating4Opcional
ownershipVoluntary non-profitOpcional
page1Opcional
qcedarsOpcional
ratedtrueOpcional
stateCAOpcional
traumatrueOpcional
typeAcute CareOpcional
zip90048Opcional

Petición de ejemplo

curl "https://api-hospitals.dataandapis.com/v1/hospitals?city=Los%20Angeles&county=Los%20Angeles&emergency=true&limit=20&minRating=4&ownership=Voluntary%20non-profit&page=1&q=cedars&rated=true&state=CA&trauma=true&type=Acute%20Care&zip=90048" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "total": 284,
  "page": 1,
  "limit": 20,
  "count": 1,
  "results": [
    {
      "ccn": "050625",
      "name": "CEDARS-SINAI MEDICAL CENTER",
      "address": {
        "street": "8700 BEVERLY BLVD",
        "city": "LOS ANGELES",
        "state": "CA",
        "zip": "90048",
        "county": "LOS ANGELES"
      },
      "phone": "(310) 423-3277",
      "type": "Acute Care Hospitals",
      "ownership": "Voluntary non-profit - Private",
      "emergencyServices": true,
      "overallRating": 5,
      "latitude": 34.0757,
      "longitude": -118.3803,
      "beds": 886
    }
  ]
}

GETNearby Hospitals

https://api-hospitals.dataandapis.com/v1/hospitals/nearby

Parámetros de consulta

ParámetroEjemplo
emergencytrueOpcional
lat34.0522Obligatorio
limit10Opcional
lon-118.2437Obligatorio
radius25Opcional

Petición de ejemplo

curl "https://api-hospitals.dataandapis.com/v1/hospitals/nearby?emergency=true&lat=34.0522&limit=10&lon=-118.2437&radius=25" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "lat": 34.0522,
  "lon": -118.2437,
  "radiusKm": 10,
  "count": 2,
  "results": [
    {
      "ccn": "050149",
      "name": "CALIFORNIA HOSPITAL MEDICAL CENTER",
      "distanceKm": 2.6,
      "emergencyServices": true,
      "overallRating": 2,
      "beds": 318
    },
    {
      "ccn": "050557",
      "name": "EAST LOS ANGELES DOCTORS HOSPITAL",
      "distanceKm": 6.3,
      "emergencyServices": true,
      "overallRating": 3,
      "beds": 127
    }
  ]
}

GETRandom Hospitals

https://api-hospitals.dataandapis.com/v1/hospitals/random

Parámetros de consulta

ParámetroEjemplo
amount3Opcional

Petición de ejemplo

curl "https://api-hospitals.dataandapis.com/v1/hospitals/random?amount=3" \
  -H "X-Api-Key: YOUR_API_KEY"
Respuesta de ejemplo
{
  "count": 2,
  "results": [
    {
      "ccn": "450054",
      "name": "BAYLOR UNIVERSITY MEDICAL CENTER",
      "address": {
        "city": "DALLAS",
        "state": "TX"
      },
      "type": "Acute Care Hospitals",
      "overallRating": 4
    },
    {
      "ccn": "141322",
      "name": "SARAH BUSH LINCOLN HEALTH CENTER",
      "address": {
        "city": "MATTOON",
        "state": "IL"
      },
      "type": "Critical Access Hospitals",
      "overallRating": null
    }
  ]
}

De dónde salen los datos

Fuente
Información general y calificaciones de CMS Hospital Compare, enriquecidas con la capa de hospitales HIFLD del DHS para coordenadas, camas, nivel de trauma y helipuerto.
Actualización
Datos de CMS resincronizados a diario. Enriquecimiento geográfico de la publicación HIFLD.

Una instalación. Todos los endpoints.

No necesitas SDKs propietarios. Funciona con cualquier cliente HTTP. Elige tu lenguaje y pega el código.

3lenguajes
6endpoints
RESTarquitectura
1clave para todas las APIs
  • Respuestas totalmente tipadas — autocompletado en tu IDE
  • Sigue la API al día — los nuevos endpoints llegan el mismo día
  • Una sola clave funciona en más de 125 APIs de la plataforma
import axios from 'axios';

const { data } = await axios.get(
  'https://api-hospitals.dataandapis.com/v1/hospitals/{ccn}',
  { headers: { 'X-Api-Key': process.env.API_KEY } }
);

Hospitals API · X-Api-Key

Explora los endpoints

Explora los parámetros de solicitud e inspecciona ejemplos de respuesta en vivo.

Endpoints disponibles

Parámetros de la solicitud

URL de la API

Encabezados

X-Api-Key
import axios from 'axios';

const url = 'https://api-hospitals.dataandapis.com/v1/hospitals/{ccn}';
const { data } = await axios.get(url, {
  headers: { 'X-Api-Key': 'YOUR_API_KEY' }
});

Una suscripción. Todas las APIs.

Los tokens desbloquean esta API y más de 20 más en DataAndAPIs. Cambia de API cuando quieras.

GRATIS

$0/mes

500 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte comunitario
Comienza gratis
Más Popular

STARTER

$6.99/mes

25.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte por email
Suscribirse

PRO

$24.99/mes

100.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte por email prioritario
Suscribirse

ULTRA

$99.99/mes

1.000.000 tokens / mes

  • Acceso a todas las APIs
  • Tokens se renuevan mensualmente
  • Soporte prioritario
Suscribirse

¿Necesitas mayor volumen, infraestructura dedicada o un contrato personalizado? Habla con ventas →

Preguntas sobre Hospitals API

APIs que suelen usarse con Hospitals API

Lanza Hospitals API esta tarde.

500 tokens gratis. Sin tarjeta. Y más de 125 APIs más con la misma clave.

Obtén tu clave API →Explorar todas las APIs