---
title: "Search Healthgrades hospitals, pharmacies, group practices, and urgent care"
method: GET
path: "/healthgrades/facilities/search"
tags: ["Healthgrades"]
---

# Search Healthgrades hospitals, pharmacies, group practices, and urgent care

`GET /healthgrades/facilities/search`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/healthgrades/facilities/search`
- Auth: API key in header `x-api-key`

Returns one page of Healthgrades facility search results near a location for one facility type (hospital, pharmacy, group practice, or urgent care), with name, address, phone, distance, profile URL, affiliated provider and rating counts, hospital awards, and the filters available for the search. Requests use US egress because Healthgrades restricts content by region.

## Query parameters

- `type` 'hospital' | 'pharmacy' | 'group_practice' | 'urgent_care', required
- `query` string
- `where` string, required
- `page` integer
- `sort` 'bestmatch' | 'distance' | 'patientsatisfaction'
- `distance` '0.5' | '1' | '5' | '10' | '25' | '50' | '100' | 'national'
- `rating` string
- `award` string

## Headers

- `x-api-key` string, required

## Response `200`

OK

- HealthgradesFacilitySearchResponseDoc
  - `data` HealthgradesFacilitySearchResponse
    - `facilities` HealthgradesFacilityResult[]
      - `about` string
      - `affiliated_provider_count` integer
      - `awards` string[]
      - `city` string
      - `distance_miles` number
      - `five_star_ratings_count` integer
      - `id` string
      - `latitude` number
      - `longitude` number
      - `name` string
      - `phone` string
      - `postal_code` string
      - `ratings_count` integer
      - `state` string
      - `street` string
      - `type` string
      - `type_code` string
      - `url` string
    - `filters` HealthgradesPhysicianFilterGroup[]
      - `label` string
      - `param` string
      - `values` HealthgradesPhysicianFilterValue[]
        - `count` integer
        - `label` string
        - `plans` HealthgradesPhysicianFilterPlan[]
          - `id` string
          - `name` string
        - `selected` boolean
        - `value` string
    - `page` integer
    - `page_size` integer
    - `query` string
    - `sort` string
    - `sorts` HealthgradesPhysicianSortOption[]
      - `key` string
      - `label` string
    - `total_pages` integer
    - `total_results` integer
    - `type` string
    - `where` string

## Other responses

- `400`: Bad Request
- `429`: Too Many Requests
- `503`: Service Unavailable

---

[API](https://skmtc.dev/crawlora/apis/crawlora-api.md) · [All operations](https://skmtc.dev/crawlora/apis/crawlora-api/llms.txt) · [OpenAPI document](https://skmtc.dev/crawlora/apis/crawlora-api/revisions/afac9b012a27?raw)