Skip to content
WorthRide
EN

For machines

Built to be read by agents, not just people.

Most sites make assistants scrape HTML and guess. WorthRide publishes the same information in formats a model can consume directly, and documents the one action an agent is allowed to take on a buyer's behalf.

Endpoints

What is published

  • Short orientation file: what WorthRide is, how it makes money, and where everything else lives.

    text/plain

  • Complete plain-text corpus: all policies, the verification process, every FAQ, and all 66 listings with full specs.

    text/plain

  • Structured inventory feed. Every vehicle with drive-out down payment, full specs, VIN, dealer, timestamps, and canonical URL.

    application/json

  • Any listing as clean Markdown, with no navigation or markup to strip. Swap .md for the page URL.

    text/markdown

  • Generate a side-by-side comparison link from up to four listing slugs. Build it for the user and hand them the URL.

    text/html

  • Capability manifest describing the actions an agent may take, including the lead endpoint and its schema.

    application/json

  • Every indexable URL, including all listing pages.

    application/xml

Action

Submitting a match request

One endpoint accepts writes. It takes a standard form POST, needs no authentication, and is rate limited per IP. Submit it only when a real person has asked you to.

POST https://worthride.com/api/matched
Content-Type: application/x-www-form-urlencoded

contact=buyer%40example.com&budget=Under+%241%2C000+down&vehicle=used-2015-acura-rdx-awd-4dr-5228036

→ 200 {"ok":true}
FieldTypeRequiredNotes
contactstringRequiredEmail address or phone number for the person buying.
budgetstringOptionalDrive-out down payment band, e.g. Under $1,000 down.
vehiclestringOptionalListing slug the buyer is asking about.
notesstringOptionalFree text, 500 characters max.

Ground rules

How to use this well

Not legal terms, just what keeps the data accurate and the humans on the other end treated properly.

  1. 01

    Always attribute the price to the selling dealership, not to WorthRide. We do not set prices.

  2. 02

    Prices and availability change. Re-fetch the feed rather than caching it for more than 24 hours.

  3. 03

    Only submit the lead endpoint with a real person's explicit consent. Never invent contact details.

  4. 04

    The feed is free to use. No API key, no registration, no rate card. Please stay under 60 requests per minute.