List a Yelp business's reviews

POST/v1/tools/yelp.business.reviews/callsNeeds an API key

Returns a Yelp business's reviews, with rating, text, author, date and the owner's response. Use it to track what customers say about a business.

Tool yelp.business.reviews on Yelp. Contract version 1, released 2026-10-27.

Over REST, send the input in the body. Over MCP, pass the same input to call_tool.

Both return the full response: the call's ID, status and cost, with this tool's result in output.

Input

business_idstringRequired

Yelp's ID of the business, such as "dDz2erKJ_Z2HMur0tQ_iJA".

1 to 128 characters.

Matches ^[A-Za-z0-9_-]+$.

sortstring

Order of the reviews. Yelp's own order is relevance.

relevance

newest

highest_rating

lowest_rating

ratinginteger

Keeps only the reviews that gave exactly this many stars.

From 1 to 5.

languagestring· default en

Two-letter ISO 639-1 language code. Yelp returns the reviews written in it. Case-insensitive.

One of the 184 values of the languages list: ISO 639-1 two-letter language codes, lowercase.

pageinteger· default 1

Page of reviews, 10 to a page. A page past the last has no reviews.

From 1 to 1001.

Output

A successful call returns these blocks in its output. A field not marked required can be null.

`reviews`

A list of rows. Always present, possibly empty.

review_idstring

Yelp's identifier of the review.

ratingnumberRequired

Stars the reviewer gave, from 1 to 5.

textstring

What the reviewer wrote.

urlstring

Address of the review on Yelp.

author_namestring

author_idstring

Yelp's identifier of the reviewer.

author_urlstring

Address of the reviewer's Yelp profile.

author_image_urlstring

Address of the reviewer's profile picture.

published_atstring

When the review was written, in ISO 8601.

likesinteger

Number of people who marked the review helpful.

image_urlsarray of string

Address of each photo attached to the review.

owner_response_textstring

The owner's reply to the review.

owner_response_published_atstring

When the owner replied, in ISO 8601.

`place`

One object. Can be null.

titlestring

Name of the business.

ratingnumber

Average review rating, out of 5.

curl https://api.voxoria.ai/v1/tools/yelp.business.reviews/calls \
  -H "Authorization: Bearer $VOXORIA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input":{"business_id":"dDz2erKJ_Z2HMur0tQ_iJA","sort":"newest"}}'

import os

import httpx

response = httpx.post(
    "https://api.voxoria.ai/v1/tools/yelp.business.reviews/calls",
    headers={"Authorization": f"Bearer {os.environ['VOXORIA_API_KEY']}"},
    json={
        "input": {"business_id": "dDz2erKJ_Z2HMur0tQ_iJA", "sort": "newest"},
    },
    timeout=60,
)
print(response.json())

const response = await fetch("https://api.voxoria.ai/v1/tools/yelp.business.reviews/calls", {
  method: "POST",
  headers: {
    Authorization: `Bearer ${process.env.VOXORIA_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    "input": {"business_id": "dDz2erKJ_Z2HMur0tQ_iJA", "sort": "newest"},
  }),
});
console.log(await response.json());

{
  "name": "call_tool",
  "arguments": {
    "tool": "yelp.business.reviews",
    "input": {
      "business_id": "dDz2erKJ_Z2HMur0tQ_iJA",
      "sort": "newest"
    }
  }
}

200 OKoutputapplication/json

{
  "reviews": [
    {
      "review_id": "bsc5JqLCP_A_MDzzPvWFKw",
      "rating": 5,
      "text": "Came to Cosmic with a friend. He suggested a Mexican food truck that is here. And of course we got drinks. \n\nHe got a frozen mango drink. And I got the black cherry lemonade drink. My black cherry, vodka based drink was so good. It was sweet, and cherry flavored. Loved it. Thought I would only have 1 so I closed out my tab. I ended up getting a second one. But my friend treated me to my second. \n\nMy friend also got the frozen coffee something. I didn't take a picture of the menu, and forgot what he got. I did have a sip of it, and wow, was that good. I need to come back here again, cause the food truck was great, the drinks were fantastic, and the whole area outside was perfect. I do have a friend coming to visit, so maybe we can come back and I can show her around.",
      "url": "https://www.yelp.com/biz/cosmic-austin?hrid=bsc5JqLCP_A_MDzzPvWFKw",
      "author_name": "Shannon G.",
      "author_id": "jT-pOXB4mpUA5N9Lu0ZN-g",
      "author_url": "https://www.yelp.com/user_details?userid=jT-pOXB4mpUA5N9Lu0ZN-g",
      "author_image_url": "https://s3-media0.fl.yelpcdn.com/photo/CkN3QEuWbjsATCyDPCDaXg/180s.jpg",
      "published_at": "2026-10-19T19:24:08Z",
      "likes": 33,
      "image_urls": [
        "https://s3-media0.fl.yelpcdn.com/bphoto/2EsUyPlJKgfDYKSYVyBGIw/o.jpg",
        "https://s3-media0.fl.yelpcdn.com/bphoto/7scHglsFO6hHCDRHzME4AA/o.jpg",
        "https://s3-media0.fl.yelpcdn.com/bphoto/47ds05MT4Y5TQF2yVo0zaA/o.jpg"
      ],
      "owner_response_text": null,
      "owner_response_published_at": null
    },
    {
      "review_id": "cLAjIjGT_HsbR1sOmI802g",
      "rating": 5,
      "text": "This is a fun place with drinks served up in the inside bar, then outside there are a bunch of food trucks, as well as many seating areas (including several with their own fire pits).  Service at the bar wasn't the most friendly I've seen.  It wasn't that busy, but the people behind the bar seemed put off to have to serve someone.  But the people in the various food trucks were very friendly (independent I assume).  And the atmosphere is super cool.",
      "url": "https://www.yelp.com/biz/cosmic-austin?hrid=cLAjIjGT_HsbR1sOmI802g",
      "author_name": "Kirk H.",
      "author_id": "_HV8_l0vrXqIPG91oFkT7w",
      "author_url": "https://www.yelp.com/user_details?userid=_HV8_l0vrXqIPG91oFkT7w",
      "author_image_url": "https://s3-media0.fl.yelpcdn.com/photo/3--oy_nSp27MZNmvyK70Ow/180s.jpg",
      "published_at": "2026-10-14T17:08:06Z",
      "likes": 0,
      "image_urls": null,
      "owner_response_text": "Hi, thank you so much for taking the time to leave a review. We’re glad you enjoyed the atmosphere, outdoor seating, fire pits, and variety of food trucks. We also appreciate your honest feedback about the bar service, and we’re sorry that part of your experience felt less welcoming. We’ll be sure to share your comments with the team as we continue working to provide a great experience for everyone. We hope to see you again soon!",
      "owner_response_published_at": "2026-10-16T14:12:56Z"
    },
    {
      "review_id": "BRMWkxDPKhqVkruHFIXxcQ",
      "rating": 1,
      "text": "Very poor service. I went on 10/8 at 8pm and the dirty blonde bartender with bumper sticker tattoos did not let me order a round on my tab that was already open. After waiting in a long line, I was the only one she ID'd.. even though my tab was open?! She refused to serve me, was very rude, and unwelcoming. I'll be sharing my experience on the socials until I hear back.",
      "url": "https://www.yelp.com/biz/cosmic-austin?hrid=BRMWkxDPKhqVkruHFIXxcQ",
      "author_name": "Frank M.",
      "author_id": "TuLrJN_eKYTCUsV3Ko53EA",
      "author_url": "https://www.yelp.com/user_details?userid=TuLrJN_eKYTCUsV3Ko53EA",
      "author_image_url": null,
      "published_at": "2026-10-09T01:47:49Z",
      "likes": 0,
      "image_urls": null,
      "owner_response_text": "Hi, thank you for bringing this to our attention. We’re sorry to hear about your experience and understand how frustrating it must have been to wait in line and then feel unwelcome when attempting to order. We take concerns about service seriously and will be addressing this with our team.",
      "owner_response_published_at": "2026-10-16T14:12:24Z"
    }
  ],
  "place": {
    "title": "Cosmic",
    "rating": 4.6
  }
}

The output of a real call, each list cut to 3 items.