Skip to main content
GET
Search Discover listings

Headers

Authorization
string
required

value must be Bearer <token> where <token> is api key prefixed with cal_, managed user access token, or OAuth access token

Query Parameters

category
enum<string>

The Discover category the need maps to, such as medical for tooth pain.

Available options:
medical,
barbers,
coaching,
consulting,
lessons,
pets,
sports,
dance,
social,
online-services,
saas,
home-services,
other
Example:

"barbers"

subcategory
enum<string>

A subcategory of category, such as dentistry under medical. Ignored without its category, and named in ignoredFilters when it is not one of the category's.

Available options:
dentistry,
therapy,
physiotherapy,
nutrition,
somatic-and-breathwork,
doula,
general-care,
haircuts,
beard-and-shave,
coloring,
kids-cuts,
nails,
waxing,
lashes,
skin-and-spa,
massage,
tattoo,
life,
career,
executive,
mindset,
spiritual,
business,
tech-and-ai,
finance-and-tax,
legal,
real-estate,
marketing,
hr,
academic,
language,
music-and-voice,
arts,
chess,
veterinary,
grooming,
training,
sitting,
fitness,
yoga,
tennis,
swimming,
skiing,
salsa,
ballet,
hip-hop,
ballroom,
clubs,
workshops,
networking,
tours,
photoshoots-and-studios,
pop-ups-and-showrooms,
design,
development,
writing,
virtual-assistance,
legal-advice,
product-demos,
onboarding,
customer-support,
sales,
cleaning,
repairs,
heating-and-cooling,
inspections,
auto
Example:

"haircuts"

query
string

Free text matched against the title, description, provider and subcategory. Never a place.

Maximum string length: 100
Example:

"skin fade"

neighborhood
string

A neighborhood of a launch region, such as Capitol Hill, for in-person listings there only. An unknown name comes back in ignoredFilters.

Maximum string length: 80
Example:

"Capitol Hill"

onlineOnly
boolean

Keep only online listings and search them everywhere, whatever area says. Online searches never fall back to the web.

Example:

false

localQuery
string

For the web fallback, the need in the area's local language when it is not English, such as Zahnarzt for a dentist in Hamburg.

Maximum string length: 100
Example:

"Zahnarzt"

area
string

The place to search around: a ZIP code, neighborhood or city. Without it, the search uses your saved ZIP code, and answers areaNeeded when there is none. Pass anywhere for results from anywhere.

Maximum string length: 80
Example:

"98122"

maximumPrice
number

The highest price, in whole currency units: 50 means $50, 0 means free only.

Required range: x >= 0
Example:

50

maximumDurationMinutes
number

The longest session, in minutes.

Required range: x >= 1
Example:

60

availableWithin
enum<string>

Only listings with a real open slot in this window, in your saved time zone. this_week means the next 7 days.

Available options:
today,
tomorrow,
this_week
Example:

"today"

Response

status
enum<string>
required
Available options:
success,
error
Example:

"success"

data
object
required