thumbtack.com

{
  "name": "get_category_recommendations",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns popular or trending home-service categories for a US ZIP code.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "title": "get_category_recommendations input",
    "description": "Returns popular or trending home-service categories by ZIP code. zipCode is optional; it is resolved from the current page or browser location when omitted. limit: default 20, range 1-30.",
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "zipCode": {
        "type": "string",
        "pattern": "^\\d{5}$",
        "description": "US ZIP code to center the search (5 digits). Optional; resolved from the current page or browser location when omitted."
      },
      "recommendationType": {
        "type": "string",
        "enum": [
          "popular",
          "trending"
        ],
        "description": "Recommendation type: 'popular' or 'trending'."
      },
      "limit": {
        "type": "integer",
        "minimum": 1,
        "maximum": 30,
        "default": 20,
        "description": "Maximum number of categories to return (default 20, range 1-30). Values above 30 are clamped to 30."
      }
    },
    "required": [
      "recommendationType"
    ]
  }
}

{
  "name": "get_reviews_for_pros",
  "kind": "answer",
  "impl": "imperative",
  "description": "Returns detailed customer reviews for specific Thumbtack businesses, grouped by business and sorted by the requested order (relevance, rating, or recency).",
  "inputSchema": {
    "$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"
    ]
  }
}

{
  "name": "search_home_service_pros",
  "kind": "answer",
  "impl": "imperative",
  "description": "Searches Thumbtack home-service pros from a free-text query and ZIP code, returning matching businesses, the best-matching category, and a request form to refine the results.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "title": "search_home_service_pros input",
    "description": "Initiates a search from a free-text user query and optional zip. zipCode is optional; it is resolved from the current page or browser location when the agent omits it.",
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "userQuery": {
        "type": "string",
        "minLength": 1,
        "description": "The complete user query/prompt describing the home service they need (e.g., 'I need a house cleaner', 'plumber for kitchen sink repair')."
      },
      "zipCode": {
        "type": "string",
        "pattern": "^\\d{5}$",
        "description": "US ZIP code to center the search (5 digits). Optional; resolved from the current page or browser location when omitted."
      }
    },
    "required": [
      "userQuery"
    ]
  }
}

{
  "name": "filter_home_service_pros",
  "kind": "act",
  "impl": "imperative",
  "description": "Refines a prior home-service search using request-form answers. There is no saved search, so pass categoryID + zipCode + the full accumulated answer set (from search_home_service_pros) on each call.",
  "inputSchema": {
    "$schema": "https://json-schema.org/draft/2020-12/schema",
    "title": "filter_home_service_pros input",
    "description": "Refines a pro search using request-form answers. There is no saved search, so pass categoryID + zipCode + the requestForm (its requestFormID plus the full accumulated answer set) on each call.",
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "zipCode": {
        "type": "string",
        "pattern": "^\\d{5}$",
        "description": "US ZIP code to center the search (5 digits)."
      },
      "categoryID": {
        "type": "string",
        "pattern": "^\\d+$",
        "description": "The Thumbtack Category ID to fetch businesses for. Obtain from search_home_service_pros."
      },
      "requestForm": {
        "type": "object",
        "additionalProperties": false,
        "description": "Request form details supplied by the agent. There is no saved search: resubmit the requestFormID plus the full accumulated set of answers each time.",
        "properties": {
          "requestFormID": {
            "type": "string",
            "description": "The Request Form ID for this category, from search_home_service_pros."
          },
          "requestFormAnswers": {
            "type": "array",
            "description": "The full accumulated set of answers to request-form questions.",
            "items": {
              "type": "object",
              "additionalProperties": false,
              "properties": {
                "questionID": {
                  "type": "string"
                },
                "answerIDs": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "freeFormAnswer": {
                  "type": "array",
                  "items": {
                    "type": "string"
                  }
                },
                "dateAnswers": {
                  "type": "array",
                  "items": {
                    "type": "string",
                    "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
                  }
                }
              },
              "required": [
                "questionID"
              ]
            }
          }
        },
        "required": [
          "requestFormID"
        ]
      }
    },
    "required": [
      "zipCode",
      "categoryID",
      "requestForm"
    ]
  }
}