LifestyleBrowser

Hot Pepper Beauty

beauty.hotpepper.jp

Japanese salon discovery, availability search, reservation preparation, and booking management.

Tier: 🥈 Silver
Reward: ₩150,000
Auth: Browser
Operations: 6
Working now: 0 contributors
Status: Open

Scope

Build a Hot Pepper Beauty salon-booking provider. It should help users compare salons, menus, stylist availability, coupon conditions, reservation totals, cancellation rules, and booking history for hair, nail, eyelash, and spa appointments.

Expected operations

search-salonsSearch salonsreadDifficulty: easy

Search salons via the HotPepper Beauty API by area, service genre, budget, date, and party needs, returning ranked salon listings.

Inputs

keystringrequired

Suggested surface — propose changes in your submission if the upstream differs.

Acceptance criteria

Provider scaffolded from the public @apifuse/provider-sdk
All listed operations implemented with Zod/Standard Schema input & output
Each operation declares exactly one of healthCheck or healthCheckUnsupported
Real upstream fixture data included where applicable
bun run check and bun run test pass
Auth, credential, and env-secret behavior documented (no real secrets committed)

Evidence to submit

Workspace repository and main commit link
SDK version/tag and the create command used
Operation list with input/output summaries
Health coverage table per operation
bun run check and bun run test output

Ready to claim?

Submit a claim. Your workspace will be prepared after confirmation.

Claiming a bounty requires a GitHub sign-in.

Recruit Web Service API key

service_areastringoptional

Service area code

SA11

keywordstringoptional

Free keyword such as station or salon name

Shibuya cut

budgetstringoptional

Budget code filter

B011

countnumberoptional

Results per page (max 100)

Outputs

salon_idnameaddressaccessbudgetphoto_urlurls_pcstation_name

Acceptance

Accepts area or keyword and returns salon listings with salon_id and name.
Budget and service_area filters narrow the returned salons.
Pagination via count and start returns non-overlapping result pages.

Auth required for this operation.

get-salon-detailGet salon detailreadDifficulty: medium

Fetch salon detail for a salon_id including menu pricing, stylist options, coupon conditions, and store policies from the HotPepper Beauty salon detail surface.

Inputs

keystringrequired
Recruit Web Service API key
YOUR_API_KEY
salon_idstringrequired
HotPepper Beauty salon identifier
H000123456

Outputs

salon_idnamemenusstylistscouponsopen_hours

check-appointment-slotsCheck appointment slotsreadDifficulty: medium

Check open reservation slots and alternative times for a salon and target date, reflecting stylist availability.

Inputs

salon_idstringrequired
Salon identifier
H000123456
datedaterequired
Target reservation date
2026-08-05
stylist_idstringoptional
Preferred stylist id
st_4412

Outputs

dateavailable_slotsstylist_idslot_status

Acceptance

Returns available_slots for the requested salon and date.
Includes alternative times when the preferred slot is full.
A salon with no availability returns an empty slot set, not a fabricated opening.

prepare-reservationPrepare reservationwriteDifficulty: medium

Assemble a reservation draft with the selected menu, staff, date/time, and contact details for review before submission.

Inputs

salon_idstringrequired
Salon identifier
H000123456
menu_idstringrequired
Selected menu id
m_cut_color
slotstringrequired
Selected date and time slot
2026-08-05T14:00
stylist_idstringoptional
Selected stylist id
st_4412
contact_namestringrequired
Reservation contact name
Hanako Suzuki

Outputs

draft_idsalon_idmenu_idslottotal_estimaterequires_confirmation

confirm-or-cancel-bookingConfirm or cancel bookingwriteDifficulty: hard

Confirm a prepared reservation or cancel an existing salon booking, executed only after explicit user approval.

Inputs

draft_idstringoptional
Draft id to confirm
drft_5521
booking_idstringoptional
Existing booking id to cancel
hpb_99120
actionstringrequired
Either confirm or cancel
confirm

Outputs

booking_idstatuscancellation_policyconfirmed_at

Acceptance

Confirm returns a booking_id and reserved status after approval.
Cancel applies the salon cancellation policy and returns the resulting status.
An action lacking a matching draft or booking fails without side effects.

list-bookingsList bookings and historyreadDifficulty: medium

List upcoming bookings, past visit history, and receipt details for the authenticated user.

Inputs

statusstringoptional
Filter by booking status
upcoming

Outputs

booking_idsalon_nameslotmenu_namevisit_statusreceipt_url

Acceptance

Returns menu pricing and stylist options for the given salon_id.
Coupon conditions and opening hours are preserved from upstream.
An unknown salon_id returns an explicit not-found result.

Auth required for this operation.

Acceptance

Produces a reservation draft with total_estimate and requires_confirmation true.
Does not book automatically; a reviewable draft is returned.
Missing menu or slot is rejected as a validation error.

Auth required for this operation.

Acceptance

Returns bookings only for the authenticated account.
Separates upcoming bookings from past visit history via status.
Each row includes menu_name and, when available, receipt_url.

Auth required for this operation.