ServiceBuddy Auto Repair Savings

Find the best current auto-service deal near a US ZIP or metro and see what you'd actually pay. Returns the local typical price for the service (oil change, brakes, battery, diagnostic, coolant flush, tire rotation, tires), the best current coupon, discount, or rebate, and the net out-of-pocket "effective price" after discounts and rebates, with caveats. Optionally compares against a shop quote the user already has. Use when someone asks what a repair should cost, whether a quote is fair, or where to find a coupon. US only; 16 major metros are priced locally, other ZIPs use national averages.

{
  "type": "object",
  "properties": {
    "zip": {
      "description": "5-digit US ZIP, e.g. \"11205\". Give zip or city for local pricing; omit both for national averages.",
      "type": "string",
      "pattern": "^\\d{5}$"
    },
    "city": {
      "description": "Metro slug, e.g. \"new-york-city\", \"los-angeles\", \"houston\". Overrides zip.",
      "type": "string"
    },
    "service_category": {
      "default": "oil_change",
      "description": "Service to price.",
      "type": "string",
      "enum": [
        "oil_change",
        "brake_pads",
        "brake_fluid_flush",
        "battery_replacement",
        "coolant_flush",
        "diagnostic",
        "tire_rotation",
        "tires_set"
      ]
    },
    "service_variant": {
      "description": "Oil type (oil_change only). Omit to evaluate each offer on its own stated oil type.",
      "type": "string",
      "enum": [
        "full_synthetic",
        "blend",
        "conventional",
        "high_mileage"
      ]
    },
    "quoted_price": {
      "description": "A quote the user already has, in USD, e.g. 119. Enables \"is this quote fair?\" comparison.",
      "type": "number",
      "exclusiveMinimum": 0
    },
    "shop_name": {
      "description": "Shop or chain the user mentioned, e.g. \"Jiffy Lube\", to prioritise that brand's deals.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string",
      "description": "Plain-English summary of the local price and best deal."
    },
    "cached": {
      "type": "boolean",
      "description": "True if served from the 12-hour deal cache."
    },
    "benchmark": {
      "type": "object",
      "properties": {
        "category": {
          "type": "string"
        },
        "variant": {
          "type": "string"
        },
        "local_midpoint": {
          "type": "number",
          "description": "Typical local price in USD, RPP-adjusted."
        },
        "local_low": {
          "type": "number"
        },
        "local_high": {
          "type": "number"
        },
        "rpp_multiplier": {
          "type": "number",
          "description": "Regional Price Parity multiplier applied to national baseline."
        }
      },
      "required": [
        "category",
        "variant",
        "local_midpoint",
        "local_low",
        "local_high",
        "rpp_multiplier"
      ],
      "additionalProperties": false
    },
    "offers_count": {
      "type": "number"
    },
    "best_match": {
      "anyOf": [
        {
          "type": "object",
          "properties": {
            "merchant": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "title": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "url": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ]
            },
            "effective_price": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Net out-of-pocket after discounts and rebates, USD."
            },
            "estimated_savings": {
              "anyOf": [
                {
                  "type": "number"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Estimated savings vs. the local benchmark, USD."
            }
          },
          "required": [
            "merchant",
            "title",
            "url",
            "effective_price",
            "estimated_savings"
          ],
          "additionalProperties": false
        },
        {
          "type": "null"
        }
      ],
      "description": "Highest-savings offer, or null if none found."
    }
  },
  "required": [
    "summary",
    "cached",
    "benchmark",
    "offers_count",
    "best_match"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}