Search

GET/v1/searchLive

Substring match across facility and procedure names.

Authentication

This endpoint requires an API key, as every endpoint does. Keys are issued on signup — the free trial needs no card. See authentication for key handling, or view the data first in the Explorer.

Case-insensitive substring matching over facility names, cities, and procedure descriptions. Scoring is prefix-weighted so exact starts rank first. This is not fuzzy search — a typo will not match, by design: an obvious ranking nobody has to guess at beats a clever one nobody has tuned.

Parameters

Name	Type	Description
`q` required	string	Search terms. Minimum 2 characters.
`type`	string	Restrict to facility or procedure.
`limit`	integer	Rows to return, 1–50. Defaults to 20.

Request

curl

curl "https://api.vemon.io/v1/search?q=tampa&type=facility" \
  -H "Authorization: Bearer vm_live_…"

Response

200 OK

{
  "query": "tampa",
  "summary": { "matches": 9, "returned": 9 },
  "data": [
    {
      "dataset": "healthcare-prices",
      "type": "facility",
      "id": "100128",
      "title": "Tampa General Hospital",
      "subtitle": "Tampa, FL",
      "matched_field": "name",
      "score": 0.9
    }
  ]
}

Errors

missing_parameter400
invalid_parameter400
rate_limit_exceeded429

Full list on the errors page.