---
title: "Get Healthgrades search suggestions"
method: GET
path: "/healthgrades/autocomplete"
tags: ["Healthgrades"]
---

# Get Healthgrades search suggestions

`GET /healthgrades/autocomplete`

## Request

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

Returns dynamic provider, specialty, condition, procedure, and other suggestions for a free-text query. Group categories vary with the query and are returned as data, not accepted as a closed enum.

## Query parameters

- `term` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- HealthgradesSuggestionsResponseDoc
  - `data` HealthgradesSuggestionResponse
    - `groups` HealthgradesSuggestionGroup[]
      - `category` string
      - `suggestions` HealthgradesSuggestion[]
        - `label` string
        - `value` string
      - `title` 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/028417aa35bb?raw)