thumbtack.com

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "get_reviews_for_pros input",
  "description": "Fetches detailed reviews for specific business IDs. limit: default 5, max 20 (values above 20 are clamped). When sortBy is 'most_relevant', at least one of categoryID or searchQuery is required.",
  "type": "object",
  "additionalProperties": false,
  "properties": {
    "businessIDs": {
      "type": "array",
      "minItems": 1,
      "items": {
        "type": "string",
        "pattern": "^\\d+$"
      },
      "description": "Business identifiers to get reviews for (as strings)."
    },
    "sortBy": {
      "type": "string",
      "enum": [
        "most_relevant",
        "highest_rated",
        "lowest_rated",
        "newest_first",
        "oldest_first"
      ],
      "description": "Sort order for the fetched reviews."
    },
    "categoryID": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "The Thumbtack categoryID (required with searchQuery when using most_relevant sort)."
    },
    "searchQuery": {
      "type": "string",
      "description": "The search query string (required with categoryID when using most_relevant sort)."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 5,
      "description": "Number of reviews per business to return (default 5, max 20). Values above 20 are clamped to 20."
    }
  },
  "required": [
    "businessIDs",
    "sortBy"
  ]
}