# Booksy — Wrapped API

> **You are on:** `https://api.beta.paywithlocus.com/api` | [llms.txt](https://beta.paywithlocus.com/llms.txt) | [docs](https://docs.paywithlocus.com)
>
> Locus runs on multiple environments -- make sure every URL you call matches your expected environment.
> | Environment | Landing | API | Docs |
> |---|---|---|---|
> | Production | paywithlocus.com | api.paywithlocus.com | docs.paywithlocus.com |
> | Beta | beta.paywithlocus.com | api.beta.paywithlocus.com | docs.paywithlocus.com |
> | Stage | stage.paywithlocus.com | api.stage.paywithlocus.com | docs.paywithlocus.com |
>
> If the API URL above doesn't match your expected environment, re-fetch this file from the correct domain.

> Retrieve detailed business information including ratings, reviews, and booking links from Booksy, and check real-time available appointment time slots to schedule your next visit. Perfect for finding service providers and managing your bookings all in one place.

**Category:** Other | **Website:** [booksy.com/en-us/81004_paul-the-barber-in-westwood_barber-shop_134655_los-angeles](https://booksy.com/en-us/81004_paul-the-barber-in-westwood_barber-shop_134655_los-angeles) | **Docs:** [parse.bot/marketplace/d4926153-df22-49ab-9cd4-0699584d805e/booksy-com-api](https://parse.bot/marketplace/d4926153-df22-49ab-9cd4-0699584d805e/booksy-com-api)

Pay-per-use API proxy. Each call is automatically billed to your wallet in USDC.

## Access

**Base URL:** `https://api.beta.paywithlocus.com/api/wrapped/parse-booksy-com-api-d4926153/`
**Auth:** `Authorization: Bearer <LOCUS_API_KEY>`

## Endpoints

### Get business info

Fetch full business profile from Booksy including name, rating, review count, booking link, services offered (with pricing and duration), staff members, and weekly opening hours. Each service includes a variant_id needed for time-slot lookups. Supports multiple Booksy markets (en-us, pl-pl) via the locale parameter; auto-detects the correct market when locale is omitted or defaulted. Returns one business per call; no pagination.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `business_id` | string | No | Numeric Booksy business ID. |
| `locale` | string | No | Booksy market locale code (e.g. 'en-us', 'pl-pl'). Determines which regional Booksy API to query. Defaults to 'en-us'; auto-detects when the business is not found in the default market. |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-booksy-com-api-d4926153/get_business_info \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"business_id":"<string>","locale":"<string>"}'
```

### Get time slots

Fetch available appointment time slots for a specific date and service at a Booksy business. Returns a list of HH:MM 24-hour time strings. An empty list means the business is closed or fully booked on that date. The date must be in the future; service_variant_id and optionally staffer_id come from get_business_info. Supports multiple Booksy markets (en-us, pl-pl) via the locale parameter; auto-detects the correct market when locale is omitted or defaulted.

**Estimated cost:** Metered

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `business_id` | string | No | Numeric Booksy business ID. |
| `date` | string | No | Date to check availability, ISO format YYYY-MM-DD. Defaults to 3 days from now if omitted. |
| `locale` | string | No | Booksy market locale code (e.g. 'en-us', 'pl-pl'). Determines which regional Booksy API to query. Defaults to 'en-us'; auto-detects when the business is not found in the default market. |
| `service_variant_id` | string | No | Service variant ID from get_business_info services[*].variant_id. |
| `staffer_id` | string | No | Staff member ID from get_business_info staff[*].id. Use -1 for no preference (any available staff). |

```bash
curl -X POST https://api.beta.paywithlocus.com/api/wrapped/parse-booksy-com-api-d4926153/get_time_slots \
  -H "Authorization: Bearer YOUR_LOCUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"business_id":"<string>","date":"<string>","locale":"<string>","service_variant_id":"<string>","staffer_id":"<string>"}'
```