# SiteCheck Company Records – Booksy Beauty & Wellness Business Search

> SiteCheck Company Records – Booksy Beauty & Wellness Business Search is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Returns up to 20 beauty, barber, and wellness businesses listed on Booksy (US) for a given category and optional region, including name, address, coordinates, rating, reviews, social links, and service pricing.

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/b2b/booksy?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/sitecheck-company-records-booksy-beauty-wellness-business-search-2637c673
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_aRooG5RFFHJNyALm8nuuW

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability sitecheck-company-records-booksy-beauty-wellness-business-search-2637c673
```

Example prompt: Find me the top barber shops in Chicago on Booksy — I want their names, addresses, ratings, and what services they offer with prices. Use region ID 18229 for Chicago.

## When to prefer this

Use this endpoint when you need structured, ready-to-use business data (name, address, coordinates, rating, services, pricing, social profiles) from Booksy's beauty and wellness marketplace for a specific US city or region. Prefer this over generic web scraping when you want Booksy-specific attributes like Booksy Pay acceptance, promoted status, and per-service pricing. Best suited for local business discovery, competitor analysis, or building appointment-booking workflows targeting the beauty and wellness vertical.

## Known failure modes

- Missing required 'category' parameter returns an error
- Invalid or unknown regionId may return zero results or a US-wide fallback
- Category slug not matching Booksy's accepted values returns an error or empty results
- Booksy's underlying search page being unavailable causes a failure response
- Limit out of range (not 1–20) may cause a validation error

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

A JSON object containing the region details, category, source URL, check timestamp, total matching business count, and an array of up to 20 businesses — each with ID, name, city, address, latitude/longitude, rating, review count, website, Instagram, Facebook, promoted flag, Booksy Pay acceptance, and the first listed services with name, price, and duration in minutes.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [
      "category"
     ],
     "properties": {
      "limit": {
       "type": "string",
       "description": "Businesses to return, 1 to 20 (default 20)"
      },
      "category": {
       "type": "string",
       "description": "Booksy category slug: hair-salon, barber-shop, nail-salon, skin-care, brows-lashes, massage, makeup, wellness-day-spa, braids-locs, tattoo-shop, aesthetic-medicine, hair-removal, home-services, piercing, pet-services, dental-orthodontics, health-fitness, professional-services, other"
      },
      "regionId": {
       "type": "string",
       "description": "Booksy region id from a search URL, e.g. 18229 (Chicago), 134763 (Orlando), 15761 (Tampa); empty = whole US"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "region": {
   "id": 18229,
   "name": "Chicago, IL",
   "type": "city"
  },
  "source": "https://booksy.com/en-us/s/barber-shop/18229_x",
  "category": "barber-shop",
  "checkedAt": "2026-10-23T09:37:29.143Z",
  "businesses": [
   {
    "id": 407964,
    "url": "https://booksy.com/en-us/407964_carlosthebarber_barber-shop_18229_chicago",
    "city": "Chicago",
    "name": "Carlosthebarber",
    "rating": 5,
    "address": "7548 W Addison st, Chicago, 60634",
    "website": null,
    "facebook": null,
    "latitude": 41.94535163018833,
    "promoted": true,
    "services": [
     {
      "name": "Haircut",
      "price": 45,
      "priceText": "$45.00",
      "durationMin": 45
     },
     {
      "name": "Haircut/beard and eyebrows",
      "price": 55,
      "priceText": "$55.00",
      "durationMin": 60
     }
    ],
    "instagram": null,
    "longitude": -87.81644134927913,
    "reviewsCount": 203,
    "acceptsBooksyPay": true
   },
   {
    "id": 959275,
    "url": "https://booksy.com/en-us/959275_guerochopz_barber-shop_18229_chicago",
    "city": "Chicago",
    "name": "Güerochopz 💈",
    "rating": 4.905882352941177,
    "address": "7548 w addison, Shop, Chicago, 60634",
    "website": null,
    "facebook": null,
    "latitude": 41.9451732578475,
    "promoted": true,
    "services": [
     {
      "name": "Haircut and beard",
      "price": 45,
      "priceText": "$45.00",
      "durationMin": 60
     },
     {
      "name": "Beard maintenance",
      "price": 20,
      "priceText": "$20.00",
      "durationMin": 25
     }
    ],
    "instagram": null,
    "longitude": -87.81636759489054,
    "reviewsCount": 85,
    "acceptsBooksyPay": false
   }
  ],
  "totalCount": 1479
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/sitecheck-company-records-booksy-beauty-wellness-business-search-2637c673/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)