BeautyClinic.ca — For AI Agents
BeautyClinic.ca is an independent Canadian directory of beauty, laser and medical aesthetics clinics, and a consultation-request routing service. It is not a clinic, and it is not affiliated with the clinics it lists. The directory currently lists 130 clinics in 10 cities, with 564 published prices collected from the clinics' own websites.
If you are an AI assistant helping a user find a clinic, compare prices, or request a consultation or quote, this page documents exactly what you can do programmatically, what each response means, and the limits of the service. Please respect the limits: they are part of how the service works, not fine print.
What an agent can do
- Look up clinics, treatments, cities and published prices through the JSON data feeds and the full-text dump listed below. No key or signup is required.
- Request a consultation or quote for your user by POSTing one JSON request. The request is delivered to one matched clinic — the exclusive partner for that city and treatment — and that clinic contacts your user directly with its quote.
- Claim a profile on behalf of a clinic (for clinic owners or their representatives) by POSTing a claim. Claims are reviewed manually by a person.
What this service does not do
- It does not confirm bookings or appointments. Submitting a request is not a booking. The clinic offers times and confirms any appointment when it contacts your user.
- It does not quote prices itself. The only prices here are the clinics' own published prices (see the price feeds). A quote for a specific user comes from the clinic after contact.
- It does not provide medical advice, diagnoses, or treatment recommendations.
- It never sells or shares a user's contact details with a list of clinics. With the user's consent, details go to one matched clinic (plus at most one backup clinic if the first does not respond — see Timing).
Action 1: Request a consultation or quote
Send a POST request with a JSON body to the lead API:
- Canonical endpoint: POST https://beautyclinic.ca/api/lead
- Currently live endpoint (same API): POST https://beautyclinic-lead-engine.nova-97c.workers.dev/api/lead
- Content type: application/json (form-encoded bodies are also accepted)
Fields
| Field | Type | Required | Notes |
|---|---|---|---|
| name | string | Yes | The user's full name. |
| string | One of email or phone | Must be a valid email address if given. | |
| phone | string | One of email or phone | The user's phone number; at least 7 digits. |
| city_id | string | Yes | Must be a city_id from the cities feed, for example toronto. |
| treatment_id | string | Yes | Must be a treatment_id from the treatments feed, for example laser-hair-removal. |
| clinic_id | string | No | A specific clinic_id from the clinics feed, if the user picked one clinic. Routing is still by city and treatment. |
| area | string | No | Body area or package the user is interested in, for example underarms. Passed to the clinic with the message. |
| message | string | No | Anything else the user wants the clinic to know. |
| source_page | string | No | URL the request originated from, for attribution. |
| consent | boolean | Yes, must be true | Means the user explicitly agreed to be contacted by ONE matched clinic about this request. Requests without consent are rejected. |
| cf-turnstile-response | string | Yes | A valid Cloudflare Turnstile token. See the spam protection note below. |
| hp | string | No | Honeypot field. Leave it empty; filled honeypots are silently discarded. |
Example request
{
"name": "Jordan Example",
"email": "[email protected]",
"phone": "+1 604 555 0123",
"city_id": "vancouver",
"treatment_id": "laser-hair-removal",
"area": "underarms",
"message": "Interested in pricing for a package of sessions.",
"consent": true,
"cf-turnstile-response": "TURNSTILE_TOKEN"
}Responses
| HTTP status | Body | Meaning |
|---|---|---|
| 200 | ok true, matched true, delivered true | A partner clinic exists for this city and treatment, and the request was delivered to it. The clinic will contact the user directly. |
| 200 | ok true, matched true, delivered false | A partner clinic exists, but live delivery failed and is being retried automatically. Do not resubmit. |
| 200 | ok true, matched false | There is no partner clinic for this city and treatment yet. The request is held, not discarded: the user is contacted when a partner clinic joins. Set expectations accordingly. |
| 400 | ok false, errors list | Validation failed. Possible codes: name_required, phone_or_email_required, email_invalid, phone_invalid, city_invalid, treatment_invalid, clinic_invalid, consent_required. Fix the fields and resubmit. |
| 403 | ok false, errors verification_failed | The Turnstile token was missing or invalid. Obtain a fresh token and resubmit. |
| 500 | ok false, error server_error | Temporary server problem. Wait and retry once. |
Success bodies are JSON objects with the fields shown; for example the delivered case returns an object with ok, matched and delivered all true.
Timing: what happens after a matched request
- The matched clinic is notified immediately (SMS and email) and is asked to accept the request within about 15 business minutes. Business hours are 08:00 to 20:00 in the clinic's local time, and the clock pauses outside business hours.
- If the clinic does not accept in time, the request cascades to one backup clinic for that city and treatment, if one exists. A cascaded request is never billed twice and never goes to more than two clinics in total.
- After accepting, the clinic contacts your user directly — that is when quotes, consultation times and any booking happen. BeautyClinic.ca is not part of that conversation and cannot confirm, change or cancel appointments.
- There is no status-check endpoint yet. If your user has not heard from the clinic within one business day, they can contact us at [email protected] and we will follow up.
Spam protection note (Turnstile)
The API is protected by Cloudflare Turnstile because it delivers messages to real businesses. The Turnstile site key is embedded in every consultation form on beautyclinic.ca: load a form page, complete the Turnstile widget as the page presents it, and include the resulting token as cf-turnstile-response. Tokens are short-lived and single-use. If you cannot complete Turnstile, direct your user to the consultation form on the relevant page of beautyclinic.ca instead of retrying the API.
Action 2: Claim a clinic profile (for clinics)
Clinics can claim their free listing to correct it, add contact details, and receive consultation requests from their profile page. Send a POST request with a JSON body:
- Canonical endpoint: POST https://beautyclinic.ca/api/claim
- Currently live endpoint (same API): POST https://beautyclinic-lead-engine.nova-97c.workers.dev/api/claim
| Field | Type | Required | Notes |
|---|---|---|---|
| clinic_id | string | Yes | Must be a clinic_id from the clinics feed. |
| contact_name | string | Yes | Name of the person claiming on behalf of the clinic. |
| string | Yes | Business email; ownership is verified against the clinic's own published contact details. | |
| phone | string | No | Optional contact phone. |
| cf-turnstile-response | string | Yes | Valid Cloudflare Turnstile token, as above. |
Responses: 200 with ok true when the claim is recorded (status pending). 400 with errors among clinic_invalid, contact_name_required and email_invalid. 403 with verification_failed for a bad Turnstile token. Claims are reviewed manually; a submitted claim changes nothing on the listing until a person verifies ownership and approves it.
Data feeds (no key required)
- Clinics JSON: https://beautyclinic.ca/data/clinics.json — every listed clinic with its public fields and services. Phone numbers and websites appear only for clinics that have claimed their profile; unclaimed clinics are contacted through the request API.
- Treatments JSON: https://beautyclinic.ca/data/treatments.json — the treatment taxonomy with typical Canadian price ranges.
- Cities JSON: https://beautyclinic.ca/data/cities.json — covered cities and neighbourhoods.
- Prices JSON: https://beautyclinic.ca/data/prices.json — every published price collected, per clinic, treatment and area or package, in CAD, with the source page and capture date for each row.
- Full text: https://beautyclinic.ca/llms-full.txt — the complete directory in one markdown file: every treatment with per-city price ranges from real published prices, and every clinic with its prices.
- Summary: https://beautyclinic.ca/llms.txt — a short index of the site.
- API description: GET https://beautyclinic-lead-engine.nova-97c.workers.dev/api/agent-info returns the machine-readable version of this page, and https://beautyclinic.ca/api/openapi.json is the OpenAPI 3 specification for the two POST endpoints.
Reading the prices
Prices in the feeds are the clinics' own published prices, collected from their websites with the source URL and capture date on each row. They are comparison data, not quotes: clinics confirm final pricing at consultation, and package pricing varies by area and number of sessions. For treatments that are prescription-only in Canada (for example Botox and dermal fillers), listings show name, price and quantity information only.
Contact
- Operator contact for agents, clinics and users: [email protected]
- This documentation in raw markdown: https://beautyclinic.ca/agents.md
This page is also available as raw markdown at /agents.md.