Yelp Business Reviews (First Page, up to 49, Relevance Order)

{
  "type": "object",
  "required": [
    "place_id"
  ],
  "properties": {
    "num": {
      "enum": [
        49
      ],
      "type": "integer",
      "default": 49,
      "description": "The number of reviews; only 49 is offered."
    },
    "start": {
      "enum": [
        0
      ],
      "type": "integer",
      "default": 0,
      "description": "The review offset; only 0 (the first page) is offered."
    },
    "place_id": {
      "type": "string",
      "minLength": 1,
      "description": "The business's Yelp ID, the place_id a Yelp business search returns for it."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "reviews": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "The review's Yelp ID."
          },
          "date": {
            "type": "string",
            "description": "When the review was posted, as an ISO 8601 UTC timestamp."
          },
          "rating": {
            "type": "number",
            "description": "The review's star rating, 1 to 5."
          },
          "comment": {
            "type": "object",
            "properties": {
              "text": {
                "type": "string",
                "description": "The review text."
              },
              "language": {
                "type": "string",
                "description": "The review's language code."
              }
            }
          },
          "feedback": {
            "type": "object",
            "properties": {
              "cool": {
                "type": "number"
              },
              "funny": {
                "type": "number"
              },
              "useful": {
                "type": "number"
              }
            },
            "description": "Votes other readers gave the review."
          },
          "position": {
            "type": "number",
            "description": "The review's place on the page, from 1."
          },
          "owner_replies": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "date": {
                  "type": "string",
                  "description": "When the reply was posted, as an ISO 8601 UTC timestamp."
                },
                "comment": {
                  "type": "string",
                  "description": "The reply text."
                }
              }
            },
            "description": "Replies from the business to the review, when it posted any."
          }
        }
      },
      "description": "The first page of reviews, up to 49, in Yelp's relevance order."
    },
    "search_information": {
      "type": "object",
      "properties": {
        "rating": {
          "type": "number",
          "description": "The business's overall star rating, out of 5."
        },
        "business": {
          "type": "string",
          "description": "The business's name on Yelp."
        },
        "total_results": {
          "type": "number",
          "description": "The business's total review count."
        },
        "rating_distribution": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "count": {
                "type": "number",
                "description": "Reviews at that star level."
              },
              "rating": {
                "type": "number",
                "description": "The star level, 1 to 5."
              }
            }
          },
          "description": "How many reviews the business has at each star level."
        }
      }
    }
  },
  "description": "The business's review summary and first page of reviews, after shaping."
}