# Booksy — Wrapped API

> **You are on:** `https://api.paywithlocus.com/api` | [llms.txt](https://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.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.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.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>"}'
```