{"ok":true,"site":{"host":"thumbtack.com","url":"https://www.thumbtack.com/","type":"live","category":"Productivity & Business","desc":"Find local pros, compare prices and book home services in a few simple steps. Thumbtack makes caring for your home easier.","tools":[{"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"]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute"},{"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"]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute"},{"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"]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute"},{"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"]},"hasHandler":true,"hasExecute":true,"__source":"spec","executable":true,"handlerField":"execute"}],"apiSurface":"spec","favicon":"/favicons/thumbtack.com.png","toolCount":4}}