Get Yelp Review Topics and Sentiment Shares
View all Yelp Business, Reviews & Restaurant Data endpoints →Retrieve the topics discussed in reviews of a single Yelp business, such as food, service or ambience. The required business input accepts a Yelp alias, a 22-character business ID or a Yelp business URL. This operation has no documented topic-filter or pagination input. The documented response content consists of review topics with review counts and sentiment shares. No populated response example or successful response observation is available for this endpoint. Exact JSON field names, sentiment labels, share units, aggregation coverage and empty-result behavior are therefore unverified; do not assume a percentage scale or a particular sentiment breakdown. Use these as reported topic aggregates, not sentiment calculated from a complete local review corpus. When using a topic with the separate reviews-by-topic operation, carry the returned topic value forward rather than constructing a topic identifier or substituting a business-category alias.
API Features
Live API Demo
🔒 Sign in to try it live
Log in to call this API with your own API key. New accounts get 100 free credits — no card required.
Log in / Sign upNo active API key found. Create one in your Dashboard, then reload this page. Dashboard →
/api/project/yelp/review-topics API Response (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/yelp/review-topics?key=<API_KEY>&business=gary-danko-san-francisco'
Query Result
Use Cases
- Compare reported food, service or ambience discussion counts across selected branches while retaining each business and collection date.
- Show an analyst the returned review topics before they choose a topic-specific review retrieval, avoiding fabricated topic identifiers.
- Prepare a branch brief that distinguishes reported topic sentiment aggregates from sentiment computed over an independently collected review corpus.
- Track changes in a known business's reported topic counts and sentiment shares across saved snapshots without claiming complete review coverage or a cause for the change.
Frequently asked questions
How do I identify the business for a review-topic request?
Set business to a Yelp alias, a 22-character business ID or a Yelp business URL. The endpoint retrieves topics for that one business rather than searching for businesses.
Are food, service and ambience the only available topics?
No fixed topic list is supplied. Those are documented examples of review themes; inspect the topics actually returned for the selected business.
What do the documented counts and sentiment shares represent?
They are reported aggregates associated with review topics. Exact field names, sentiment labels, share units and aggregation coverage are unverified, so do not assume shares are percentages or topic counts sum to the business review total.
Can I request reviews for a topic returned here?
The separate reviews-by-topic operation is intended for topic-specific review retrieval. Use the actual returned topic value for that request rather than inventing an identifier or substituting a business-category alias. This operation itself retrieves topic aggregates, not a paginated review feed.
Has a populated review-topic response been observed?
No populated response example or successful response observation is available for this endpoint. Topics, review counts and sentiment shares are documented capabilities, but their exact JSON schema and empty-result behavior are not independently confirmed.