Search Yelp for businesses matching a term, location, or both.

Use this tool when the user wants to discover businesses — restaurants, services, shops, entertainment — in a given area. It supports free-text search, geo coordinates, category filters, price tiers, open-now filtering, and pagination.

Supply at least one of: location, or both latitude + longitude.

Returns a list of matching businesses with ratings, review counts, price tier, address, and a Yelp URL. The 'total' field indicates how many results exist in the full result set; use 'offset' to paginate.

Raises ValueError when neither location nor coordinates are provided.

Look up Yelp businesses that match a phone number.

Use this when you have a phone number and need to identify which business it belongs to. Returns up to a handful of candidates ranked by relevance. An empty list means no Yelp listing was found for that number.

The phone must include the country code in E.164 format (+14155551234).

Match a business by name and address to its canonical Yelp listing.

Use this when you have structured address data (from a CRM, spreadsheet, or user input) and need to verify or enrich it with Yelp data such as the Yelp ID, rating, hours, and URL.

Name + address1 + city + state + country are required. Adding zip_code and phone significantly improves match precision.

Returns ranked candidates; the first result is the best match. An empty list means no match was found at the chosen threshold.

Fetch the full Yelp profile for a specific business by its ID or alias.

Use this when you already have a Yelp business ID (from search results or a previous call) and need complete details: hours, all photos, full address, price tier, categories, and the Yelp URL.

Raises an error if the business ID does not exist on Yelp.

Retrieve user reviews for a specific Yelp business.

Use this when the user wants to read what customers say about a business: sentiment, specific comments about food, service, or atmosphere. Returns up to 50 reviews per call with text excerpts, star ratings, and reviewer info.

The 'total' field in the response shows how many reviews exist in full; use 'offset' to paginate through them.

Raises an error if the business ID does not exist on Yelp.