BuyerAware

Create a BuyerAware API key so this user can run verdicts (3 free). Call this once when no key is configured, then show the user the key and tell them to save it. Do not call it again for someone who already has a key — one trial per email address.

{
  "type": "object",
  "properties": {
    "email": {
      "type": "string",
      "description": "the user's email address; the key is issued against it, one trial key per address"
    },
    "name": {
      "type": "string",
      "description": "optional display name for the key record"
    }
  },
  "required": [
    "email"
  ]
}

Start a BuyerAware pre-purchase verdict on ONE used vehicle. Runs a mechanic-grade read: ranked failure points with $ exposure, recalls, seller-claim fact-check, fair price range, adjusted true cost, risk score 1-10, BUY / BUY_WITH_CONDITIONS / WALK_AWAY, a word-for-word negotiation script, and lower-risk 'Tank' alternatives. Supply whichever of listing_url, listing_text or vin you have — at least one is required, and more context sharpens the verdict. Takes ~1-2 minutes: returns a job_id, then poll get_verdict. Costs 1 credit. For 'what should I buy instead' use tank_alternatives, which is free.

{
  "type": "object",
  "properties": {
    "listing_url": {
      "type": "string",
      "description": "link to the listing — Marketplace, Craigslist, AutoTrader, a dealer page"
    },
    "listing_text": {
      "type": "string",
      "description": "the listing copy pasted as-is, when there is no shareable URL"
    },
    "vin": {
      "type": "string",
      "description": "17-character VIN, if the listing shows one"
    },
    "location": {
      "type": "string",
      "description": "buyer city/state, for pricing and inspection context"
    },
    "buyer_context": {
      "type": "string",
      "description": "what the buyer needs it for, budget, and any specific concerns"
    }
  }
}

Fetch the result of an analyze_listing job. If status is 'queued' or 'running', wait ~15 seconds and call again. Free — polling never costs a credit.

{
  "type": "object",
  "properties": {
    "job_id": {
      "type": "string",
      "description": "the job_id returned by analyze_listing"
    }
  },
  "required": [
    "job_id"
  ]
}

FREE, no API key needed, answers instantly. Recommend 2-3 lower-risk used vehicles ('Tanks') from BuyerAware's curated 47-platform database that land near a budget. Use when a buyer asks what to buy instead, or what is reliable for $X. Use analyze_listing instead when they have a specific car in mind.

{
  "type": "object",
  "properties": {
    "budget": {
      "type": "number",
      "description": "target purchase price in USD"
    },
    "mileage": {
      "type": "number",
      "description": "mileage to price at; default 100000"
    },
    "category": {
      "type": "string",
      "description": "sedan, hatchback, small suv, medium suv, large suv, midsize truck, full-size truck, diesel truck, minivan, wagon, hybrid, phev, ev, luxury"
    },
    "max_risk": {
      "type": "number",
      "description": "risk ceiling 1-10; default 5"
    },
    "limit": {
      "type": "number",
      "description": "how many to return; default 3"
    }
  },
  "required": [
    "budget"
  ]
}

FREE, no API key needed, answers instantly. Look up one platform in BuyerAware's curated database: risk score, verdict, the one known trap, private-party value at a mileage, 5-year operating cost. Covers 47 US-market platforms; anything outside it returns no match, which is itself a signal — follow up with analyze_listing.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "description": "platform name, e.g. '4Runner', 'Camry V6', 'CR-V', 'Tundra 5.7'"
    },
    "mileage": {
      "type": "number",
      "description": "mileage to value at; default 100000"
    }
  },
  "required": [
    "query"
  ]
}