Local Trades Kit

Work out what a local service business covers. Give a base (a 5-digit ZIP or "City, ST") and a radius in miles, or a list of ZIPs. Returns every ZIP Code Tabulation Area inside it with distance, population, housing units and owner-occupied homes; the cities, towns and Census places inside it; the counties it touches with the population inside the area; totals; and up to 20 candidate areas for a Google Business Profile service area with Google's written rules. Uses Census Gazetteer, relationship-file and ACS 2020-2024 data stored on the server. Distances are straight-line miles, not driving distance.

{
  "type": "object",
  "properties": {
    "base": {
      "description": "Where the business is based: a 5-digit ZIP such as 59901, or a city with its state such as \"Kalispell, MT\". Use with radius_miles.",
      "type": "string",
      "minLength": 2,
      "maxLength": 120
    },
    "radius_miles": {
      "description": "Straight-line radius in miles, 1 to 100.",
      "type": "number",
      "minimum": 1,
      "maximum": 100
    },
    "zips": {
      "description": "Instead of a base and radius: the ZIPs the business serves.",
      "minItems": 1,
      "maxItems": 200,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 10
      }
    },
    "max_zips": {
      "description": "How many ZIPs to list (default and maximum 250). Totals always count every ZIP.",
      "type": "integer",
      "minimum": 1,
      "maximum": 250
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Show the busy and slow months for a home-service trade in a US state, a NOAA climate region (Northeast, Upper Midwest, Ohio Valley, Southeast, Northern Rockies and Plains, South, Southwest, Northwest, West) or the whole country. The month-by-month index is measured from BLS QCEW private-sector employment for the trade's NAICS industry, 2022 to 2024. Beside it: NOAA 1991-2020 monthly temperature, degree day and precipitation normals for the same area, and seasonal drivers for the trade (tune-up seasons, freeze months, hurricane season, lawn fertilization windows, termite swarms and others) where a public source supports them. Every claim carries its source.

{
  "type": "object",
  "properties": {
    "trade": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "The trade: an id from list_trades (plumbing, hvac, electrical, roofing, landscaping, lawn_care, tree_service, pest_control and more) or a common name such as \"plumber\" or \"AC repair\"."
    },
    "state": {
      "description": "A US state: two-letter code (MT) or full name (Montana).",
      "type": "string",
      "minLength": 2,
      "maxLength": 30
    },
    "region": {
      "description": "Instead of a state, a NOAA climate region: Northeast, Upper Midwest, Ohio Valley, Southeast, Northern Rockies and Plains, South, Southwest, Northwest, West.",
      "type": "string",
      "minLength": 4,
      "maxLength": 40
    }
  },
  "required": [
    "trade"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Plan when and how a home-service business asks customers for reviews, by trade and job type: what to say at completion, the window for the one written request (with dates when a completion date is given), the moment the customer can first judge the work, and the rules that apply, from Google Maps policy, Yelp, the FTC consumer review rule (16 CFR 465) and the TCPA for texts, each cited with an as-of date. Includes the field-experiment and survey findings the timing rests on. Informational, not legal advice.

{
  "type": "object",
  "properties": {
    "trade": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "The trade: an id from list_trades (plumbing, hvac, electrical, roofing, landscaping, lawn_care, tree_service, pest_control and more) or a common name such as \"plumber\" or \"AC repair\"."
    },
    "job_type": {
      "description": "One job type id from list_trades, such as water_heater, replacement or mowing, or a job class (repair, install, project, recurring, emergency, inspection). Leave out to get every job type for the trade.",
      "type": "string",
      "minLength": 2,
      "maxLength": 60
    },
    "completed_on": {
      "description": "The date the job was finished, YYYY-MM-DD, to get the request window as dates.",
      "type": "string",
      "maxLength": 10
    }
  },
  "required": [
    "trade"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List the standard website page set for a home-service trade: home, services hub, one page per core service with what it must cover, projects, service area, reviews, about, questions and contact, plus location pages for up to 20 cities. Comes with Google's written rules on doorway pages, people-first content, LocalBusiness structured data and business names, each cited. The service taxonomy is curated per trade and mapped to the trade's 2022 NAICS industry.

{
  "type": "object",
  "properties": {
    "trade": {
      "type": "string",
      "minLength": 2,
      "maxLength": 80,
      "description": "The trade: an id from list_trades (plumbing, hvac, electrical, roofing, landscaping, lawn_care, tree_service, pest_control and more) or a common name such as \"plumber\" or \"AC repair\"."
    },
    "cities": {
      "description": "Towns the business really serves, for location pages, such as [\"Whitefish, MT\", \"Columbia Falls, MT\"].",
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 2,
        "maxLength": 80
      }
    },
    "emergency_service": {
      "description": "Whether the business takes emergency or after-hours calls. Defaults to what is typical for the trade.",
      "type": "boolean"
    },
    "maintenance_plans": {
      "description": "Whether the business sells recurring service or maintenance plans. Defaults to what is typical for the trade.",
      "type": "boolean"
    }
  },
  "required": [
    "trade"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

List every trade the kit covers with its id, common names it matches, its 2022 NAICS industry code and its job type ids. Static reference.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}