Sign in

v1

latestOpenAPI 3.1.02026-07-248941352.6 KB
Businesses

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 <a href="https://business.yelp.com/data/products/fusion-ai/#form" target="_blank">contact us</a>.)
  • 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 <a href="https://www.yelp.com/developers/fusion-ai/chat" target="_blank">playground</a> and see real-time responses in action.

🛠️ For a detailed, step-by-step guide on integrating this endpoint into your application, check out the <a href="https://docs.developer.yelp.com/docs/yelp-fusion-ai-api" target="_blank">Getting Started with Yelp AI API guide</a>.

post/ai/chat/v2

Request body

querystring required

• 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).

chat_idstring

• 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.

Response

A successful response

chat_idstring required

A unique Yelp-generated Chat ID that ties all requests to a specific conversation. • This remains the same if the user provided a valid chat_id in the request. • It is static throughout one session.

typesstring[]

A list of response categories indicating the nature of the answer. Valid values: • business_search • business_question • clarification • unsupported • confirmation