Current Capabilities & Limitations
This page outlines what is currently supported by the Yelp Fusion AI API, and functionalities that are not currently supported.
Overview
What is supported today?
- Business searches with contextual search summaries (e.g. “Popular Mexican restaurants in Orange County, LA that are reasonably priced”)
- Business questions & answers (e.g. “What are the popular dishes at the above restaurants?”)
- Business one-shot questions & answers (e.g. "Does Capital Grille in Costa Mesa, CA offer vegan options?")
- Business comparisons (e.g., “Compare Red King and Original King ramen dishes at Ramen Nagi in Palo Alto”)
- Business overviews, and short, medium and long form AI summaries (e.g. "Tell me about Gary Danko in SF")
- Making restaurant reservations (e.g., "I’d like a reservation for four at Chubby Cattle in Chicago this Friday at 8pm")
What is not yet supported?
- Updating or canceling restaurant reservations and signing up for waitlists
- Requesting quotes from Services professionals
- Providing turn-by-turn directions
- Other advanced or specialized tasks outside the business domain
Business search with contextual search summaries
The Yelp Fusion AI API can search and recommend businesses based on user context such as location, category, and preferences.
Example Request
POST https://api.yelp.com/ai/chat/v2
Authorization: Bearer <Your API Key>
Content-Type: application/json
{
"query": "Popular Mexican restaurants in Orange County, LA that are reasonably priced",
"user_context": {
"locale": "en_US",
"latitude": 33.7175,
"longitude": -117.8311
}
}
Example Response
{
"response": {
"text": "Here are some popular Mexican restaurants in Orange County offering delicious and affordable dishes."
},
"types": [
"business_search"
],
"entities": [
{
"businesses": [
{
"id": "BkqfTBF3WgZzcE-zAyBUBg",
"alias": "gonzalezs-restaurant-orange-2",
"name": "Gonzalez's Restaurant",
"url": "https://www.yelp.com/biz/gonzalezs-restaurant-orange-2?adjust_creative=ozhuoStXlSnOIK1pCpdsmg&utm_campaign=yelp_api_v3&utm_medium=api_v3_public_ai_api_chat_v2&utm_source=ozhuoStXlSnOIK1pCpdsmg",
"location": {
"address1": "1740 W Chapman Ave",
"address2": null,
"address3": null,
"city": "Orange",
"zip_code": null,
"state": "CA",
"country": "US",
"formatted_address": "1740 W Chapman Ave\nOrange, CA 92868"
},
"coordinates": {
"latitude": 33.7874,
"longitude": -117.87165
},
"review_count": 738,
"price": "$$",
"rating": 4.6,
"categories": [
{
"alias": "mexican",
"title": "Mexican"
}
],
"attributes": {
"BusinessAcceptsAndroidPay": true,
"BusinessAcceptsApplePay": true,
"GenderNeutralRestrooms": true,
"BusinessUrl": "",
"AboutThisBizBioPhotoDict": null,
"AboutThisBizBusinessRecommendation": [],
"BusinessAddressAlternate": null,
"BusinessCategorySic": null,
"BusinessMovedFrom": null,
"BusinessNameAlternate": null,
"BusinessOpeningDate": null,
"BusinessTempClosed": null,
"GroupName": null,
"StoreCode": null,
"AboutThisBizBio": "Ricardo Gonzalez is the business owner of Gonzalez's Restaurant. Approximately 8 years ago Ricardo started as a Taco catering and build his way up to owning his first Mexican Restaurant in the city of Orange.",
"AboutThisBizBioFirstName": "Ricardo",
"AboutThisBizBioLastName": "G",
"AboutThisBizHistory": "Gonzalez's restaraunt just opened on Sunday July 9th, 2017.",
"AboutThisBizRole": "Business Owner",
"AboutThisBizSpecialties": null,
"AboutThisBizYearEstablished": "2017",
"Alcohol": "beer_and_wine",
"Ambience": {
"divey": null,
"hipster": false,
"casual": true,
"touristy": false,
"trendy": null,
"intimate": null,
"romantic": false,
"classy": false,
"upscale": false
},
"BikeParking": false,
"BusinessAcceptsBitcoin": false,
"BusinessAcceptsCreditCards": true,
"BusinessDisplayUrl": null,
"BusinessMovedTo": null,
"BusinessParking": {
"garage": false,
"street": false,
"validated": false,
"lot": true,
"valet": false
},
"BYOB": false,
"BYOBCorkage": null,
"Caters": true,
"Corkage": true,
"DogsAllowed": false,
"DriveThru": false,
"FlowerDelivery": null,
"GoodForKids": true,
"GoodForMeal": {
"dessert": null,
"latenight": false,
"lunch": true,
"dinner": true,
"brunch": true,
"breakfast": true
},
"HappyHour": false,
"HasTV": true,
"MenuUrl": null,
"NationalProviderIdentifier": null,
"NoiseLevel": "average",
"OffersMilitaryDiscount": null,
"OngoingVigilanteEvent": null,
"OnlineReservations": null,
"Open24Hours": null,
"BusinessOpenToAll": null,
"PlatformDelivery": null,
"PokestopNearby": null,
"RestaurantsCounterService": null,
"RestaurantsDelivery": true,
"RestaurantsGoodForGroups": true,
"RestaurantsPriceRange": null,
"RestaurantsPriceRange2": 2,
"RestaurantsReservations": true,
"RestaurantsTableService": true,
"RestaurantsTakeOut": true,
"WaitlistReservation": null,
"WheelchairAccessible": false,
"WiFi": "free"
},
"phone": "+17146029620",
"summaries": {
"short": "Cozy diner with rich Mexican flavors featuring standout pambazo and mole dishes.",
"medium": "Authentic Mexican restaurant featuring a wide variety of traditional dishes, including menu highlights like the shrimp quesadilla and cochinita pibil burrito. The establishment offers generous portions and complimentary chips and salsa, with a menu that includes breakfast burritos and pambazo.",
"long": "Authentic Mexican restaurant featuring a wide variety of traditional dishes, including menu highlights like the shrimp quesadilla and cochinita pibil burrito. The establishment offers generous portions and complimentary chips and salsa, with a menu that includes breakfast burritos and pambazo. Known for its homemade corn tortillas and menudo, the restaurant creates a welcoming atmosphere with homemade vibes, making it a popular spot for both dine-in and takeout."
},
"contextual_info": {
"summary": "This cozy diner offers rich Mexican flavors with standout dishes like pambazo and mole. Known for its great prices and varied selection, it provides a hearty and flavorful dining experience. While not fancy, the welcoming atmosphere and delicious food make it a popular choice for those craving authentic Mexican cuisine, especially before an Angels game.",
"review_snippets": [],
"business_hours": [
{
"day_of_week": "Monday",
"business_hours": [],
"special_hours_applied": false
},
{
"day_of_week": "Tuesday",
"business_hours": [
{
"open_time": "2025-02-18 09:00:00",
"close_time": "2025-02-18 20:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Wednesday",
"business_hours": [
{
"open_time": "2025-02-19 09:00:00",
"close_time": "2025-02-19 20:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Thursday",
"business_hours": [
{
"open_time": "2025-02-20 09:00:00",
"close_time": "2025-02-20 20:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Friday",
"business_hours": [
{
"open_time": "2025-02-21 09:00:00",
"close_time": "2025-02-21 20:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Saturday",
"business_hours": [
{
"open_time": "2025-02-22 09:00:00",
"close_time": "2025-02-22 20:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Sunday",
"business_hours": [
{
"open_time": "2025-02-23 09:00:00",
"close_time": "2025-02-23 20:00:00"
}
],
"special_hours_applied": false
}
],
"photos": [
{
"original_url": "https://s3-media0.fl.yelpcdn.com/bphoto/nTgUwmwNHkVRSozzL2_clw/o.jpg"
},
{
"original_url": "https://s3-media0.fl.yelpcdn.com/bphoto/af-F5HXh-88zyZINAYQibw/o.jpg"
},
{
"original_url": "https://s3-media0.fl.yelpcdn.com/bphoto/-K6VfIL5N01YCACNDZacSQ/o.jpg"
}
],
"review_snippet": "When you want hearty, flavorful and well priced [[HIGHLIGHT]]mexican food[[ENDHIGHLIGHT]], this is the place to go, especially..."
}
},
{
"id": "f-Bn13OMe_xf_C7SS6z4Sw",
"alias": "mercado-gonzalez-costa-mesa-2",
"name": "Mercado Gonzalez",
"url": "https://www.yelp.com/biz/mercado-gonzalez-costa-mesa-2?adjust_creative=ozhuoStXlSnOIK1pCpdsmg&utm_campaign=yelp_api_v3&utm_medium=api_v3_public_ai_api_chat_v2&utm_source=ozhuoStXlSnOIK1pCpdsmg",
"location": {
"address1": "2300 Harbor Blvd",
"address2": null,
"address3": "",
"city": "Costa Mesa",
"zip_code": null,
"state": "CA",
"country": "US",
"formatted_address": "2300 Harbor Blvd\nCosta Mesa, CA 92626"
},
"coordinates": {
"latitude": 33.65687468084185,
"longitude": -117.91720274890014
},
"review_count": 731,
"price": "$$",
"rating": 4.3,
"categories": [
{
"alias": "mexican",
"title": "Mexican"
},
{
"alias": "bakeries",
"title": "Bakeries"
},
{
"alias": "intlgrocery",
"title": "International Grocery"
}
],
"attributes": {
"BusinessUrl": "https://www.northgatemarket.com/mercado",
"AboutThisBizBioPhotoDict": null,
"AboutThisBizBusinessRecommendation": [],
"BusinessAddressAlternate": null,
"BusinessCategorySic": null,
"BusinessMovedFrom": null,
"BusinessNameAlternate": null,
"BusinessOpeningDate": null,
"BusinessTempClosed": null,
"GroupName": null,
"StoreCode": null,
"AboutThisBizBio": null,
"AboutThisBizBioFirstName": null,
"AboutThisBizBioLastName": null,
"AboutThisBizHistory": null,
"AboutThisBizRole": null,
"AboutThisBizSpecialties": null,
"AboutThisBizYearEstablished": null,
"Alcohol": null,
"Ambience": null,
"BikeParking": null,
"BusinessAcceptsAndroidPay": null,
"BusinessAcceptsApplePay": null,
"BusinessAcceptsBitcoin": null,
"BusinessAcceptsCreditCards": null,
"BusinessDisplayUrl": "http://www.northgatemarket.com",
"BusinessMovedTo": null,
"BusinessParking": {
"valet": true,
"garage": false,
"street": null,
"lot": null,
"validated": false
},
"BYOB": null,
"BYOBCorkage": null,
"Caters": true,
"Corkage": null,
"DogsAllowed": true,
"FlowerDelivery": null,
"GenderNeutralRestrooms": null,
"GoodForKids": null,
"GoodForMeal": null,
"HappyHour": true,
"HasTV": null,
"MenuUrl": null,
"NationalProviderIdentifier": null,
"NoiseLevel": null,
"OffersCannabisProducts": null,
"OffersMilitaryDiscount": null,
"OngoingVigilanteEvent": null,
"OnlineReservations": null,
"Open24Hours": null,
"BusinessOpenToAll": null,
"PlatformDelivery": null,
"PokestopNearby": null,
"RestaurantsCounterService": null,
"RestaurantsDelivery": null,
"RestaurantsGoodForGroups": null,
"RestaurantsPriceRange": null,
"RestaurantsPriceRange2": 2,
"RestaurantsReservations": null,
"RestaurantsTableService": null,
"RestaurantsTakeOut": null,
"WaitlistReservation": null,
"WheelchairAccessible": null,
"WiFi": null
},
"phone": "+19493733109",
"summaries": {
"short": "Lively Mexican market with fresh tortillas and churros in a vibrant food court.",
"medium": "Vibrant market combining Mexican cultural elements and culinary offerings. The establishment features a diverse array of food stalls, including tacos, tamales, ceviche, and churros, alongside a full bar. It contributes to a dynamic environment with live music and cultural events.",
"long": "Vibrant market combining Mexican cultural elements and culinary offerings. The establishment features a diverse array of food stalls, including tacos, tamales, ceviche, and churros, alongside a full bar. It contributes to a dynamic environment with live music and cultural events. The market offers fresh produce, handmade tortillas, and a wide selection of salsas and guacamole, while also promoting local artistic talent through displays of artisanal crafts."
},
"contextual_info": {
"summary": "This lively Mexican market offers a vibrant food court experience with fresh tortillas and churros. Known for its wide variety of authentic Mexican foods like tacos, tamales, and ceviche, it provides a unique blend of grocery shopping and dining. With a clean and organized space, friendly staff, and even a selection of Tijuana craft beers and tequila, it's a popular spot for both food lovers and those seeking authentic Mexican ingredients.",
"review_snippets": [],
"business_hours": [
{
"day_of_week": "Monday",
"business_hours": [
{
"open_time": "2025-02-17 06:00:00",
"close_time": "2025-02-17 22:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Tuesday",
"business_hours": [
{
"open_time": "2025-02-18 06:00:00",
"close_time": "2025-02-18 22:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Wednesday",
"business_hours": [
{
"open_time": "2025-02-19 06:00:00",
"close_time": "2025-02-19 22:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Thursday",
"business_hours": [
{
"open_time": "2025-02-20 06:00:00",
"close_time": "2025-02-20 22:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Friday",
"business_hours": [
{
"open_time": "2025-02-21 06:00:00",
"close_time": "2025-02-21 23:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Saturday",
"business_hours": [
{
"open_time": "2025-02-22 06:00:00",
"close_time": "2025-02-22 23:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Sunday",
"business_hours": [
{
"open_time": "2025-02-23 06:00:00",
"close_time": "2025-02-23 22:00:00"
}
],
"special_hours_applied": false
}
],
"photos": [
{
"original_url": "https://s3-media0.fl.yelpcdn.com/bphoto/cSMZMhRm7v4_v0v2NwUmyg/o.jpg"
},
{
"original_url": "https://s3-media0.fl.yelpcdn.com/bphoto/Sc1dKu05o4J6C2lRiw3k2g/o.jpg"
},
{
"original_url": "https://s3-media0.fl.yelpcdn.com/bphoto/UScPXMQq-8-VGWtybPetEw/o.jpg"
}
],
"review_snippet": "I love to cook and make authentic [[HIGHLIGHT]]Mexican food[[ENDHIGHLIGHT]] when I'm craving Mexican food and I always go to..."
}
},
{
"id": "wJ03NpXyIxoEeFktBRbcCQ",
"alias": "el-toro-bravo-tortilleria-costa-mesa",
"name": "El Toro Bravo Tortilleria",
"url": "https://www.yelp.com/biz/el-toro-bravo-tortilleria-costa-mesa?adjust_creative=ozhuoStXlSnOIK1pCpdsmg&utm_campaign=yelp_api_v3&utm_medium=api_v3_public_ai_api_chat_v2&utm_source=ozhuoStXlSnOIK1pCpdsmg",
"location": {
"address1": "745 W 19th St",
"address2": "Ste H",
"address3": "",
"city": "Costa Mesa",
"zip_code": null,
"state": "CA",
"country": "US",
"formatted_address": "745 W 19th St\nSte H\nCosta Mesa, CA 92627"
},
"coordinates": {
"latitude": 33.642739875870774,
"longitude": -117.92951384345116
},
"review_count": 1123,
"price": "$",
"rating": 4.2,
"categories": [
{
"alias": "mexican",
"title": "Mexican"
}
],
"attributes": {
"BusinessAcceptsAndroidPay": false,
"BusinessAcceptsApplePay": false,
"BusinessOpenToAll": true,
"BusinessUrl": "https://eltorobravo.net",
"AboutThisBizBioPhotoDict": {
"photo_id": 3505957,
"biz_user_id": null
},
"AboutThisBizBusinessRecommendation": [],
"BusinessAddressAlternate": null,
"BusinessCategorySic": null,
"BusinessMovedFrom": null,
"BusinessNameAlternate": null,
"BusinessOpeningDate": null,
"BusinessTempClosed": null,
"GroupName": null,
"StoreCode": null,
"AboutThisBizBio": "The business is family owned and operated since 1979. Authentic family recipes from the Zacatecas region of Mexico. Patty has worked in and managed various restaurants for over 30 years.",
"AboutThisBizBioFirstName": "Patty",
"AboutThisBizBioLastName": "B",
"AboutThisBizHistory": "El Toro Bravo is family owned and operated. El Toro was the very first Tortilla factory in Costa Mesa. \n\nEl Toro Bravo fue la primera tortilleria en abrir sus puertas de la ciudad de Costa Mesa.",
"AboutThisBizRole": "Manager",
"AboutThisBizSpecialties": "El Toro Bravo Tortileria provides a large range of mexican fare that is cooked fresh daily. Popular items include: Carnitas, Carne Asada, Pollo Asado, Lengua, Buche, Chicharron, and more that can be made into tacos, burritos, or nachos. All meats are also available cooked by the pound. Additional items include enchiladas, tamales, and whole chickens. Tortillas & chips are made fresh on-site every morning. Stop by and give us a try!",
"AboutThisBizYearEstablished": "1979",
"Alcohol": "none",
"Ambience": {
"divey": null,
"hipster": false,
"casual": null,
"touristy": false,
"trendy": false,
"intimate": false,
"romantic": false,
"classy": false,
"upscale": false
},
"BikeParking": true,
"BusinessAcceptsBitcoin": false,
"BusinessAcceptsCreditCards": true,
"BusinessDisplayUrl": null,
"BusinessMovedTo": null,
"BusinessParking": {
"garage": false,
"street": true,
"validated": false,
"lot": true,
"valet": false
},
"BYOB": false,
"BYOBCorkage": "yes_free",
"Caters": true,
"Corkage": false,
"DogsAllowed": null,
"DriveThru": false,
"FlowerDelivery": null,
"GenderNeutralRestrooms": null,
"GoodForKids": true,
"GoodForMeal": {
"dessert": false,
"latenight": false,
"lunch": true,
"dinner": true,
"brunch": false,
"breakfast": false
},
"HappyHour": false,
"HasTV": false,
"MenuUrl": "",
"NationalProviderIdentifier": null,
"NoiseLevel": "average",
"OffersMilitaryDiscount": null,
"OngoingVigilanteEvent": null,
"OnlineReservations": null,
"Open24Hours": null,
"PlatformDelivery": null,
"PokestopNearby": null,
"RestaurantsCounterService": null,
"RestaurantsDelivery": false,
"RestaurantsGoodForGroups": true,
"RestaurantsPriceRange": null,
"RestaurantsPriceRange2": 1,
"RestaurantsReservations": false,
"RestaurantsTableService": false,
"RestaurantsTakeOut": true,
"WaitlistReservation": null,
"WheelchairAccessible": true,
"WiFi": "no"
},
"phone": "+19496314464",
"summaries": {
"short": "Mexican takeout with handmade tortillas and generous carne asada burritos.",
"medium": "Authentic Mexican tortilleria offering a wide range of freshly prepared dishes since 1979. Specialties include carnitas, carne asada, pollo asado, and lengua, available in tacos, burritos, or by the pound. Fresh tortillas and chips are made on-site daily, enhancing the flavor of their offerings.",
"long": "Authentic Mexican tortilleria offering a wide range of freshly prepared dishes since 1979. Specialties include carnitas, carne asada, pollo asado, and lengua, available in tacos, burritos, or by the pound. Fresh tortillas and chips are made on-site daily, enhancing the flavor of their offerings. Known for generous portions and a variety of catering options, this family-owned establishment is a staple in Costa Mesa's culinary scene."
},
"contextual_info": {
"summary": "This popular Mexican spot is known for its handmade tortillas and generous carne asada burritos, offering a taste of authentic Mexican cuisine. With a reputation for flavorful dishes like chicharrones and carnitas, it stands out as a favorite for those seeking real, homemade flavors. The large portions make it a satisfying choice, though the tacos are notably hefty. It's a go-to place for Mexican food lovers in Orange County.",
"review_snippets": [],
"business_hours": [
{
"day_of_week": "Monday",
"business_hours": [
{
"open_time": "2025-02-17 07:00:00",
"close_time": "2025-02-17 21:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Tuesday",
"business_hours": [
{
"open_time": "2025-02-18 07:00:00",
"close_time": "2025-02-18 21:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Wednesday",
"business_hours": [
{
"open_time": "2025-02-19 07:00:00",
"close_time": "2025-02-19 21:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Thursday",
"business_hours": [
{
"open_time": "2025-02-20 07:00:00",
"close_time": "2025-02-20 21:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Friday",
"business_hours": [
{
"open_time": "2025-02-21 07:00:00",
"close_time": "2025-02-21 21:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Saturday",
"business_hours": [
{
"open_time": "2025-02-22 07:00:00",
"close_time": "2025-02-22 21:00:00"
}
],
"special_hours_applied": false
},
{
"day_of_week": "Sunday",
"business_hours": [
{
"open_time": "2025-02-23 07:00:00",
"close_time": "2025-02-23 21:00:00"
}
],
"special_hours_applied": false
}
],
"photos": [
{
"original_url": "https://s3-media0.fl.yelpcdn.com/bphoto/b5M4qrhIEMnMKcMgPhJy6Q/o.jpg"
},
{
"original_url": "https://s3-media0.fl.yelpcdn.com/bphoto/kxox3oGxkRBRC4m14l7eOA/o.jpg"
},
{
"original_url": "https://s3-media0.fl.yelpcdn.com/bphoto/-QRHiOmzcVRW32OGjGPRRg/o.jpg"
}
],
"review_snippet": "If you think SD has better [[HIGHLIGHT]]Mexican food[[ENDHIGHLIGHT]] than LA, enjoy your California Burrito at Albatross."
}
}
]
}
],
"chat_id": "qs_MyS18PQJms3p5xdeVpQ"
}
Relevant Fields
- response.text: General textual answer to the user’s query.
- types: Indicates the type of response (e.g., "business_search").
- entities.businesses[]: Array of businesses matching the query. Within each business, the following fields are particularly relevant.
- id: Unique identifier for the business, useful for referencing details or linking to more info.
- name: The restaurant’s name, directly answering the user’s request for specific Mexican restaurants.
- url: A link to the business’s full listing, providing further information.
- location: Address and city (e.g., Orange, Costa Mesa), confirming the business is in Orange County.
- coordinates: Latitude and longitude of the restaurant, confirming proximity to the requested area.
- review_count: Number of reviews, indicating popularity.
- price: Signifies how expensive the restaurant is (“$” or “$$”), helpful for determining if it is “reasonably priced.”
- rating: User rating (e.g., 4.6), addressing “popular” or well-reviewed businesses.
- categories: Includes "mexican" in the category alias or title, confirming the cuisine type.
- summaries / contextual_info_summary: Provides a concise overview of the restaurant and whether it meets the user’s needs (e.g., authenticity, price, specialties).
- chat_id: The identifier for the user’s chat session
Business questions & answers
You can also ask general or specific questions regarding businesses. The AI will reference previously returned businesses in the same conversation context (i.e., same chat_id).
Example Request
POST https://api.yelp.com/ai/chat/v2
Authorization: Bearer <Your API Key>
Content-Type: application/json
{
"query": "What are the popular dishes at the above restaurants?",
"chat_id": "123",
"user_context": {
"locale": "en_US",
"latitude": null,
"longitude": null
}
}
Example Response
{
"response": {
"text": "At [[HIGHLIGHT]]Gonzalez's Restaurant[[ENDHIGHLIGHT]], popular dishes include the [[HIGHLIGHT]]chicken mole enchiladas[[ENDHIGHLIGHT]], [[HIGHLIGHT]]Carne Asada tacos[[ENDHIGHLIGHT]], and the Cochinita Pibil tacos. The restaurant is also known for its pambazo and mole dishes. At [[HIGHLIGHT]]El Toro Bravo Tortilleria[[ENDHIGHLIGHT]], the [[HIGHLIGHT]]carne asada[[ENDHIGHLIGHT]] and [[HIGHLIGHT]]carnitas[[ENDHIGHLIGHT]] are favorites, with fresh tortillas made daily."
},
"types": [
"business_question"
],
"entities": [
{
"businesses": [
{
"id": "BkqfTBF3WgZzcE-zAyBUBg",
"alias": "gonzalezs-restaurant-orange-2",
"name": "Gonzalez's Restaurant",
"url": "https://www.yelp.com/biz/gonzalezs-restaurant-orange-2?adjust_creative=ozhuoStXlSnOIK1pCpdsmg&utm_campaign=yelp_api_v3&utm_medium=api_v3_public_ai_api_chat_v2&utm_source=ozhuoStXlSnOIK1pCpdsmg",
"location": {
"address1": "1740 W Chapman Ave",
"address2": null,
"address3": null,
"city": "Orange",
"zip_code": null,
"state": "CA",
"country": "US",
"formatted_address": "1740 W Chapman Ave\nOrange, CA 92868"
},
"coordinates": null,
"review_count": 738,
"price": "$$",
"rating": 4.6,
"categories": [
{
"alias": "mexican",
"title": "Mexican"
}
],
"attributes": {},
"phone": "+17146029620",
"summaries": {
"short": "Cozy diner with rich Mexican flavors featuring standout pambazo and mole dishes.",
"medium": "Authentic Mexican restaurant featuring a wide variety of traditional dishes, including menu highlights like the shrimp quesadilla and cochinita pibil burrito. The establishment offers generous portions and complimentary chips and salsa, with a menu that includes breakfast burritos and pambazo.",
"long": "Authentic Mexican restaurant featuring a wide variety of traditional dishes, including menu highlights like the shrimp quesadilla and cochinita pibil burrito. The establishment offers generous portions and complimentary chips and salsa, with a menu that includes breakfast burritos and pambazo. Known for its homemade corn tortillas and menudo, the restaurant creates a welcoming atmosphere with homemade vibes, making it a popular spot for both dine-in and takeout."
},
"contextual_info": {
"summary": null,
"review_snippets": [
{
"review_id": "v_qsLZbuwIN7U_fH4twhBw",
"comment": "This is a great place to come eat some authentic Mexican food. Overall experience was good. Service was prompt and friendly. Server was able to go over the menu and point on the [[HIGHLIGHT]]signature dishes[[ENDHIGHLIGHT]]. As far as the dish is concerned I ordered the chicken mole enchiladas which were great tasting. Could have used a slightly more chicken but overall great flavor. ",
"rating": 4
},
{
"review_id": "Zlwfs2tCAyZqO0mFnXABDg",
"comment": "I think it was dark meat, and again, not bad, just ok. The portion size was decent for a 'street taco' Carne Asada tacos: 4.5 stars. Definitely the [[HIGHLIGHT]]specialty[[ENDHIGHLIGHT]] of the restaurant. The Carne Asada had an unique flavor with the seasonings, and we all devoured them promptly. The seasoning wasn't too spicy, and the portion was great. ",
"rating": 4
},
{
"review_id": "8ESg_BDTBmakWmuEvXAU9Q",
"comment": "The service was great. Very friendly staff. The mole is shipped from Puebla Mexico. If you want authentic Mexican food, you [[HIGHLIGHT]]must try[[ENDHIGHLIGHT]] this place. A [[HIGHLIGHT]]must try[[ENDHIGHLIGHT]] are the Conchinita Pibil tacos (the [[HIGHLIGHT]]best[[ENDHIGHLIGHT]])!!!!!",
"rating": 5
}
],
"business_hours": [],
"photos": [],
"review_snippet": null
}
},
{
"id": "f-Bn13OMe_xf_C7SS6z4Sw",
"alias": "mercado-gonzalez-costa-mesa-2",
"name": "Mercado Gonzalez",
"url": "https://www.yelp.com/biz/mercado-gonzalez-costa-mesa-2?adjust_creative=ozhuoStXlSnOIK1pCpdsmg&utm_campaign=yelp_api_v3&utm_medium=api_v3_public_ai_api_chat_v2&utm_source=ozhuoStXlSnOIK1pCpdsmg",
"location": {
"address1": "2300 Harbor Blvd",
"address2": null,
"address3": "",
"city": "Costa Mesa",
"zip_code": null,
"state": "CA",
"country": "US",
"formatted_address": "2300 Harbor Blvd\nCosta Mesa, CA 92626"
},
"coordinates": null,
"review_count": 732,
"price": "$$",
"rating": 4.3,
"categories": [
{
"alias": "mexican",
"title": "Mexican"
},
{
"alias": "bakeries",
"title": "Bakeries"
},
{
"alias": "intlgrocery",
"title": "International Grocery"
}
],
"attributes": {},
"phone": "+19493733109",
"summaries": {
"short": "Lively Mexican market with fresh tortillas and churros in a vibrant food court.",
"medium": "Vibrant market combining Mexican cultural elements and culinary offerings. The establishment features a diverse array of food stalls, including tacos, tamales, ceviche, and churros, alongside a full bar. It contributes to a dynamic environment with live music and cultural events.",
"long": "Vibrant market combining Mexican cultural elements and culinary offerings. The establishment features a diverse array of food stalls, including tacos, tamales, ceviche, and churros, alongside a full bar. It contributes to a dynamic environment with live music and cultural events. The market offers fresh produce, handmade tortillas, and a wide selection of salsas and guacamole, while also promoting local artistic talent through displays of artisanal crafts."
},
"contextual_info": {
"summary": null,
"review_snippets": [],
"business_hours": [],
"photos": [],
"review_snippet": null
}
},
{
"id": "wJ03NpXyIxoEeFktBRbcCQ",
"alias": "el-toro-bravo-tortilleria-costa-mesa",
"name": "El Toro Bravo Tortilleria",
"url": "https://www.yelp.com/biz/el-toro-bravo-tortilleria-costa-mesa?adjust_creative=ozhuoStXlSnOIK1pCpdsmg&utm_campaign=yelp_api_v3&utm_medium=api_v3_public_ai_api_chat_v2&utm_source=ozhuoStXlSnOIK1pCpdsmg",
"location": {
"address1": "745 W 19th St",
"address2": "Ste H",
"address3": "",
"city": "Costa Mesa",
"zip_code": null,
"state": "CA",
"country": "US",
"formatted_address": "745 W 19th St\nSte H\nCosta Mesa, CA 92627"
},
"coordinates": null,
"review_count": 1123,
"price": "$",
"rating": 4.2,
"categories": [
{
"alias": "mexican",
"title": "Mexican"
}
],
"attributes": {},
"phone": "+19496314464",
"summaries": {
"short": "Mexican takeout with handmade tortillas and generous carne asada burritos.",
"medium": "Authentic Mexican tortilleria offering a wide range of freshly prepared dishes since 1979. Specialties include carnitas, carne asada, pollo asado, and lengua, available in tacos, burritos, or by the pound. Fresh tortillas and chips are made on-site daily, enhancing the flavor of their offerings.",
"long": "Authentic Mexican tortilleria offering a wide range of freshly prepared dishes since 1979. Specialties include carnitas, carne asada, pollo asado, and lengua, available in tacos, burritos, or by the pound. Fresh tortillas and chips are made on-site daily, enhancing the flavor of their offerings. Known for generous portions and a variety of catering options, this family-owned establishment is a staple in Costa Mesa's culinary scene."
},
"contextual_info": {
"summary": null,
"review_snippets": [
{
"review_id": "81HWu2_Mv5B7H8P46Xhy5A",
"comment": "fresh and ready to go u eat two tacos and your stuffed! a [[HIGHLIGHT]]must try[[ENDHIGHLIGHT]] if u are in costa mesa. I always get the carne asada and carnitas although they have wide varieties the two favorite there in if u are ever craving just a couple tamales they sell delicious ones once again this place is a [[HIGHLIGHT]]must try[[ENDHIGHLIGHT]]!",
"rating": 5
}
],
"business_hours": [],
"photos": [],
"review_snippet": null
}
}
]
}
],
"chat_id": "qs_MyS18PQJms3p5xdeVpQ"
}
Relevant Fields
- response.text: Directly provides the popular dishes at each restaurant.
- types: Indicates the type of response (e.g., "business_question").
- entities.businesses: Array of businesses being discussed. For each business, fields of interest for popular dishes.
- name: The name of the restaurant.
- summaries / contextual_info.review_snippets: May include direct mentions of popular dishes (e.g., chicken mole enchiladas, Carne Asada tacos).
- location: Relevant if the user wants to confirm the location of each restaurant tied to the dishes.
- chat_id: An identifier for the user's chat session
Business one-shot questions & answers
The business one-shot questions & answers capability enables users to ask a specific question about a business without having to do a prior business search. This eliminates the need for multiple API calls, making interactions more efficient.
Example Request
POST https://api.yelp.com/ai/chat/v2
Authorization: Bearer <Your API Key>
Content-Type: application/json
{
"query": "Does Capital Grille in Costa Mesa, CA offer vegan options?",
"user_context": {
"locale": "en_US"
}
}
Example Response
{
"response": {
"text": "[[HIGHLIGHT]]The Capital Grille[[ENDHIGHLIGHT]] offers [[HIGHLIGHT]]vegan options[[ENDHIGHLIGHT]]. Reviewers have noted the availability of vegan and vegetarian dishes, such as tofu plates and other plant-based items, ensuring there is something for everyone."
},
"types": ["business_question"],
"entities": [
{
"businesses": [
{
"id": "o_DuM5-WUH2V8QYTYtC7PA",
"alias": "the-capital-grille-costa-mesa-2",
"name": "The Capital Grille",
"url": "https://www.yelp.com/biz/the-capital-grille-costa-mesa-2",
"location": {
"address1": "3333 Bristol St",
"address2": "",
"address3": "",
"city": "Costa Mesa",
"zip_code": null,
"state": "CA",
"country": "US",
"formatted_address": "3333 Bristol St\nCosta Mesa, CA 92626"
},
"coordinates": null,
"review_count": 2448,
"price": "$$$",
"rating": 4.3,
"categories": [
{ "alias": "steak", "title": "Steakhouses" },
{ "alias": "seafood", "title": "Seafood" },
{ "alias": "wine_bars", "title": "Wine Bars" }
],
"attributes": {},
"phone": "+17144321140",
"summaries": {
"short": null,
"medium": null,
"long": null
},
"contextual_info": {
"summary": null,
"review_snippets": [
{
"review_id": "DiYLxDP9V3uYmnV-mfRH6g",
"comment": "There was a pianist who sang a few songs (...) including [[HIGHLIGHT]]vegan options[[ENDHIGHLIGHT]] for those who chose to live that way.",
"rating": 2
},
{
"review_id": "hQtKFIgyTNq4XpMZLa4qfg",
"comment": "Pros: everything, lighting, service (...) tofu plate for the [[HIGHLIGHT]]vegetarians[[ENDHIGHLIGHT]] in the mix.",
"rating": 5
},
{
"review_id": "l7i7F5yT14suia8UogwcNw",
"comment": "I would appreciate a more conversational approach to table service (...) my husband was [[HIGHLIGHT]]Vegan[[ENDHIGHLIGHT]].",
"rating": 4
}
],
"business_hours": [],
"photos": [],
"review_snippet": null
}
}
]
}
],
"chat_id": "qs_MyS18PQJms3p5xdeVpQ"
}
Relevant Fields:
- response.text
- types
- entities.businesses[]: Array of businesses mentioned in the response. Within each business, the following fields are most relevant to the user’s.
- id: Unique business identifier (e.g., "o_DuM5-WUH2V8QYTYtC7PA").
- name: The restaurant’s name (e.g., "The Capital Grille"), confirming we’re talking about the correct location.
- url: Link to the business’s full Yelp listing.
- location: The address details (e.g., "3333 Bristol St, Costa Mesa, CA"), confirming the user’s specified location.
- rating: Average user rating, providing insight into popularity or quality.
- categories: Shows primary cuisine type (Steakhouses, Seafood, etc.); useful when exploring vegan adaptability.
- contextual_info.review_snippets: Contains user feedback referencing vegan options, aligning with the user’s question about availability of vegan items.
- chat_id: The identifier for the user’s chat session
Business comparisons
Comparisons let you evaluate two or more businesses on specific dimensions, sometimes including ratings, pricing, or features.
Example Request
POST https://api.yelp.com/ai/chat/v2
Authorization: Bearer <Your API Key>
Content-Type: application/json
{
"query": "Compare Red King and Original King ramen dishes at Ramen Nagi in Palo Alto",
"chat_id": null,
"user_context": {
"locale": "en_US",
"latitude": null,
"longitude": null
}
}
Example Response
{
"response": {
"text": "The [[HIGHLIGHT]]Red King[[ENDHIGHLIGHT]] ramen at [[HIGHLIGHT]]Ramen Nagi[[ENDHIGHLIGHT]] is known for its [[HIGHLIGHT]]savory spiciness[[ENDHIGHLIGHT]], featuring a blend of garlic, chili oil, and cayenne pepper. It offers a more intense flavor compared to the [[HIGHLIGHT]]Original King[[ENDHIGHLIGHT]], which has a rich, creamy tonkotsu pork-broth. While the Red King is recommended for those who enjoy spicy dishes, the Original King is favored for its classic umami taste. Both dishes are highly customizable, allowing diners to adjust spice levels and other preferences."
},
"types": [
"business_question"
],
"entities": [
{
"businesses": [
{
"id": "vhfPni9pci29SEHrN1OtRg",
"alias": "ramen-nagi-palo-alto",
"name": "Ramen Nagi",
"url": "https://www.yelp.com/biz/ramen-nagi-palo-alto?adjust_creative=ozhuoStXlSnOIK1pCpdsmg&utm_campaign=yelp_api_v3&utm_medium=api_v3_public_ai_api_chat_v2&utm_source=ozhuoStXlSnOIK1pCpdsmg",
"location": {
"address1": "541 Bryant St",
"address2": "",
"address3": null,
"city": "Palo Alto",
"zip_code": null,
"state": "CA",
"country": "US",
"formatted_address": "541 Bryant St\nPalo Alto, CA 94301"
},
"coordinates": null,
"review_count": 3112,
"price": "$$",
"rating": 4.5,
"categories": [
{
"alias": "ramen",
"title": "Ramen"
},
{
"alias": "noodles",
"title": "Noodles"
}
],
"attributes": {},
"phone": "",
"summaries": {
"short": null,
"medium": null,
"long": null
},
"contextual_info": {
"summary": null,
"review_snippets": [
{
"review_id": "hxnZXvUdowWzaZttawF9vA",
"comment": "If it is, your server will introduce to you the different types of ramen they have and how you can order. They recommended for first time customers the Original King or the [[HIGHLIGHT]]Red King[[ENDHIGHLIGHT]]. The [[HIGHLIGHT]]Red King[[ENDHIGHLIGHT]] is basically like the Original King, but oil based. I really liked the ordering system because it reminds me so much of Japan. They give you a piece of paper where you can pick the type of ramen you want and your preferences for the strength of flavor, richness in oil, garlic, pork, vegetables, spice level, and types of noodles. ",
"rating": 5
},
{
"review_id": "iaJgxgNhbXCyfbnDyRcCFA",
"comment": "--------------------------------------------------------- Menu / Ramen Types: + [[HIGHLIGHT]]Original King[[ENDHIGHLIGHT]]: Luscious Signature Tonkotsu Pork-broth + Green [[HIGHLIGHT]]King[[ENDHIGHLIGHT]]: Nagi's Fusion of Gourmet Cultures A marriage of fresh basil and olive oil with delectable tonkatsu broth in a truly unique combination; lavishly garnished with grated parmesan cheese and richly marbled chashu + Red [[HIGHLIGHT]]King[[ENDHIGHLIGHT]]: The Ultimate in Savory Spiciness A striking blend of garlic, chili oil, and cayenne pepper in a velvety broth; topped by a tempting ball of miso-infused pork and select Nagi cayenne, with tender Cha-Shu. ",
"rating": 5
},
{
"review_id": "PE6MRoQoqJRGCVIvkS0O9w",
"comment": "Visited on a Saturday at 2:10 pm, and the wait was only 15 minutes. Wooo! Lucked out. My boyfriend and I tried the [[HIGHLIGHT]]Original King[[ENDHIGHLIGHT]] and the Red [[HIGHLIGHT]]King[[ENDHIGHLIGHT]]. I didn't like the Red [[HIGHLIGHT]]King[[ENDHIGHLIGHT]] at all and preferred my boyfriend's [[HIGHLIGHT]]Original King[[ENDHIGHLIGHT]] more. Red [[HIGHLIGHT]]King[[ENDHIGHLIGHT]] was very salty and oily, despite having ordered less salt. I couldn't drink the broth at all. ",
"rating": 5
}
],
"business_hours": [],
"photos": [],
"review_snippet": null
}
}
]
}
],
"chat_id": "qs_MyS18PQJms3p5xdeVpQ"
}
Relevant Fields
- response.text: Provides the direct comparison between the Red King and Original King ramen dishes.
- types: Indicates the type of response (e.g., "business_question").
- entities.businesses[]: Array of businesses referenced in the response. For each business, fields pertinent to the user’s query include.
- name: The name of the restaurant (“Ramen Nagi”), confirming where the dishes are served.
- contextual_info.review_snippets: User comments referencing both Red King and Original King ramen, offering additional insight into flavor differences and preferences.
- location: Helps confirm the business is located in Palo Alto as requested.
- chat_id: The identifier for the user’s chat session.
Business overviews, and short, medium and long form AI summaries
The Yelp Fusion AI API can generate structured business overviews, including short, medium, and long-form summaries. These summaries provide quick insights into a business, helping users understand key details without needing to sift through multiple reviews.
Example Request
POST https://api.yelp.com/ai/chat/v2
Authorization: Bearer <Your API Key>
Content-Type: application/json
{
"query": "Tell me about Gary Danko in SF",
"chat_id": null,
"user_context": {
"locale": "en_US",
"latitude": null,
"longitude": null
}
}
Example Response
{
"response": {
"text": "[[HIGHLIGHT]]Gary Danko[[ENDHIGHLIGHT]] is a Michelin-rated restaurant in San Francisco known for its [[HIGHLIGHT]]customizable tasting menus[[ENDHIGHLIGHT]] featuring a variety of courses like seafood, beef, and duck. The restaurant offers a [[HIGHLIGHT]]full bar[[ENDHIGHLIGHT]] and wine pairings, creating a classy and upscale dining experience. It is located near Fisherman's Wharf and is praised for its use of fresh, locally sourced ingredients and classic French cooking techniques."
},
"types": [
"business_question"
],
"entities": [
{
"businesses": [
{
"id": "WavvLdfdP6g8aZTtbBQHTw",
"alias": "gary-danko-san-francisco",
"name": "Gary Danko",
"url": "https://www.yelp.com/biz/gary-danko-san-francisco?adjust_creative=ozhuoStXlSnOIK1pCpdsmg&utm_campaign=yelp_api_v3&utm_medium=api_v3_public_ai_api_chat_v2&utm_source=ozhuoStXlSnOIK1pCpdsmg",
"location": {
"address1": "800 N Point St",
"address2": "",
"address3": "",
"city": "San Francisco",
"zip_code": null,
"state": "CA",
"country": "US",
"formatted_address": "800 N Point St\nSan Francisco, CA 94109"
},
"coordinates": null,
"review_count": 6044,
"price": "$$$$",
"rating": 4.5,
"categories": [
{
"alias": "newamerican",
"title": "New American"
},
{
"alias": "french",
"title": "French"
},
{
"alias": "wine_bars",
"title": "Wine Bars"
}
],
"attributes": {},
"phone": "+14157492060",
"summaries": {
"short": "Multi-course menus feature standout dishes like lobster risotto in a cozy atmosphere.",
"medium": "Michelin-rated restaurant offering distinctive dining options with customizable tasting menus. Guests can select from a variety of courses, including seafood, beef, and duck, with options for wine pairing. The restaurant features an inviting atmosphere adorned with orchids and vibrant artworks, located near San Francisco's Fisherman's Wharf.",
"long": "Michelin-rated restaurant offering distinctive dining options with customizable tasting menus. Guests can select from a variety of courses, including seafood, beef, and duck, with options for wine pairing. The restaurant features an inviting atmosphere adorned with orchids and vibrant artworks, located near San Francisco's Fisherman's Wharf. It utilizes fresh, locally sourced ingredients and classic French cooking techniques."
},
"contextual_info": {
"summary": null,
"review_snippets": [
{
"review_id": "MSxGRd5rAgrM_3esXQSUfA",
"comment": "I, on the other hand, would willingly give my meager teacher's paycheck for bites of lobster risotto, chocolate souffle, quail with fois grais, horseradish salmon . . . and that damn amazing cheese cart. Plus, getting goodies at the beginning and end always makes you feel special! [[HIGHLIGHT]]Ambiance[[ENDHIGHLIGHT]] and service oozed of decadence and class. My husband and I could tell we probably weren't in the same income bracket as anyone there, but no matter, everyone treated us like kings. ",
"rating": 5
},
{
"review_id": "moVx-d5Ul1XyrFCLQvXP8g",
"comment": "I want to start this review by admiring the ambiance Gary Danko has to offer. Upon entry, my guests and I were greeted by the hosts and seated promptly. Their [[HIGHLIGHT]]menu[[ENDHIGHLIGHT]] offers a [[HIGHLIGHT]]variety[[ENDHIGHLIGHT]] of [[HIGHLIGHT]]dishes[[ENDHIGHLIGHT]], 3+ course meals. The night of our dinner, Gary Danko was featuring the Truffle Tasting [[HIGHLIGHT]]menu[[ENDHIGHLIGHT]]. The options were endless! The truffled risotto with rock shrimp, dungeness crab, shimeji mushrooms and root vegetables was my favorite of the evening. ",
"rating": 4
},
{
"review_id": "yKZhzowZEthwMwwkimTg7Q",
"comment": "I can safely say that Gary Danko has flawless execution of service and delicious [[HIGHLIGHT]]variety[[ENDHIGHLIGHT]] of [[HIGHLIGHT]]dishes[[ENDHIGHLIGHT]] with high quality ingredients. This has been far one of my favorite meals in SF, Michelin or not. The full [[HIGHLIGHT]]menu[[ENDHIGHLIGHT]] is divided into five sections: appetizers, seafood, meats, cheese, and desserts. You have the option of choosing 3, 4, or 5 courses ($97, $120, $143 respectively). ",
"rating": 5
}
],
"business_hours": [],
"photos": [],
"review_snippet": null
}
}
]
}
],
"chat_id": "9jDmew-1Dk5kgLIDLXfhoQ"
}
Relevant Fields
- response.text: Directly provides an overview of Gary Danko (e.g., Michelin-rated status, customizable menus, etc.).
- types: Indicates the type of response (e.g., "business_question").
- entities.businesses[]: Array of businesses referenced in the response. For each business, the following fields are particularly relevant to the user’s query.
- name: Confirms that we are discussing Gary Danko in San Francisco.
- location: Provides the address (e.g., 800 N Point St, San Francisco, CA).
- price: Indicates the price range (“$$$$”) for an upscale dining experience.
- rating: Reflects the restaurant’s rating (4.5), relevant to its popularity/quality.
- categories: Shows the cuisine (New American, French, Wine Bars) and helps describe the type of dining.
- summaries: Offers short, medium, and long descriptions of Gary Danko, including signature dishes and notable features.
- contextual_info.review_snippets: Provides additional user perspectives on the ambiance, menu variety, and overall dining experience.
- chat_id: The identifier for the user’s chat session.
Limitations
Currently, the Yelp Fusion AI API does not support:
- Making reservations or scheduling services on behalf of the user.
- Providing step-by-step directions to a business location.
- Non-business-related queries (e.g., health advice, financial advice).
We’re continually improving and expanding the feature set. Keep an eye on our Changelog for updates on upcoming capabilities!
Updated 5 days ago