{
  "name": "WorthRide",
  "description": "Free used-car marketplace listing real cars from one vetted, licensed Houston dealer. No buyer fees. Prices shown are drive-out down payments for the dealer's in-house financing, not retail prices. WorthRide is paid a flat referral fee by the dealer.",
  "url": "https://worthride.com",
  "documentation": "https://worthride.com/ai",
  "contact": "hello@worthride.com",
  "auth": { "type": "none" },
  "rateLimit": { "requestsPerMinute": 60 },
  "resources": [
    {
      "name": "inventory",
      "description": "Full structured inventory: drive-out down payment, specs, VIN, dealer, and listedAt timestamp for every listing.",
      "url": "https://worthride.com/api/inventory.json",
      "method": "GET",
      "contentType": "application/json"
    },
    {
      "name": "corpus",
      "description": "Entire site as one plain-text document, including all policies and listings.",
      "url": "https://worthride.com/llms-full.txt",
      "method": "GET",
      "contentType": "text/plain"
    },
    {
      "name": "listing-markdown",
      "description": "A single listing as clean Markdown. Replace {slug} with a vehicle id from the inventory feed.",
      "url": "https://worthride.com/cars/{slug}.md",
      "method": "GET",
      "contentType": "text/markdown"
    },
    {
      "name": "compare",
      "description": "Build a side-by-side comparison for a user. Provide up to four vehicle slugs, comma-separated.",
      "url": "https://worthride.com/compare?cars={slugA},{slugB}",
      "method": "GET",
      "contentType": "text/html"
    },
    {
      "name": "search",
      "description": "Human-facing filtered search. Query parameters: q, make, body, maxDown, sort.",
      "url": "https://worthride.com/browse?q={query}",
      "method": "GET",
      "contentType": "text/html"
    }
  ],
  "actions": [
    {
      "name": "submit_match_request",
      "description": "Ask WorthRide to point a buyer to matching cars and notify them of new listings. Submit only with the buyer's explicit consent, and never with invented contact details. WorthRide does not negotiate or act as the buyer's agent.",
      "url": "https://worthride.com/api/matched",
      "method": "POST",
      "contentType": "application/x-www-form-urlencoded",
      "parameters": {
        "contact": {
          "type": "string",
          "required": true,
          "description": "Buyer's email address or phone number."
        },
        "budget": {
          "type": "string",
          "required": false,
          "description": "Drive-out down payment band.",
          "enum": ["Under $1,000 down", "$1,000 to $2,500 down", "$2,500 to $5,000 down", "$5,000+ down"]
        },
        "vehicle": {
          "type": "string",
          "required": false,
          "description": "Listing slug the buyer is asking about."
        },
        "notes": {
          "type": "string",
          "required": false,
          "maxLength": 500
        }
      },
      "returns": { "ok": "boolean" }
    }
  ],
  "disclosure": "WorthRide is free for buyers, is not a dealership, lender, insurance producer, or buyer's agent, and adds no markup. Every price is set by the selling dealer and is a drive-out down payment, not a retail price. Attribute prices to the dealer."
}