---
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`

## Request

- Base URL: `https://api.exfunc.dev`
- URL: `https://api.exfunc.dev/yelp/get-business-reviews`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/carvedai/apis/exfunc-apis/docs/yelp/get-business-reviews/post.ts> (a function with typed inputs; its response is checked against the schema)

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.dev/carvedai/apis/exfunc-apis.md) - [All operations](https://skmtc.dev/carvedai/apis/exfunc-apis/llms.txt) - [OpenAPI document](https://skmtc.dev/carvedai/apis/exfunc-apis/revisions/22587fdf9a5e?raw)