MotorAPIs
Live catalog
Get API key

South KoreaAuction

HeyDealer for dealers API

HeyDealer dealer auctions from South Korea as JSON: vehicle details, photos, auction time and bids when shown.

Get a free demo key Read the docs

On dealer.heydealer.com

dealer.heydealer.com

In your code

{"vin": string"brand": { name }"model": { name }"year": number"listings": [{"external": {…}"auction_at": string"current_bid": number"odometer": {…}"is_auction": boolean"images": […]}]"inspections": […]"vehicle_history_reports": […]}

Field names from the real record; values are types, not data.

What is HeyDealer for dealers?

01/ 06About

About HeyDealer for dealers

HeyDealer for dealers (dealer.heydealer.com) is the side of HeyDealer where Korean dealers bid on cars that owners put up for sale, each for a short bidding window. MotorAPIs reads these cars with their auction time and current bid when the page shows them. The API only returns data; it never places a bid.

Country
South Korea
Type
Auction
API
api.motorapis.com
Website
dealer.heydealer.com

What data do I get?

02/ 06Fields

What you get from HeyDealer for dealers

Every car on the auction list, in the shared car record. Fields are filled when HeyDealer for dealers shows them.

Vehicle

  • VIN, when the site shows it
  • Make, model and generation from one shared catalog
  • Year, fuel, transmission, engine, power
  • Mileage in km

Lot

  • Site and lot ID, link to the page
  • Auction date
  • Current bid, when shown
  • Damage and condition, when shown
  • Location and photo gallery

Reports

  • Inspections, when published
  • History reports, when published

One car, many sites

  • The same car on several sites is one car
  • Sold cars stay readable for about a month

How do I ask for it?

03/ 06Requests

Three requests to start

Site IDs differ per key: read them from /domains once, then filter by them.

  1. 01Find the site ID of HeyDealer for dealers

    GET https://api.motorapis.com/domains
  x-api-key: YOUR_API_KEY

  2. 02Search its cars

    GET https://api.motorapis.com/search?domains[]={domain_id}&perPage=20
  x-api-key: YOUR_API_KEY

  3. 03Export everything and keep it in sync

    GET https://api.motorapis.com/cars?domains[]={domain_id}&limit=500
  x-api-key: YOUR_API_KEY

Anything else to know?

04/ 06FAQ

Questions about the HeyDealer for dealers API

What HeyDealer for dealers data does the API return?
Each car on the HeyDealer for dealers list as a standard car record: vehicle details, photos, location, the auction date and the current bid when HeyDealer for dealers shows them, plus inspections and history reports when published.
Can I bid on HeyDealer for dealers through MotorAPIs?
No. MotorAPIs only returns data. Bidding happens on HeyDealer for dealers itself, under its own rules for buyers.
How do I select HeyDealer for dealers in the API?
Call /domains once to read the site ID of HeyDealer for dealers for your key, then pass it as domains[] to /search or /cars.
How do I keep a copy in sync?
Use the /cars export: start without a cursor and follow next_url until it ends. Run it again to refresh your copy.
How can I try it?
Ask for a free demo key and tell us which sites you need. It returns real data in the same JSON as the paid plans.

What else is connected?

05/ 06Related

Related sources

All sources →

Ready to try it?

06/ 06Start

Get HeyDealer for dealers data in your product

Tell us which sources you need. We reply in writing with a free demo key.

Get a free demo key

MotorAPIs is an independent data provider and is not affiliated with HeyDealer for dealers. Names and trademarks belong to their owners.