Getting started

Quickstart

An integration needs two endpoints: /cars for active vehicles and /archived-lots for the ones that were sold or removed. Every call is a plain GET with your key in the x-api-key header.

1
Import the active catalog
Request /cars and go through every page (page=1, 2, 3…) until links.next is null. Save each vehicle and its lots in your database.
2
Pull updates every hour
Run /cars?minutes=60 from a cron job. It returns vehicles added or changed in the last 60 minutes: insert the new ones and update the rest.
3
Retire sold lots
In the same job request /archived-lots?minutes=60. It returns the lots that were sold or removed, with the final bid where available. Archive or delete them by lot_id.

That is the whole loop: your database stays up to date. Apply your key once on the Authentication page and every example fills in. Authentication

Import the active catalog

Pull updates every hour

Retire sold lots