- Category: reviews
- Auth: NO_AUTH, API_KEY
- Composio-managed OAuth available? N/A
- Tools: 12
- Triggers: 0
- Slug:
YELP - Version: 20261101_00
- Instant: Supported on the latest version. Support varies by tool.
Tools
Autocomplete Search
Autocomplete Search
Slug:
YELP_GET_AUTOCOMPLETEGet autocomplete suggestions for businesses, categories, and search terms on Yelp based on partial text input. Returns matching businesses with their Yelp IDs, relevant category suggestions, and additional search term recommendations. Use this action when users are typing search queries and need real-time suggestions to refine their search before executing a full business search. Location coordinates (latitude/longitude) are optional but can improve suggestion relevance for geographic searches.Instant: Supported on the latest version.Instant pricing: Estimated $0.021 per successful API callInput Parameters
Search text to autocomplete. Provide partial business names, categories, or search terms to get suggestions.
Locale code in the format {language_code}_{country_code}. See Yelp’s list of supported locales. Defaults to en_US.
Latitude of the location to search from. If provided, longitude is also required. Used to refine autocomplete suggestions based on geographic location.
Longitude of the location to search from. If provided, latitude is also required. Used to refine autocomplete suggestions based on geographic location.
Output
Get Business Details
Get Business Details
Slug:
YELP_GET_BUSINESS_DETAILSGet detailed information about a Yelp business by ID or alias, including location, photos, rating, review count and, when available, hours and phone number. The returned URL is the Yelp listing page.Instant: Supported on the latest version.Instant pricing: Estimated $0.021 per successful API callInput Parameters
IMPORTANT: This is NOT the business name. Must be the unique Yelp business ID (e.g., ‘WavvLdfdP6g8aZTtbBQHTw’) or URL-friendly alias (e.g., ‘north-india-restaurant-san-francisco’) obtained from YELP_SEARCH_BUSINESSES or YELP_SEARCH_BY_PHONE. Business names like ‘Almar Cleaners’ or ‘Pizza Hut’ will be rejected. Use the search action first to find the business and get its ID or alias.
Output
Get Business Reviews
Get Business Reviews
Slug:
YELP_GET_BUSINESS_REVIEWSGet reviews for a specific business on Yelp using its business ID or alias. Returns up to 3 review excerpts for the business.Instant: Supported on the latest version.Instant pricing: Estimated $0.021 per successful API callInput Parameters
Locale for the reviews. Defaults to en_US. If reviews list is empty but total > 0, the locale may be mismatched — check possible_languages in the response and set locale explicitly to match.
Yelp business ID or alias. Can be the unique ID or the business alias from search results. Must be obtained first via a business search tool (e.g., search by name or phone); passing a plain business name directly is not supported.
Output
Get Category Details
Get Category Details
Slug:
YELP_GET_CATEGORYGet detailed information about a specific Yelp category by its alias. Returns category metadata including the human-readable title, parent categories, and country availability lists. Use this action when you need to understand category hierarchies, check category availability by country, or get the proper display name for a category alias. The alias parameter must be a valid Yelp category identifier — use the list categories endpoint to discover available aliases.Instant: Supported on the latest version.Instant pricing: Estimated $0.021 per successful API callInput Parameters
Yelp category alias that identifies the specific category to retrieve. The alias can be found using the /v3/categories endpoint or from business category lists (e.g., ‘restaurants’, ‘coffee’, ‘active’ for Active Life).
Output
Get Event Details
Get Event Details
Slug:
YELP_GET_EVENTGet details of a Yelp event by its event ID, including dates, location, cost, attendance counts and, when available, the associated business ID.Instant: Supported on the latest version.Instant pricing: Estimated $0.021 per successful API callInput Parameters
Locale for the event details in the format of {language_code}_{country_code}. See Yelp’s list of supported locales. Defaults to en_US.
Unique identifier for the event. Event IDs can be obtained from YELP_SEARCH_EVENTS or YELP_GET_EVENTS_FEATURED actions.
Output
Get Featured Event
Get Featured Event
Slug:
YELP_GET_FEATURED_EVENTGet the featured event for a given location on Yelp. Featured events are chosen by Yelp’s community managers and represent notable happenings in the specified area. Use this action when you need to discover the highlighted or recommended event for a specific city, region, or coordinates. The returned event_site_url is the Yelp event page, not the event’s own external website. Response fields such as business_id, cost, and tickets_url may be null; handle missing values explicitly.Instant: Supported on the latest version.Instant pricing: Estimated $0.021 per successful API callInput Parameters
Latitude coordinate for the location. Must be provided with longitude. Provide EITHER ‘location’ OR both ‘latitude’ and ‘longitude’, not both. If both are provided, coordinates take precedence.
Location to get featured event for. Can be an address, city, state, or zip code. Provide EITHER ‘location’ OR both ‘latitude’ and ‘longitude’, not both. If coordinates are also provided, coordinates will be used instead of location.
Longitude coordinate for the location. Must be provided with latitude. Provide EITHER ‘location’ OR both ‘latitude’ and ‘longitude’, not both. If both are provided, coordinates take precedence.
Output
Get Review Highlights
Get Review Highlights
Slug:
YELP_GET_REVIEW_HIGHLIGHTSGet review highlights for a specific business on Yelp using its business ID or alias. Returns summarized key points and themes from customer reviews. IMPORTANT: This endpoint requires Yelp Places API Premium Plan access. Without Premium Plan, requests will return a 403 NOT_AUTHORIZED error. For basic review access, consider using the Get Business Reviews action instead, which is available on Enhanced and Premium plans. Note: Get Business Reviews returns at most 3 recent reviews per call, while this action synthesizes themes across the full review history.Input Parameters
Yelp business ID or alias. Use the ‘id’ or ‘alias’ field from Search Businesses or Get Business Details response. Examples: unique ID like ‘WavvLdfdP6g8aZTtbBQHTw’ or alias like ‘north-india-restaurant-san-francisco’.
Output
List Categories
List Categories
Slug:
YELP_LIST_CATEGORIESList all Yelp business categories across all locales by default. Returns category aliases, titles, parent relationships, and geographic availability. Use this action when you need to discover valid category aliases for filtering business searches or when building category-based navigation. The locale parameter allows filtering to categories available in specific regions while translating category names to the local language.Instant: Supported on the latest version.Instant pricing: Estimated $0.021 per successful API callInput Parameters
Locale for filtering and translating category names. Filters to only categories available in the specified locale while translating category titles. Defaults to returning all categories across all locales in English.
Output
Search and Chat
Search and Chat
Slug:
YELP_SEARCH_AND_CHATChat with Yelp’s AI assistant to search for businesses, get recommendations, and ask questions. A chat ID can continue a conversation; responses may include a natural language answer and business data such as ratings, review counts, locations, and attributes.Input Parameters
Natural language query to ask Yelp’s AI assistant. Can be questions about finding businesses (e.g., ‘best sushi in Manhattan’), details about specific businesses (e.g., ‘what are the hours for Purple Pig Chicago’), or follow-up questions in an ongoing conversation.
Optional chat session ID returned from a previous request. Pass this to continue a conversation and maintain context across multiple queries. If not provided, starts a new conversation.
Output
Search Businesses
Search Businesses
Slug:
YELP_SEARCH_BUSINESSESSearch Yelp businesses by location, term, categories and other filters, with up to 50 results per call and offset pagination. Results may extend beyond the specified area and exclude businesses without reviews; location-not-found errors are returned as empty results with an explanatory message.Instant: Supported on the latest version.Instant pricing: Estimated $0.021 per successful API callInput Parameters
Search term (e.g. food, restaurants, bars, etc.). If not provided, will search for all businesses.
Price filter: 1 = $, 2 = $$, 3 = $$$, 4 = $$$$. Comma-separated for multiple. Must use numeric strings only (e.g., ‘1,2’) — currency symbols or words silently fail. Note: the price field may be absent from some results; guard against missing values to avoid dropping valid businesses.
Offset for pagination. Used to get more results beyond the limit. Hard cap around offset 1000; stop paginating when a page returns fewer items than requested.
Search radius in meters. Maximum is 40000 meters (25 miles). The distance field in results is also in meters and must be converted for display.
Latitude coordinate for search location. Must be provided with longitude. Use coordinates instead of location names for regions where name-based search returns LOCATION_NOT_FOUND (e.g., South Africa, most of Africa). Note: unsupported regions may have no business data even with valid coordinates. Provide EITHER ‘location’ OR both ‘latitude’ and ‘longitude’, not both. If both are provided, coordinates take precedence.
Location to search for businesses. Can be an address, city, state, or zip code. Yelp operates in 32 countries including US, Canada, UK, Australia, Japan, and most of Europe. Countries NOT supported include India, China, South Africa, most of Africa, and parts of Asia - searches in unsupported regions will return LOCATION_NOT_FOUND errors for city names. Use coordinates (latitude/longitude) for unsupported regions, though business data may be unavailable. Provide EITHER ‘location’ OR both ‘latitude’ and ‘longitude’, not both. If coordinates are also provided, coordinates will be used instead of location.
Longitude coordinate for search location. Must be provided with latitude. Use coordinates instead of location names for regions where name-based search returns LOCATION_NOT_FOUND (e.g., South Africa, most of Africa). Note: unsupported regions may have no business data even with valid coordinates. Provide EITHER ‘location’ OR both ‘latitude’ and ‘longitude’, not both. If both are provided, coordinates take precedence.
Output
Search Business by Phone
Search Business by Phone
Slug:
YELP_SEARCH_BY_PHONESearch for a business by phone number on Yelp. Returns business data including business_id, required by YELP_GET_BUSINESS_DETAILS, YELP_GET_BUSINESS_REVIEWS, and YELP_GET_REVIEW_HIGHLIGHTS. Empty results are inconclusive due to incomplete Yelp coverage.Instant: Supported on the latest version.Instant pricing: Estimated $0.021 per successful API callInput Parameters
Phone number to search for in E.164 format. Must include country code (e.g., +1 for US, +44 for UK). Example: +14159083801 for a US number.
Output
Search Events
Search Events
Slug:
YELP_SEARCH_EVENTSSearch for events on Yelp by location, categories, and other filters. Returns events happening in the specified area with details like time, cost, and attendance. Use this action when you need to find local events, activities, or happenings in a specific geographic area. Events can be filtered by category (music, food, sports), cost (free or paid), and time range. Results are sorted by popularity or start time and can be paginated using limit and offset parameters.Instant: Supported on the latest version.Instant pricing: Estimated $0.021 per successful API callInput Parameters
Locale code in the format of {language code}_{country code}. See the list of supported locales.
Search radius in meters. Maximum is 40000 meters (about 25 miles). If the value is too large, an AREA_TOO_LARGE error may be returned.
Filter whether the events are free to attend. By default no filter is applied so both free and paid events will be returned.
Required if location is not provided. Latitude of the location to search from. If latitude is provided, longitude is required too.
Required if either latitude or longitude is not provided. Geographic area for searching events. Examples: ‘New York City’, ‘NYC’, ‘350 5th Ave, New York, NY 10118’. Events returned may not be strictly within the specified location.
Required if location is not provided. Longitude of the location to search from. If longitude is provided, latitude is required too.
List of event ids. Events associated with these event ids in this list will not show up in the response.