---
title: "Get Yelp reviews for a business"
method: POST
path: "/yelp/get-business-reviews"
tags: ["Yelp"]
---

# Get Yelp reviews for a business

`POST /yelp/get-business-reviews`

Get a list of reviews on Yelp for a given business ID

## Request body

- object
  - `business_id` string, required — The ID of the business to retrieve reviews for
  - `sort_by` 'best_match' | 'newest' | 'oldest' | 'highest_rated' | 'lowest_rated' | 'elites' — The criteria to sort reviews (e.g., "best_match", "newest", etc.)
  - `page` integer — The page number of results to retrieve (default is 1)
  - `per_page` integer — The number of reviews to retrieve per page (default is 10)

## Response `200`

GetBusinessReviews API successful response

- object
  - `reviews` YelpReview[]
    - `review_id` string — Unique identifier for the review
    - `rating` number, float — Rating given in the review
    - `photos` string[] — List of photo URLs associated with the review
    - `is_updated` boolean — Indicates if the review has been updated
    - `feedback_counts` object
      - `useful` integer — Number of users who found the review useful
      - `funny` integer — Number of users who found the review funny
      - `cool` integer — Number of users who found the review cool
    - `created_time` string, date-time — Timestamp when the review was created
    - `text` string — The content of the review
    - `author_id` string — Unique identifier for the review author
    - `author_name` string — Name of the review author
    - `author_location` string — Location of the review author
    - `author_link` string, uri — Link to the author's profile
    - `author_review_count` integer — Total number of reviews written by the author

## Other responses

- `400` — User error response
- `500` — Server error response

---

[API](https://skmtc.net/carvedai/apis/exfunc-apis.md) · [All operations](https://skmtc.net/carvedai/apis/exfunc-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/carvedai/exfunc-apis/revisions/22587fdf9a5e/schema)
