> **For AI agents:** this page is a focused, LLM-optimized view of a
> single Fiber AI operation. Before calling it, fetch the routing
> instructions at [`https://api.fiber.ai/llms.txt`](https://api.fiber.ai/llms.txt) and the full operation
> index at [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md).

# yelpReviews

`POST /v1/yelp/reviews`

**Tags:** `Yelp`

Get Yelp business reviews

**Endpoint:** `https://api.fiber.ai/v1/yelp/reviews`

## Description

Get reviews of a Yelp business, paginated, with reviewer details, ratings, and full review text. Obtain the business ID via the /yelp/search endpoint.

⚡ Rate limit: 120 requests per 1 minute

💰 Cost: 2 credits per reviews page ⓘ

## Request body (JSON Schema)

```json
{
  "type": "object",
  "properties": {
    "apiKey": {
      "type": "string",
      "description": "Your Fiber API key"
    },
    "placeId": {
      "type": "string",
      "minLength": 1,
      "description": "Yelp business ID (e.g. 'U5hCNNyJmb7f3dmC1HTzSQ'). Obtain it from the `placeId` of a result returned by the Yelp search endpoint (`POST /v1/yelp/search`)."
    },
    "sortBy": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "relevance",
        "newestFirst",
        "oldestFirst",
        "highestRated",
        "lowestRated",
        "elitesFirst",
        null
      ],
      "description": "Sort criterion for reviews. 'relevance' is the platform's default ranking. 'elitesFirst' puts reviews from elite reviewers first. Omit to sort by relevance."
    },
    "ratings": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "integer",
        "minimum": 1,
        "maximum": 5,
        "description": "Star rating from 1 to 5."
      },
      "maxItems": 5,
      "description": "Only return reviews with these star ratings (e.g. [5] for five-star reviews only, [5, 4] for five- and four-star reviews). Omit (or pass []) to include all ratings."
    },
    "keywords": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string",
        "minLength": 1
      },
      "maxItems": 5,
      "description": "Only return reviews whose text matches these keywords (e.g. ['crust', 'delivery']). Omit (or pass []) to include all reviews."
    },
    "languageCode": {
      "type": [
        "string",
        "null"
      ],
      "minLength": 1,
      "description": "Language for review text (e.g. 'en', 'es', 'fr'). Omit for English."
    },
    "nextPageToken": {
      "type": [
        "string",
        "null"
      ],
      "minLength": 1,
      "description": "Pagination token from a prior reviews response's `nextPageToken`. Omit (or pass null) to fetch the first page."
    }
  },
  "required": [
    "apiKey",
    "placeId"
  ]
}
```

## Response — success (JSON Schema)

```json
{
  "type": "object",
  "properties": {
    "output": {
      "type": "object",
      "properties": {
        "reviews": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "authorName": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Reviewer's display name."
              },
              "authorLocation": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Reviewer's location (e.g. 'Austin, TX')."
              },
              "authorIsElite": {
                "type": [
                  "boolean",
                  "null"
                ],
                "description": "True when the reviewer has elite status on Yelp."
              },
              "rating": {
                "type": "integer",
                "minimum": 1,
                "maximum": 5,
                "description": "Star rating given by the reviewer, from 1 to 5."
              },
              "date": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Review date in ISO 8601 format."
              },
              "text": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Review text."
              },
              "languageCode": {
                "type": [
                  "string",
                  "null"
                ],
                "description": "Language of the review text (e.g. 'en')."
              },
              "photoUrls": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "Photo URLs attached to the review."
              },
              "usefulCount": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "Number of 'useful' votes the review received."
              },
              "funnyCount": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "Number of 'funny' votes the review received."
              },
              "coolCount": {
                "type": [
                  "integer",
                  "null"
                ],
                "description": "Number of 'cool' votes the review received."
              }
            },
            "required": [
              "rating",
              "photoUrls"
            ]
          },
          "description": "Reviews of the business."
        },
        "totalReviewCount": {
          "type": [
            "integer",
            "null"
          ],
          "description": "Total number of reviews for the business."
        },
        "nextPageToken": {
          "type": [
            "string",
            "null"
          ],
          "description": "Token to retrieve the next page. Pass as `nextPageToken` in the next request. Null if no more pages."
        }
      },
      "required": [
        "reviews"
      ]
    },
    "chargeInfo": {
      "oneOf": [
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charged-now"
              ]
            },
            "creditsCharged": {
              "type": "number"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsCharged"
          ],
          "description": "Credits were charged immediately for this operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charging-later"
              ]
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "message"
          ],
          "description": "Credits will be charged after the operation completes"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "charged-for-async-process"
              ]
            },
            "creditsCharged": {
              "type": "number"
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsCharged",
            "message"
          ],
          "description": "Credits that were charged for an asynchronous operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "free"
              ]
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "message"
          ],
          "description": "No credits were charged for this operation"
        },
        {
          "type": "object",
          "properties": {
            "method": {
              "type": "string",
              "enum": [
                "credits-refunded"
              ]
            },
            "creditsRefunded": {
              "type": "number"
            },
            "message": {
              "type": "string"
            },
            "lowCreditAlert": {
              "type": [
                "object",
                "null"
              ],
              "properties": {
                "getMoreCreditsUrl": {
                  "type": "string",
                  "format": "uri",
                  "description": "URL to top up credits or restart billing cycle to get fresh credits."
                },
                "message": {
                  "type": "string",
                  "description": "Human-readable credits warning."
                },
                "availableCredits": {
                  "type": "number",
                  "description": "Number of credits remaining in the current billing period."
                }
              },
              "required": [
                "getMoreCreditsUrl",
                "message",
                "availableCredits"
              ],
              "description": "Contains a link to get more credits, a warning message, and the remaining credit count."
            }
          },
          "required": [
            "method",
            "creditsRefunded",
            "message"
          ],
          "description": "Credits were refunded for this operation"
        }
      ]
    },
    "warnings": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "object",
        "properties": {
          "field": {
            "type": "string",
            "description": "Full path to extraneous field (e.g., 'searchParams.ExtraField')"
          },
          "message": {
            "type": "string",
            "description": "Warning message"
          }
        },
        "required": [
          "field",
          "message"
        ]
      },
      "description": "Warnings about extraneous fields in request"
    },
    "advice": {
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "string"
      },
      "description": "Tips, recommendations, and suggestions for using this API effectively."
    }
  },
  "required": [
    "output",
    "chargeInfo"
  ],
  "additionalProperties": false
}
```

---

Canonical JSON: [`https://api.fiber.ai/openapi.json`](https://api.fiber.ai/openapi.json)
Operation index: [`https://api.fiber.ai/ai-docs/index.md`](https://api.fiber.ai/ai-docs/index.md)