Search vehicle inventory across all dealers. Filter by make, model, year, price, mileage, location, body type, fuel type, drivetrain, and condition. Returns matching vehicles with dealer info. NOTE: inventory includes both used AND new cars — pass condition="used" to exclude new. Every result states its condition.
輸入參數zipcitymakelimitmodelstateoffsetagent_idyear_maxyear_minbody_typecondition另有 5 個
Get full details for a specific vehicle by VIN. Returns specs, price, mileage, photos, recalls, and dealer info.
輸入參數vin必填agent_id
Search for car dealers by city, state, or ZIP code.
輸入參數zipcitylimitstateagent_id
Get all vehicles at a specific dealer.
輸入參數limitoffsetagent_iddealer_id必填
Get the full history of a vehicle by VIN — every dealer it appeared at, price changes over time, days on market, whether it was sold and resurfaced elsewhere. Data with origin.
輸入參數vin必填agent_id
Get database statistics: total vehicles, dealers, coverage by state, top makes.
輸入參數agent_id
Create a personalized car research session for the buyer. Returns a unique URL they can bookmark and return to. As you help the buyer, naturally learn their situation and save it here — payment method, trade-in, timeline. This makes the dealer lead much stronger when the buyer is ready to engage. Don't ask all at once — gather these naturally over the conversation.
輸入參數zipnamemakesnotesradiuspaymentagent_idtimelinetrade_inbody_typesbudget_max
Read the current state of a shopping session — tracked vehicles, messages, preferences, active offers, and which other AI agents are working on it. Use this to understand context before taking action.
輸入參數session必填agent_id
Add a vehicle to the buyer's shopping session. Include a fit score (1-10) and notes explaining why you recommend it.
輸入參數vin必填notesscoresession必填agent_id
Signal buyer interest in a vehicle to the dealer. This sends a professional email to the dealership on the buyer's behalf. Only use when the buyer has explicitly indicated interest.
輸入參數vin必填messagesession必填agent_id
Post a message to the session. Use for buyer questions, AI analysis notes, or responses. The dealer and other AI agents can see these.
輸入參數content必填session必填agent_idmsg_typefrom_rolevehicle_vin
Get a structured comparison of all vehicles tracked in a session — specs, pricing, market context side by side. Great for helping the buyer decide.
輸入參數session必填agent_id
Get the current deal status — offers received, messages exchanged, unread count. Use to check if the dealer has responded.
輸入參數session必填agent_id
Send a follow-up message to the dealer continuing the conversation. Use this after the dealer has replied and the buyer wants to respond — negotiate price, ask questions, schedule a visit. The email thread continues naturally.
輸入參數vin必填message必填session必填agent_id
Set the buyer's email notification preference for this session. Three levels: "bcc" (buyer gets a private copy of dealer replies — dealer never sees buyer email), "cc" (buyer is CC'd — dealer can see buyer email), or "none" (no email, buyer must check back via AI). This upgrades the session identity level to "email".
輸入參數modeemailsession必填agent_id
Set or update the buyer's trade-in vehicle information. Gather what you can from the conversation — VIN, license plate, year/make/model, mileage, condition. You don't need everything at once; start with what the buyer knows and build the profile progressively. The dealer will make the trade-in offer based on this info. Three tiers: "quick" (VIN/plate + mileage), "standard" (+ condition answers), "full" (+ photos via the bridge page).
輸入參數vinmaketrimyearcolormodelnotesplatemileagesession必填agent_idaccidents另有 7 個
cars_session_tradein_read
Read the buyer's trade-in vehicle profile. Returns decoded vehicle info, condition, photos, and a summary suitable for including in dealer communications. Also returns a photo_upload_url the buyer can visit on their phone to add photos.
輸入參數session必填agent_id
Submit feedback about the Cars Rootz service. We actively read every piece of feedback to improve the service. Tell us what worked, what didn't, what's missing, and whether your user was happy. This helps us build a better car shopping experience for everyone.
輸入參數ratingmessage必填sessionagent_idcategory必填user_happy
Schedule a dealer visit (test drive, purchase, trade-in appraisal). Generates a visit code and QR code the buyer shows at the dealership. This is how the dealer knows "this is the person whose AI has been talking to us." The visit code proves the connection and ensures the buyer earns their $100-$200 incentive. Only use when the buyer explicitly says they want to visit the dealer.
輸入參數vin必填datetimenotessession必填agent_idvisit_type