API reference
Clinic research
Who owns and runs one clinic, who works there, and how to reach it, from the public web.
POST /v2/clinic-research · GET /v2/clinic-research/{id}
One clinic from GET /v2/clinics, researched on its own pages first, then its listings: the owner, the medical director, the people its team page lists, and the clinic's phone, email, website, hours, address and owning group. Each person found is matched to a board licence in the clinic's state when exactly one person of that name holds one (license_id).
This is the derived layer: reported from public pages, with the pages it drew on, not the board record. A person who asked not to be researched is left out. A person's own email or phone is a Contact.
Research a clinic
curl https://api.zuse.live/v2/clinic-research \
-H "Authorization: Bearer $ZUSE_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: 7f9c1e" \
-d '{ "clinic": "p_5973" }'| Field | Type | Description |
|---|---|---|
clinic | string | Required. The clinic's ref from GET /v2/clinics. |
refresh | boolean | Research it again even if your team already has research on file. false if omitted. |
Response
{
"data": {
"id": "crs_4b1e0c9a2d7f4e8c9b0a1d2e3f4a5b6c",
"status": "completed",
"found": true,
"people": [
{ "name": "Dana Whitfield", "role": "Medical director, DVM", "source_url": "https://www.example-vet.com/our-team", "person_id": 113409, "license_id": 220871, "profession": "veterinarian" },
{ "name": "Sam Ortega", "role": "Practice manager", "source_url": "https://www.example-vet.com/our-team" }
],
"phone": "(304) 555-0100",
"email": "front@example-vet.com",
"website": "https://www.example-vet.com",
"hours": "Mon-Fri 8:00-18:00; Sat 8:00-12:00",
"group": "independent",
"fact_sources": { "email": "https://www.example-vet.com/contact" },
"sources": ["https://www.example-vet.com/our-team", "https://www.example-vet.com/contact"],
"layer": "reported",
"clinic": { "ref": "p_5973", "name": "Example Animal Hospital", "city": "Parkersburg", "state": "WV", "zip": "26101" },
"from_records": false,
"written_at": "2026-10-17T20:14:03Z"
},
"billing": { "operation": "clinic_research", "cost_usd": 0.25, "credit_remaining_usd": 9.73 }
}A value that only repeats what the clinic's record already says (the same phone or website) is left out. found: false means nothing reliable was found about this clinic; it costs nothing.
Read it again for 24 hours with GET /v2/clinic-research/{id}, free.
Billing
$0.50 when the clinic is found; free when nothing is. Kept on your team's records for 30 days: researching the same clinic again returns it with from_records: true at no charge, on any channel. Send an Idempotency-Key so a retry is not charged again. Up to 10 a minute and 100 a day. See Pricing and metering.