---
agentTools:
projectIndex: https://docs.developer.yelp.com/llms.txt
---
# Yelp AI API (Search & Chat)
The Yelp AI API endpoint brings conversational intelligence to your applications, enabling users to ask natural language questions and receive real-time, contextually relevant answers powered by Yelp’s latest business data and reviews.
**Yelp AI API Features**
- **Next generation search & discovery** - Search with natural language, discover, and connect with contextually relevant businesses.
- **Multi-turn conversations** - Support back-and-forth interactions and refine queries with follow-up questions.
- **Direct business queries** - Ask targeted questions about businesses without needing to perform a prior search.
- **Conversational restaurant reservations** - Explore availability and book a table at restaurants through natural language interactions. (Please note that this feature is available on request only. To enable reservations, please contact us.)
- **Instant quotes for home services** - Simply describe the service you need (like “I need quotes for fixing a leaking faucet”), and Yelp AI API instantly connects you with top local pros, so you receive multiple quotes from the best professionals for your job. (Currently in beta and not yet publicly available.)
🚀 **Try it now** - Test Yelp AI API for free in our **playground** and see real-time responses in action.
🛠️ For a detailed, step-by-step guide on integrating this endpoint into your application, check out the **Getting Started with Yelp AI API guide**.
# OpenAPI definition
````json
{
"openapi": "3.1.0",
"info": {
"title": "Businesses",
"version": "1.0"
},
"servers": [
{
"url": "https://api.yelp.com"
}
],
"components": {
"securitySchemes": {
"oauth2": {
"type": "oauth2",
"flows": {
"authorizationCode": {
"authorizationUrl": "https://biz.yelp.com/oauth2/authorize",
"tokenUrl": "https://api.yelp.com/oauth2/token/v3",
"scopes": {
"leads": "Access Yelp Leads on your behalf, including reading and responding to messages, and storing message data"
}
}
}
},
"bearerAuth": {
"type": "http",
"scheme": "bearer",
"description": "To authenticate API calls with the API Key, set the Authorization HTTP header value as `Bearer API_KEY`.\n\nExample: `Bearer 23813239889e947efd3e787cc41b0b839f442a85c5bfd30bd4b9a85ec3a54d5cae4d52b37ff52e64deb9c83bd04883812a6cebde04f2f25752f31be0ac74b514`.\n\nYou can create or find your API Key at [yelp.com](https://www.yelp.com/developers/v3/manage_app).\n"
}
}
},
"security": [
{
"bearerAuth": []
}
],
"paths": {
"/ai/chat/v2": {
"post": {
"summary": "Yelp AI API (Search & Chat)",
"tags": [
"Businesses"
],
"description": "The Yelp AI API endpoint brings conversational intelligence to your applications, enabling users to ask natural language questions and receive real-time, contextually relevant answers powered by Yelp’s latest business data and reviews.\n\n**Yelp AI API Features**\n- **Next generation search & discovery** - Search with natural language, discover, and connect with contextually relevant businesses.\n- **Multi-turn conversations** - Support back-and-forth interactions and refine queries with follow-up questions.\n- **Direct business queries** - Ask targeted questions about businesses without needing to perform a prior search.\n- **Conversational restaurant reservations** - Explore availability and book a table at restaurants through natural language interactions. (Please note that this feature is available on request only. To enable reservations, please contact us.)\n- **Instant quotes for home services** - Simply describe the service you need (like “I need quotes for fixing a leaking faucet”), and Yelp AI API instantly connects you with top local pros, so you receive multiple quotes from the best professionals for your job. (Currently in beta and not yet publicly available.)\n\n🚀 **Try it now** - Test Yelp AI API for free in our **playground** and see real-time responses in action.\n\n🛠️ For a detailed, step-by-step guide on integrating this endpoint into your application, check out the **Getting Started with Yelp AI API guide**.\n",
"operationId": "v2_ai_chat",
"requestBody": {
"content": {
"application/json": {
"schema": {
"type": "object",
"description": "This object captures the user’s request to the Fusion AI Chat endpoint. It includes\nthe conversational query, optional user context for more relevant results, and\nan optional chat_id for session continuity.\n",
"properties": {
"query": {
"type": "string",
"description": "• Natural language text for querying Yelp-specific information.\n• Accepts any prompt related to Yelp businesses, such as “Can you find a Thai restaurant near me?”\n• This should be plain text (no special formatting needed).\n",
"maxLength": 1000
},
"chat_id": {
"type": "string",
"description": "• Uniquely identifies the current conversation (chat session).\n• For the first request, set this to null or omit it; the API will respond with a new chat_id.\n• Use the returned chat_id on subsequent requests to continue the same conversation.\n• If omitted on subsequent requests, a new conversation is started.\n• If an invalid chat_id is provided, the request will fail.\n",
"x-nullable": true
},
"user_context": {
"type": "object",
"description": "Contains optional location data (latitude and longitude) that can help the AI\ntailor results to a user’s location. If not provided and a location-based query\nis asked, the system may prompt the user to specify a location.\n",
"properties": {
"latitude": {
"type": "number",
"description": "• User’s approximate latitude.\n• If provided, it helps return more location-specific results.\n• Otherwise, the system may ask for location details if needed (e.g., for searches).\n",
"format": "float",
"x-nullable": true
},
"longitude": {
"type": "number",
"description": "• User's approximate longitude.\n• If provided, it helps return more location-specific results.\n• Otherwise, the system may ask for location details if needed.\n",
"format": "float",
"x-nullable": true
}
}
},
"request_context": {
"type": "object",
"description": "Contains optional settings that control how the API processes the request.\nThese settings affect the response format and content generation behavior.\n",
"properties": {
"skip_text_generation": {
"type": "boolean",
"description": "• When set to true, skips LLM text generation and returns only structured data.\n• The response will contain empty text and tags, but all structured data\n (businesses, entities, types) will still be returned.\n• Useful for clients that only need structured data and want to reduce latency.\n",
"default": false
}
}
}
},
"required": [
"query"
]
}
}
}
},
"responses": {
"200": {
"description": "A successful response",
"content": {
"application/json": {
"schema": {
"type": "object",
"description": "Represents the AI Chat response returned by Yelp’s Fusion AI endpoint. It includes\na conversational response, any structured data (entities) relevant to the query,\nand a chat_id for tracking the user session.\n",
"properties": {
"chat_id": {
"type": "string",
"description": "A unique Yelp-generated Chat ID that ties all requests to a specific conversation.\n• This remains the same if the user provided a valid chat_id in the request.\n• It is static throughout one session.\n"
},
"response": {
"type": "object",
"description": "Contains a contextually relevant response message for the user’s query:\n• Might be one or multiple sentences.\n• May include follow-up questions if needed (e.g. to request user’s location).\n",
"properties": {
"text": {
"description": "The AI-generated textual response to the user’s query. For example, it may\ncontain an answer, an additional prompt, or instructions to refine the query.\n",
"type": "string"
},
"tags": {
"description": "Additional metadata tags that provide context about the response.\nThese tags can be used to enrich the response or display additional information.\n",
"type": "array",
"items": {
"type": "object",
"description": "Additional metadata tags that provide context about the response.\nThese tags can be used to enrich the response or display additional information.\n",
"properties": {
"start": {
"type": "number",
"description": "The start index of a particular style/information. e.g. highlight/business name/etc"
},
"end": {
"type": "number",
"description": "The end index of a particular style/information. e.g. highlight/business name/etc"
},
"tag_type": {
"type": "string",
"description": "The type of metadata tag. Valid values:\n• highlight - indicates a highlighted text in the response.\n• business - indicates the name of a business mentioned in the response.\n"
},
"meta": {
"type": "object",
"description": "Additional metadata that can provide more context about the tag.\nThis can include information like business ID, category, or other relevant details.\n",
"x-nullable": true
}
}
},
"x-nullable": true
}
}
},
"types": {
"type": "array",
"description": "A list of response categories indicating the nature of the answer. Valid values:\n• business_search\n• business_question\n• clarification\n• unsupported\n• confirmation\n",
"items": {
"type": "string"
}
},
"entities": {
"type": "array",
"description": "Structured data corresponding to the businesses or other entities referenced\nin the AI response. If the response does not reference specific businesses, this\narray may be empty.\n",
"items": {
"type": "object",
"description": "An entity in the AI Chat response, typically containing a collection of businesses\nrelevant to the user’s query.\n",
"properties": {
"businesses": {
"type": "array",
"description": "A list of Yelp business objects that the AI response refers to. The data may be\npartially or fully populated depending on the nature of the query.\n",
"items": {
"type": "object",
"description": "Standard Yelp business object enhanced for AI Chat responses.\n",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string",
"description": "Name of this business."
},
"alias": {
"type": "string",
"description": "Unique Yelp alias of this business. Can contain unicode characters.\nExample: 'yelp-san-francisco'. Also see What's the difference between the Yelp business ID and business alias?\n"
},
"url": {
"type": "string",
"description": "URL for business page on Yelp."
},
"location": {
"type": "object",
"properties": {
"address1": {
"x-nullable": true,
"description": "Street address of this business."
},
"address2": {
"x-nullable": true,
"description": "Street address of this business, continued."
},
"address3": {
"x-nullable": true,
"description": "Street address of this business, continued."
},
"city": {
"x-nullable": true,
"description": "City of this business."
},
"state": {
"x-nullable": true,
"description": "[ISO 3166-2](https://en.wikipedia.org/wiki/ISO_3166-2) (with a few [exceptions](https://docs.developer.yelp.com/docs/resources-state-codes)) state code of this business."
},
"zip_code": {
"x-nullable": true,
"description": "[Zip code](https://en.wikipedia.org/wiki/Postal_code) of this business."
},
"country": {
"x-nullable": true,
"description": "[ISO 3166-1 alpha-2](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) country code of this business."
}
}
},
"coordinates": {
"x-nullable": true,
"type": "object",
"description": "Coordinates of this business.",
"properties": {
"latitude": {
"type": "number",
"description": "Latitude position on map."
},
"longitude": {
"type": "number",
"description": "Longitude position on map."
}
}
},
"review_count": {
"type": "integer",
"description": "Number of reviews for this business."
},
"price": {
"type": "string",
"description": "Price level of the business. Value is one of *$*, *$$*, *$$$* or *$$$$*.",
"x-nullable": true
},
"rating": {
"type": "number",
"format": "double",
"description": "Rating for this business (value ranges from 1, 1.5, ... 4.5, 5).",
"x-nullable": true
},
"categories": {
"type": "array",
"description": "A list of Yelp Categories",
"items": {
"type": "object",
"properties": {
"alias": {
"type": "string",
"description": "Alias of a category, when searching for business in certain categories, use alias rather than the title."
},
"title": {
"type": "string",
"description": "Title of a category for display purpose."
}
}
}
},
"attributes": {
"type": "object",
"description": "Various features or facilities provided by the business."
},
"phone": {
"type": "string",
"description": "Phone number of the business.",
"x-nullable": true
},
"summaries": {
"type": "object",
"description": "AI-generated textual summaries for this business. These are not specific to the user’s query.\n",
"properties": {
"short": {
"type": "string",
"description": "A short, typically single-sentence summary.",
"x-nullable": true
},
"medium": {
"type": "string",
"description": "A medium-length summary (2–3 sentences).",
"x-nullable": true
},
"long": {
"type": "string",
"description": "A more detailed paragraph-length summary.",
"x-nullable": true
}
}
},
"contextual_info": {
"type": "object",
"description": "Additional context relevant to the user’s specific query, if applicable.",
"properties": {
"summary": {
"type": "string",
"description": "A contextual summary relevant to the user’s query. May be null if not applicable.\n",
"x-nullable": true
},
"review_snippets": {
"type": "array",
"description": "Automatically selected short excerpts from user reviews, based on the query.",
"items": {
"type": "object",
"properties": {
"review_id": {
"type": "string"
},
"comment": {
"type": "string"
},
"rating": {
"type": "number",
"format": "double"
},
"timestamp": {
"x-nullable": true,
"type": "integer"
}
},
"required": [
"review_id",
"comment",
"rating"
]
}
},
"business_hours": {
"x-nullable": true,
"type": "array",
"items": {
"type": "object",
"properties": {
"day_of_week": {
"type": "string"
},
"business_hours": {
"type": "array",
"items": {
"type": "object",
"properties": {
"open_time": {
"type": "string"
},
"close_time": {
"type": "string"
}
},
"required": [
"open_time",
"close_time"
]
}
}
},
"required": [
"day_of_week",
"business_hours"
]
}
},
"photos": {
"x-nullable": true,
"description": "A list of Yelp-hosted photo objects.\n",
"type": "array",
"items": {
"type": "object",
"properties": {
"original_url": {
"type": "string"
}
},
"required": [
"original_url"
]
}
},
"review_snippet": {
"type": "string",
"description": "A single representative snippet from a review.\n",
"x-nullable": true
},
"accepts_reservations_through_yelp": {
"type": "boolean",
"description": "Whether the business accepts reservations through Yelp",
"x-nullable": true
},
"reservation_availability": {
"type": "object",
"x-nullable": true,
"description": "Contains reservation availability information for the business.\nThis field is only present if the business accepts reservations through Yelp.\n",
"properties": {
"openings": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string",
"format": "date",
"description": "Date in YYYY-MM-DD format"
},
"slots": {
"type": "array",
"items": {
"type": "object",
"properties": {
"time": {
"type": "string",
"description": "Time in HH:MM format"
},
"seating_areas": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of available seating areas"
}
},
"required": [
"time",
"seating_areas"
]
},
"description": "Available reservation slots for this date"
}
},
"required": [
"date",
"slots"
]
},
"description": "List of available reservation slots."
}
},
"required": [
"openings"
]
}
}
}
},
"required": [
"id",
"name",
"location",
"coordinates",
"categories",
"attributes",
"summaries"
]
}
}
}
}
},
"request_a_quote_survey": {
"x-nullable": true,
"description": "Request a Quote survey information when the user is in a quote request flow.\nThis field will be populated when the AI determines the user wants to request\nquotes from businesses for services.\n",
"type": "object",
"properties": {
"job_display_name": {
"type": "string",
"description": "Display name for the job type"
},
"status": {
"type": "string",
"enum": [
"in_progress",
"awaiting_user_info",
"awaiting_confirmation",
"awaiting_submit_to_nearby",
"submitted",
"failed"
],
"description": "Status of the Request a Quote survey"
},
"questions": {
"type": "array",
"items": {
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The question text"
},
"available_choices": {
"type": "array",
"items": {
"type": "string"
},
"x-nullable": true,
"description": "List of available choices for the question"
},
"only_accepts_choices": {
"type": "boolean",
"default": false,
"description": "Whether the question only accepts predefined choices"
},
"is_multi_select": {
"type": "boolean",
"default": false,
"description": "Whether multiple choices can be selected"
},
"required": {
"type": "boolean",
"default": false,
"description": "Whether the question is required"
},
"user_response": {
"type": "array",
"items": {
"type": "string"
},
"x-nullable": true,
"description": "User's response to the question"
}
},
"required": [
"text"
]
},
"description": "List of survey questions"
},
"user_info": {
"x-nullable": true,
"type": "object",
"properties": {
"first_name": {
"type": "string",
"x-nullable": true
},
"last_name": {
"type": "string",
"x-nullable": true
},
"email": {
"type": "string",
"x-nullable": true
},
"phone": {
"type": "string",
"x-nullable": true
},
"zip_code": {
"type": "string",
"x-nullable": true
}
}
},
"requested_biz_ids": {
"type": "array",
"items": {
"type": "string"
},
"x-nullable": true,
"description": "List of encrypted business IDs requested for quotes"
},
"num_matched_businesses": {
"type": "integer",
"x-nullable": true,
"description": "Number of businesses matched for this request"
},
"submit_to_nearby_businesses": {
"type": "boolean",
"default": false,
"description": "Whether to submit quote request to nearby businesses"
}
},
"required": [
"job_display_name",
"status",
"questions"
]
}
},
"required": [
"chat_id"
]
},
"examples": {
"Find Pizza places in Chicago": {
"value": {
"response": {
"text": "Here are some places in Chicago offering delicious pizza with a variety of toppings and a satisfying dining experience.",
"tags": [
{
"tag_type": "highlight",
"start": 41,
"end": 56
}
]
},
"types": [
"business_search"
],
"entities": [
{
"businesses": [
{
"id": "8vsdJH_paXsgre3_KAa3w",
"alias": "lou-malnatis-pizzeria-chicago",
"name": "Lou Malnati's Pizzeria",
"url": "https://www.yelp.com/biz/lou-malnatis-pizzeria-chicago?adjust_creative=3aOVd6DAVkgZJsTctgMtSA&utm_campaign=yelp_api_v3&utm_medium=api_v3_public_ai_api_chat_v2&utm_source=3aOVd6DAVkgZJsTctgMtSA",
"location": null,
"address1": "439 North Wells St",
"address2": null,
"address3": null,
"city": "Chicago",
"zip_code": null,
"state": "IL",
"country": "US",
"formatted_address": "439 North Wells St\\nChicago, IL 60610",
"coordinates": null,
"latitude": 41.890357,
"longitude": -87.633704,
"review_count": 7595,
"price": "$",
"rating": 4.1,
"categories": [
{
"alias": "pizza",
"title": "Pizza"
},
{
"alias": "italian",
"title": "Italian"
},
{
"alias": "sandwiches",
"title": "Sandwiches"
}
],
"attributes": {
"BusinessAcceptsAndroidPay": false,
"BusinessAcceptsApplePay": false,
"PokestopNearby": true,
"BusinessUrl": "https://www.loumalnatis.com/chicago-river-north",
"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": "If you're on the hunt for the best pizza River North has to offer, look no further than Lou Malnati's. Located in the Near North Side of Chicago neighborhood, you can enjoy Legendary Chicago Deep Dish and thin crust at the place that's been perfecting it for 50+ years. Our River North restaurant features a full-service bar, dine-in, carryout, delivery, group ordering, and drop-off catering. During the warmer months, we also offer outdoor seating. While you're out in this vibrant, ultra-stylish neighborhood, Lou Malnati's River North is the perfect spot to satiate your deep dish cravings.",
"AboutThisBizYearEstablished": null,
"Alcohol": "full_bar",
"Ambience": {
"divey": false,
"hipster": false,
"casual": true,
"touristy": null
},
"BikeParking": true,
"BusinessAcceptsBitcoin": null,
"BusinessAcceptsCreditCards": true,
"BusinessDisplayUrl": "http://www.loumalnatis.com",
"GoodForKids": true,
"GoodForMeal": {
"dessert": false,
"latenight": null,
"lunch": true,
"dinner": true,
"brunch": false,
"breakfast": false
},
"HappyHour": null,
"HasTV": true,
"MenuUrl": "http://www.loumalnatis.com/our-menu",
"NationalProviderIdentifier": null,
"NoiseLevel": "average",
"OffersMilitaryDiscount": null,
"RestaurantsTakeOut": true,
"WaitlistReservation": null,
"WheelchairAccessible": null,
"WiFi": "free"
},
"phone": 13128289800,
"summaries": {
"short": null,
"medium": null,
"long": null
},
"contextual_info": {
"summary": "Known for its classic Chicago-style deep dish pizza, this family-friendly pizzeria offers a rich and luxurious dining experience. With a thick crust and generous cheese, it's a must-visit for pizza lovers in the area. While the wait for a table can be long, pre-ordering is available to satisfy your craving for their delicious pies. Don't forget to try the Chocolate Chip Pizza for a sweet finish!",
"review_snippets": [],
"business_hours": [
{
"day_of_week": "Monday",
"business_hours": [
{
"open_time": "2025-02-03 11:00:00",
"close_time": "2025-02-03 23:00:00",
"special_hours_applied": false
}
]
},
{
"day_of_week": "Tuesday",
"business_hours": [
{
"open_time": "2025-02-04 11:00:00",
"close_time": "2025-02-04 23:00:00",
"special_hours_applied": false
}
]
},
{
"day_of_week": "Wednesday",
"business_hours": [
{
"open_time": "2025-02-05 11:00:00",
"close_time": "2025-02-05 23:00:00",
"special_hours_applied": false
}
]
},
{
"day_of_week": "Thursday",
"business_hours": [
{
"open_time": "2025-02-06 11:00:00",
"close_time": "2025-02-06 23:00:00",
"special_hours_applied": false
}
]
},
{
"day_of_week": "Friday",
"business_hours": [
{
"open_time": "2025-02-07 11:00:00",
"close_time": "2025-02-08 00:00:00",
"special_hours_applied": false
}
]
},
{
"day_of_week": "Saturday",
"business_hours": [
{
"open_time": "2025-02-08 11:00:00",
"close_time": "2025-02-09 00:00:00",
"special_hours_applied": false
}
]
},
{
"day_of_week": "Sunday",
"business_hours": [
{
"open_time": "2025-02-09 11:00:00",
"close_time": "2025-02-09 23:00:00",
"special_hours_applied": false
}
]
}
],
"photos": [
{
"original_url": "https://s3-media0.fl.yelpcdn.com/bphoto/o_RMV239sfg3g3F9TBw4uTzQg/o.jpg"
},
{
"original_url": "https://s3-media0.fl.yelpcdn.com/bphoto/o_RMV9asd3F9T4Bw4uTzQg/o.jpg"
},
{
"original_url": "https://s3-media0.fl.yelpcdn.com/bphoto/YkRk12fdaf3JUcQbdSpycQ/o.jpg"
}
],
"review_snippet": "It was the most [[HIGHLIGHT]]delicious pizza[[ENDHIGHLIGHT]] I ever had. It wasn't too loaded but it had everything it needed."
}
}
]
}
],
"chat_id": "-AfyyCgdgdTsQ23fkOg"
}
},
"Compare Sumo Sushi and ITs SUSHI in Las Vegas": {
"value": {
"chatId": "p2MbqlR1StvSjgDGdEA4HQ",
"response": {
"text": "Sumo Sushi and ITs SUSHI Spring Mountain are both popular for all-you-can-eat sushi in Las Vegas. Sumo Sushi is praised for its consistent high quality fish, excellent service, and affordable prices, with many reviewers calling it their new go-to spot. ITs SUSHI Spring Mountain is known for its creative rolls, good value, and a wide variety of AYCE options, though reviews mention inconsistent service and occasional mixed experiences with fish quality. Both offer great value, but Sumo Sushi stands out for its friendly, attentive staff and consistently fresh offerings.\n",
"tags": [
{
"start": 0,
"end": 10,
"tagType": "business",
"meta": {
"businessId": "Lc_l8k7YskzicRQ_8RtMyA"
}
},
{
"start": 15,
"end": 40,
"tagType": "business",
"meta": {
"businessId": "myFPRndhdZMKdfMZyksyxQ"
}
},
{
"start": 128,
"end": 151,
"tagType": "highlight",
"meta": null
},
{
"start": 181,
"end": 198,
"tagType": "highlight",
"meta": null
},
{
"start": 296,
"end": 310,
"tagType": "highlight",
"meta": null
},
{
"start": 312,
"end": 322,
"tagType": "highlight",
"meta": null
},
{
"start": 383,
"end": 403,
"tagType": "highlight",
"meta": null
},
{
"start": 514,
"end": 539,
"tagType": "highlight",
"meta": null
}
]
},
"entities": [
{
"businesses": [
{
"encid": "Lc_l8k7YskzicRQ_8RtMyA",
"name": "Sumo Sushi",
"alias": "sumo-sushi-las-vegas-2",
"url": "https://www.yelp.com/biz/sumo-sushi-las-vegas-2?adjust_creative=ozhuoStXlSnOIK1pCpdsmg&utm_campaign=yelp_api_v3&utm_medium=api_v3_public_ai_api_chat_v2&utm_source=ozhuoStXlSnOIK1pCpdsmg",
"price": "$$$",
"categories": [
{
"alias": "sushi",
"title": "Sushi Bars"
}
],
"rating": 4.8,
"location": null,
"address1": "8795 W Warm Springs Rd",
"address2": "Ste 105-106",
"formattedAddress": "8795 W Warm Springs Rd\nSte 105-106\nLas Vegas, NV 89148",
"address3": null,
"city": "Las Vegas",
"state": "NV",
"zipCode": null,
"country": "US",
"coordinates": null,
"latitude": 36.05520557246892,
"longitude": -115.28334589829451,
"reviewCount": 642,
"contextualInfo": null,
"summary": null,
"reviewSnippet": "I love coming to [[HIGHLIGHT]]Sumo Sushi[[ENDHIGHLIGHT]]. This is my third time here. Sumo Sushi is hands down one of the best...",
"reviewSnippets": [
{
"reviewId": "6GjsTZoRiVvLkx6is4iEog",
"comment": "So we've seen this place all over social media and it's around the corner from us so figured we'd give it a try. Our normal go to AYCE is It's sushi, and I'd say this place is on par with their [[HIGHLIGHT]]quality[[ENDHIGHLIGHT]] and selection. We went on a Saturday night around 630 expecting a bit of a wait, the hostess said about 30-45 mins, but we got a text in about 15 mins that our table was ready.",
"rating": 5,
"timestamp": null
},
{
"reviewId": "W9vVe9sa74XL6AIaL5l5vg",
"comment": "So I knew coming to Sumo Sushi would have the same great [[HIGHLIGHT]]quality[[ENDHIGHLIGHT]] and options. My favorite type of sushi is tuna (all varieties but especially blue fin toro). You can't go wrong with anything on the menu. Our server Missy was the [[HIGHLIGHT]]best[[ENDHIGHLIGHT]]. She had great energy and guided us on the most popular items. She was on [[HIGHLIGHT]]top[[ENDHIGHLIGHT]] of everything and often checked on us without being overbearing.",
"rating": 5,
"timestamp": null
},
{
"reviewId": "-PE59b-lsHh5ToRUYbu2Og",
"comment": "We've been regular sushi lovers in Las Vegas for years, and ever since Goyemon closed, we've been on the hunt for a new go-to spot. This is it. Not only does Sumo Sushi match the [[HIGHLIGHT]]quality[[ENDHIGHLIGHT]] of our old favorite, but in some ways--it's even better. Let's talk about the food- * The mussels are exceptional. We always order them, and they are easily some of the [[HIGHLIGHT]]best[[ENDHIGHLIGHT]] we've had anywhere in the city--rich, flavorful, and perfectly cooked",
"rating": 5,
"timestamp": null
}
],
"businessHours": [],
"photos": [
{
"originalUrl": "https://s3-media0.fl.yelpcdn.com/bphoto/NrRBru8nYBS9lf20dWFvFw/o.jpg"
},
{
"originalUrl": "https://s3-media0.fl.yelpcdn.com/bphoto/fquY0GQqQgMHN2yml7g9tQ/o.jpg"
},
{
"originalUrl": "https://s3-media0.fl.yelpcdn.com/bphoto/GCyEEaz6c6TAhzc1AvdZqA/o.jpg"
}
]
},
{
"encid": "myFPRndhdZMKdfMZyksyxQ",
"name": "ITs SUSHI Spring Mountain",
"alias": "its-sushi-spring-mountain-las-vegas-3",
"url": "https://www.yelp.com/biz/its-sushi-spring-mountain-las-vegas-3?adjust_creative=ozhuoStXlSnOIK1pCpdsmg&utm_campaign=yelp_api_v3&utm_medium=api_v3_public_ai_api_chat_v2&utm_source=ozhuoStXlSnOIK1pCpdsmg",
"price": "$$$",
"categories": [
{
"alias": "japanese",
"title": "Japanese"
},
{
"alias": "sushi",
"title": "Sushi Bars"
},
{
"alias": "buffets",
"title": "Buffets"
}
],
"rating": 4.5,
"location": null,
"address1": "4815 Spring Mountain Rd",
"address2": null,
"formattedAddress": "4815 Spring Mountain Rd\nLas Vegas, NV 89103",
"address3": "",
"city": "Las Vegas",
"state": "NV",
"zipCode": null,
"country": "US",
"coordinates": null,
"latitude": 36.1260493,
"longitude": -115.2070253,
"reviewCount": 2897,
"contextualInfo": null,
"summary": null,
"reviewSnippet": "I knew [[HIGHLIGHT]]It's Sushi[[ENDHIGHLIGHT]] was new and figured it would be a great time to try it out.",
"reviewSnippets": [
{
"reviewId": "00q3Ax-1KAiT2rGa0Pygng",
"comment": "I then ordered a roll, which comes out as a half roll for AYCE which is perfect. It too was presented well, with a great balance of natural and added flavor. The fish [[HIGHLIGHT]]quality[[ENDHIGHLIGHT]] is what blew my mind. [[HIGHLIGHT]]High quality[[ENDHIGHLIGHT]] fish doesn't come just from the fish being fresh. There is a lot more to it then that. It starts with the conditions it is caught, how quickly it is chilled, how carefully it is transported, how well it is stored, and how well its cut.",
"rating": 5,
"timestamp": null
},
{
"reviewId": "VHX4pSgUy2ZxR324eldKVg",
"comment": "Call this place what you want to call it but it's overall a great dining experience. From the [[HIGHLIGHT]]quality[[ENDHIGHLIGHT]] of the food, to the random birthday shoutouts and the delicate care by the servers, Its Sushi is one of my to trusted spots in Vegas. You can tell the [[HIGHLIGHT]]quality[[ENDHIGHLIGHT]] of the fish is of the better [[HIGHLIGHT]]qualities[[ENDHIGHLIGHT]] from most spots in Vegas. Some Nigiri with soy sauce and wasabi will quench your sushi hunger here.",
"rating": 5,
"timestamp": null
},
{
"reviewId": "oCMd0GgapmhJIdpChFENOA",
"comment": "Highlights: I personally had a great experience and was really surprised because I've tried my fair share of AYCE and part of me always regrets it since it's usually at the expense of [[HIGHLIGHT]]quality[[ENDHIGHLIGHT]] sushi. It's Sushi however still has pretty [[HIGHLIGHT]]good quality[[ENDHIGHLIGHT]] fish especially the salmon belly, uni, yellowtail and eel. They also had appetizers and items I hadn't seen at other AYCE places like hamburger steak, grilled saury, spring rolls, yubu, and cheese budak.",
"rating": 4,
"timestamp": null
}
],
"businessHours": [],
"photos": [
{
"originalUrl": "https://s3-media0.fl.yelpcdn.com/bphoto/5OQj-6E-xC_FKJERHBQvrw/o.jpg"
},
{
"originalUrl": "https://s3-media0.fl.yelpcdn.com/bphoto/Ddh9Iub86sGFwXvHyq8J4w/o.jpg"
},
{
"originalUrl": "https://s3-media0.fl.yelpcdn.com/bphoto/NpRiNSVYF3w2jwGtpzaRYw/o.jpg"
}
]
}
]
}
],
"types": [
"business_question"
]
}
},
"Find me reservation for 2 people at Tuscany Steakhouse for July 12, 2025 at 7:00 PM": {
"value": {
"response": {
"chat_id": "a14lrvvLkVsDbjUFI9wUQf",
"text": "To book your table for 2 at Tuscany Steakhouse on Saturday, July 12, 2025 at 7:00 PM, I just need your first name, last name, email, and phone number. Please provide these details to complete your reservation.",
"tags": [
{
"tag_type": "business",
"start": 28,
"end": 46,
"meta": {
"business_id": "4WDHrSodF1Xidv9ezS6Sgg"
}
}
],
"types": [
"reservation"
],
"entities": [
{
"businesses": [
{
"id": "4WDHrSodF1Xidv9ezS6Sgg",
"alias": "tuscany-steakhouse-new-york",
"name": "Tuscany Steakhouse",
"url": "https://www.yelp.com/biz/tuscany-steakhouse-new-york?adjust_creative=uKZbO3XxGEy7Htt5nSGiRw&utm_campaign=yelp_api_v3&utm_medium=api_v3_public_ai_api_chat_v2&utm_source=uKZbO3XxGEy7Htt5nSGiRw",
"location": null,
"address1": "117 W 58th St",
"address2": null,
"address3": null,
"city": "New York",
"zip_code": null,
"state": "NY",
"country": "US",
"formatted_address": "117 W 58th St\nNew York, NY 10019",
"coordinates": null,
"latitude": 40.7654481,
"longitude": -73.9773555,
"review_count": 282,
"price": "$$$",
"rating": 4.6,
"categories": [
{
"alias": "steak",
"title": "Steakhouses"
},
{
"alias": "italian",
"title": "Italian"
},
{
"alias": "seafood",
"title": "Seafood"
}
],
"attributes": {
"BusinessAcceptsAndroidPay": false,
"BusinessAcceptsApplePay": false,
"BusinessUrl": "http://www.tuscanysteakhouse.com",
"AboutThisBizBioPhotoDict": null,
"AboutThisBizBusinessRecommendation": [],
"AboutThisBizSpecialties": "Newest Steakhouse in Manhattan",
"AboutThisBizYearEstablished": "2017",
"Alcohol": "full_bar",
"Ambience": {
"divey": false,
"hipster": false,
"classy": true,
"upscale": true
},
"BikeParking": true,
"BusinessAcceptsBitcoin": null,
"BusinessAcceptsCreditCards": true,
"BusinessDisplayUrl": null,
"BusinessMovedTo": null,
"BusinessParking": {
"valet": false,
"garage": true,
"street": false,
"lot": false,
"validated": false
},
"BYOB": null,
"BYOBCorkage": null,
"Caters": true,
"Corkage": null,
"DogsAllowed": false,
"DriveThrstrooms": null,
"GoodForKids": false,
"GoodForMeal": {
"dessert": true,
"latenight": null,
"lunch": null,
"dinner": true,
"brunch": null,
"breakfast": null
},
"HappyHour": null,
"HasTV": true,
"MenuUrl": null,
"NationalProviderIdentifier": null,
"NoiseLevel": "average",
"RestaurantsAttire": "casual",
"RestaurantsCounterService": null,
"RestaurantsDelivery": true,
"RestaurantsGoodForGroups": true,
"RestaurantsPriceRange": null,
"RestaurantsPriceRange2": 3,
"RestaurantsReservations": true,
"RestaurantsTableService": true,
"RestaurantsTakeOut": true,
"WaitlistReservation": true,
"WheelchairAccessible": null,
"WiFi": "free",
"biz_summary": {
"summary": "Classic steakhouse with a cozy atmosphere featuring perfectly cooked steaks.",
"is_inactive": false,
"allows_auto_summary_generation": true,
"eligible_reviews_considered": 30
},
"biz_summary_long": {
"summary": "Upscale steakhouse offering a blend of American and Italian cuisine, featuring dry-aged steaks and fresh seafood. Notable menu items include the Porterhouse for two and Filet Mignon, complemented by handcrafted cocktails and fine wines. The restaurant features a modern and intimate interior, with private dining options available for events. It is also accessible for guests with disabilities.",
"is_inactive": false,
"allows_auto_summary_generation": true,
"eligible_reviews_considered": 68
},
"phone": "+12127578630",
"summaries": {
"short": "Classic steakhouse with a cozy atmosphere featuring perfectly cooked steaks.",
"medium": "Upscale steakhouse offering a blend of American and Italian cuisine, featuring dry-aged steaks and fresh seafood. Notable menu items include the Porterhouse for two and Filet Mignon, complemented by handcrafted cocktails and fine wines. The restaurant features a modern and intimate interior, with private dining options available for events.",
"long": "Upscale steakhouse offering a blend of American and Italian cuisine, featuring dry-aged steaks and fresh seafood. Notable menu items include the Porterhouse for two and Filet Mignon, complemented by handcrafted cocktails and fine wines. The restaurant features a modern and intimate interior, with private dining options available for events. It is also accessible for guests with disabilities."
},
"contextual_info": {
"summary": null,
"review_snippets": [],
"business_hours": [],
"photos": [
{
"original_url": "https://s3-media0.fl.yelpcdn.com/bphoto/-ntrLHjqTqc7-M-7YNsOoQ/o.jpg"
},
{
"original_url": "https://s3-media0.fl.yelpcdn.com/bphoto/kkLbCqRP_SmRh3K2uJmZMQ/o.jpg"
},
{
"original_url": "https://s3-media0.fl.yelpcdn.com/bphoto/i3eBkuB_wy0iA7_ldTOuOw/o.jpg"
}
],
"review_snippet": "Fantastic food and people. I highly recommend [[HIGHLIGHT]]Tuscany Steakhouse[[ENDHIGHLIGHT]]. We arrived in the City after...",
"accepts_reservations_through_yelp": true,
"reservation_availability": {
"openings": [
{
"date": "2025-07-12",
"slots": [
{
"time": "12:00",
"seating_areas": [
"Indoor"
]
},
{
"time": "12:15",
"seating_areas": [
"Indoor"
]
},
{
"time": "12:30",
"seating_areas": [
"Indoor"
]
},
{
"time": "12:45",
"seating_areas": [
"Indoor"
]
},
{
"time": "13:00",
"seating_areas": [
"Indoor"
]
},
{
"time": "13:15",
"seating_areas": [
"Indoor"
]
},
{
"time": "13:30",
"seating_areas": [
"Indoor"
]
},
{
"time": "13:45",
"seating_areas": [
"Indoor"
]
},
{
"time": "14:00",
"seating_areas": [
"Indoor"
]
},
{
"time": "14:15",
"seating_areas": [
"Indoor"
]
},
{
"time": "14:30",
"seating_areas": [
"Indoor"
]
},
{
"time": "14:45",
"seating_areas": [
"Indoor"
]
},
{
"time": "15:00",
"seating_areas": [
"Indoor"
]
},
{
"time": "15:15",
"seating_areas": [
"Indoor"
]
},
{
"time": "15:30",
"seating_areas": [
"Indoor"
]
},
{
"time": "15:45",
"seating_areas": [
"Indoor"
]
},
{
"time": "16:00",
"seating_areas": [
"Indoor"
]
},
{
"time": "16:15",
"seating_areas": [
"Indoor"
]
},
{
"time": "16:30",
"seating_areas": [
"Indoor"
]
},
{
"time": "16:45",
"seating_areas": [
"Indoor"
]
},
{
"time": "17:00",
"seating_areas": [
"Indoor"
]
},
{
"time": "17:15",
"seating_areas": [
"Indoor"
]
},
{
"time": "17:30",
"seating_areas": [
"Indoor"
]
},
{
"time": "17:45",
"seating_areas": [
"Indoor"
]
},
{
"time": "18:00",
"seating_areas": [
"Indoor"
]
},
{
"time": "18:15",
"seating_areas": [
"Indoor"
]
},
{
"time": "18:30",
"seating_areas": [
"Indoor"
]
},
{
"time": "18:45",
"seating_areas": [
"Indoor"
]
},
{
"time": "19:00",
"seating_areas": [
"Indoor"
]
},
{
"time": "19:15",
"seating_areas": [
"Indoor"
]
},
{
"time": "19:30",
"seating_areas": [
"Indoor"
]
},
{
"time": "19:45",
"seating_areas": [
"Indoor"
]
},
{
"time": "20:00",
"seating_areas": [
"Indoor"
]
},
{
"time": "20:15",
"seating_areas": [
"Indoor"
]
},
{
"time": "20:30",
"seating_areas": [
"Indoor"
]
},
{
"time": "20:45",
"seating_areas": [
"Indoor"
]
},
{
"time": "21:00",
"seating_areas": [
"Indoor"
]
},
{
"time": "21:15",
"seating_areas": [
"Indoor"
]
},
{
"time": "21:30",
"seating_areas": [
"Indoor"
]
},
{
"time": "21:45",
"seating_areas": [
"Indoor"
]
},
{
"time": "22:00",
"seating_areas": [
"Indoor"
]
},
{
"time": "22:15",
"seating_areas": [
"Indoor"
]
}
]
}
]
}
}
}
}
]
}
]
}
}
}
}
}
}
},
"400": {
"description": "Bad Request. Message varies depending on failure scenario",
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"error": {
"type": "object",
"required": [
"code",
"description"
],
"properties": {
"code": {
"type": "string",
"description": "The error code."
},
"description": {
"type": "string",
"description": "The description of the error."
}
}
}
}
},
"examples": {
"Invalid Request": {
"value": {
"error": {
"code": "INVALID_REQUEST",
"description": "Invalid Request"
}
}
}
}
}
}
},
"401": {
"description": "The API key has either expired or doesn't have the required scopes to query this endpoint.\n\n| code | description |\n| ------------- | ------------- |\n| UNAUTHORIZED_API_KEY | The API key provided is not currently able to query this endpoint. |\n| TOKEN_INVALID | Invalid API key or authorization header. |\n",
"content": {
"application/json": {
"examples": {
"Unauthorized": {
"value": {
"error": {
"code": "UNAUTHORIZED_API_KEY",
"description": "The API key provided is not currently able to query this endpoint."
}
}
},
"Invalid Token": {
"value": {
"error": {
"code": "TOKEN_INVALID",
"description": "Invalid API key or authorization header."
}
}
}
},
"schema": {
"$ref": "#/paths/~1ai~1chat~1v2/post/responses/400/content/application~1json/schema"
}
}
}
},
"403": {
"description": "The API key provided is not currently able to query this endpoint.",
"$ref": "#/paths/~1v3~1businesses~1{business_id_or_alias}~1rapc_enabledness/post/responses/403"
},
"404": {
"description": "Resource Not Found",
"content": {
"application/json": {
"schema": {
"$ref": "#/paths/~1ai~1chat~1v2/post/responses/400/content/application~1json/schema"
},
"examples": {
"Resource Not Found": {
"value": {
"error": {
"code": "NOT_FOUND",
"description": "Resource Not Found"
}
}
}
}
}
}
},
"413": {
"description": "The length of the request exceeded the maximum allowed",
"content": {
"application/json": {
"schema": {
"$ref": "#/paths/~1ai~1chat~1v2/post/responses/400/content/application~1json/schema"
},
"examples": {
"Payload Too Large": {
"value": {
"error": {
"code": "PAYLOAD_TOO_LARGE",
"description": "Payload Too Large"
}
}
}
}
}
}
},
"429": {
"description": "You have either exceeded your daily quota, or have exceeded the queries-per-second limit for this endpoint. Try reducing the rate at which you make queries.",
"content": {
"application/json": {
"examples": {
"Rate limited": {
"value": {
"error": {
"code": "TOO_MANY_REQUESTS_PER_SECOND",
"description": "You have exceeded the queries-per-second limit for this endpoint. Try reducing the rate at which you make queries."
}
}
}
},
"schema": {
"$ref": "#/paths/~1ai~1chat~1v2/post/responses/400/content/application~1json/schema"
}
}
}
},
"500": {
"description": "Internal Server Error",
"content": {
"application/json": {
"examples": {
"Internal Server Error": {
"value": {
"error": {
"code": "INTERNAL_ERROR",
"description": "Something went wrong internally, please try again later."
}
}
}
},
"schema": {
"$ref": "#/paths/~1ai~1chat~1v2/post/responses/400/content/application~1json/schema"
}
}
}
},
"503": {
"description": "Service Unavailable",
"content": {
"application/json": {
"schema": {
"$ref": "#/paths/~1ai~1chat~1v2/post/responses/400/content/application~1json/schema"
},
"examples": {
"Service Unavailable": {
"value": {
"error": {
"code": "SERVICE_UNAVAILABLE",
"description": "Service Unavailable"
}
}
}
}
}
}
}
}
}
},
"/v3/businesses/{business_id_or_alias}/rapc_enabledness": {
"post": {
"summary": "Enable/Disable Request a Phone Call",
"tags": [
"Businesses"
],
"description": "This endpoint lets you enable or disable Request a Phone Call for a particular business. Check whether the business is eligible using the [Get business by ID](https://docs.developer.yelp.com/reference/v3_business_info) endpoint and inspecting the *rapc* object.\n\n*Example*:\nTo enable Request a Phone call for a Business with ID \"loPSlzp6M628rzyCRPqrv3tC\", send an [authenticated](https://docs.developer.yelp.com/docs/authorization-code-workflow) POST request to the URL:\nhttps://api.yelp.com/v3/businesses/loPSlzp6M628rzyCRPqrv3tC/rapc_enabledness with the following request body:\n\n```json\n{\n \"is_enabled\": true,\n}\n```\n\nFor the above request, a successful POST call will return a 202 accepted response.\n",
"operationId": "v3_business_rapc_enabledness",
"security": [
{
"oauth2": [
"leads"
]
}
],
"parameters": [
{
"$ref": "#/paths/~1v3~1businesses~1{business_id_or_alias}/get/parameters/0",
"in": "path",
"required": true
}
],
"requestBody": {
"required": true,
"content": {
"application/json": {
"schema": {
"type": "object",
"properties": {
"is_enabled": {
"type": "boolean",
"description": "Whether RaPC should be enabled"
}
},
"required": [
"is_enabled"
]
}
}
}
},
"responses": {
"202": {
"description": "The RaPC status has been set."
},
"400": {
"$ref": "#/paths/~1ai~1chat~1v2/post/responses/400"
},
"401": {
"$ref": "#/paths/~1ai~1chat~1v2/post/responses/401"
},
"403": {
"description": "Authorization Error",
"content": {
"application/json": {
"schema": {
"$ref": "#/paths/~1ai~1chat~1v2/post/responses/400/content/application~1json/schema"
},
"examples": {
"Authorization Error": {
"value": {
"error": {
"code": "AUTHORIZATION_ERROR",
"description": "Authorization Error"
}
}
}
}
}
}
},
"404": {
"$ref": "#/paths/~1ai~1chat~1v2/post/responses/404"
},
"413": {
"$ref": "#/paths/~1ai~1chat~1v2/post/responses/413"
},
"429": {
"$ref": "#/paths/~1ai~1chat~1v2/post/responses/429"
},
"500": {
"$ref": "#/paths/~1ai~1chat~1v2/post/responses/500"
},
"503": {
"$ref": "#/paths/~1ai~1chat~1v2/post/responses/503"
}
}
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": false,
"samples-enabled": true
},
"_id": {
"buffer": {
"0": 99,
"1": 106,
"2": 66,
"3": 36,
"4": 165,
"5": 116,
"6": 255,
"7": 5,
"8": 106,
"9": 241,
"10": 2,
"11": 128
}
}
}
````