GuidesAPI ReferenceGraphQLChangelogManage API AccessCreate Yelp Account
API Reference

Yelp AI API (Search & Chat)

post
https://api.yelp.com/ai/chat/v2

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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

This object captures the user’s request to the Fusion AI Chat endpoint. It includes
the conversational query, optional user context for more relevant results, and
an optional chat_id for session continuity.

string
required
length ≤ 1000

• Natural language text for querying Yelp-specific information.
• Accepts any prompt related to Yelp businesses, such as “Can you find a Thai restaurant near me?”
• This should be plain text (no special formatting needed).

string

• Uniquely identifies the current conversation (chat session).
• For the first request, set this to null or omit it; the API will respond with a new chat_id.
• Use the returned chat_id on subsequent requests to continue the same conversation.
• If omitted on subsequent requests, a new conversation is started.
• If an invalid chat_id is provided, the request will fail.

user_context
object

Contains optional location data (latitude and longitude) that can help the AI
tailor results to a user’s location. If not provided and a location-based query
is asked, the system may prompt the user to specify a location.

request_context
object

Contains optional settings that control how the API processes the request.
These settings affect the response format and content generation behavior.

Responses

Updated 6 months ago

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated 6 months ago