---
title: "Search for businesses on Yelp"
method: POST
path: "/yelp/search-businesses"
tags: ["Yelp"]
---

# Search for businesses on Yelp

`POST /yelp/search-businesses`

Search for businesses on Yelp given a query, location, and other criteria

## Request body

- object
  - `query` string, required — The search term to find businesses
  - `location` string, required — The location to search for businesses
  - `sort_by` 'recommended' | 'highest_rated' | 'review_count' — The criteria to sort the results (e.g., "recommended", "highest_rated", etc.)
  - `start` integer — The starting index for pagination (default is 0)
  - `count` integer — The number of businesses to retrieve

## Response `200`

SearchBusinesses API successful response

- object
  - `businesses` object[]
    - `business_id` string — Unique identifier for the business
    - `alias` string — A unique identifier used in the URL for the business

## Other responses

- `400` — User error response
- `500` — Server error response

---

[API](https://skmtc.net/carvedai/apis/exfunc-apis.md) · [All operations](https://skmtc.net/carvedai/apis/exfunc-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carvedai/exfunc-apis/revisions/22587fdf9a5e/schema)