Hemmings listing
One Hemmings listing by link. Classifieds: title, location, price, sold flag and price, watchers and page views, VIN, odometer, engine, body style, colours, transmission, stock number, city/state/ZIP, seller type, dealer id and inventory link, full description, all photos, videos, monthly payment estimate and the dealer's other listings. Auctions and Make Offer listings: status, asking price, current bid, bid count and bid history (amount, bidder's site name, time), minimum bid, reserve status, buyer's fee, start/end dates, views and watchers, location, specs, categories, description sections, all photos and videos. Private sellers come back with the username the site shows (seller_name), never contact details. latest=true with search filters returns the first current listing of that search. When the full auction page is briefly unavailable, the auction comes back without description, specs and photos and with partial: true.
Every response includes credits_used: the credits this call cost.
Part of the Hemmings API: 8 endpoints with prices, use cases and example responses.
Parameters
| name | type | description |
|---|---|---|
url | string | A hemmings.com listing link: /classifieds/listing/<slug> (classified) or /listing/<slug> or /auction/<slug> (auction, Make Offer). |
slug | string | Instead of url: the listing's slug, with kind. |
kind | classified | auction | With slug: classified or auction (default auction). |
latest | boolean | Return the first current listing of a search made with the other params (e.g. make=ford&listing_type=classified). |
make | string | With latest=true: search filter. |
listing_type | string | With latest=true: search filter. |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/hemmings/v1/listing?latest=true&make=ford&listing_type=classified" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/hemmings/v1/listing",
params={"latest": "true", "make": "ford", "listing_type": "classified"},
headers={"x-api-key": os.environ["APISH_KEY"]},
timeout=120,
)
res.raise_for_status()
data = res.json() const url = new URL("https://api.api.sh/hemmings/v1/listing");
url.searchParams.set("latest", "true");
url.searchParams.set("make", "ford");
url.searchParams.set("listing_type", "classified");
const res = await fetch(url, { headers: { "x-api-key": process.env.APISH_KEY } });
if (!res.ok) throw new Error(`${res.status} ${await res.text()}`);
const data = await res.json(); Response
A JSON object with the fields described above, plus raw (the source's own data), cached, fetched_at and credits_used. Errors return {"success": false, "error": "…"} with the HTTP status (see errors). A lookup that ran but found nothing (404) costs the price above; refused calls and errors on our side are free (what's charged).
Example response (real call, trimmed: lists cut to 2 items, long text shortened, raw left out)
{"kind": "classified","id": 2976737,"title": "1931 Ford Model A Pickup","location": "Morgantown, Pennsylvania","price": 24900,"price_text": "$24,900","sold": false,"sold_price": null,"watching": null,"page_views": null,"vin": "A4775142","odometer": 359,"engine": null,"body_style": "Pickup","exterior_color": "Brewster Green","interior_color": "Black","transmission": "Manual","stock_number": "8958","city": "Morgantown","state": "PA","zip": "19543","country_code": "USA","seller_type": "dealer","dealer": {"id": 1148,"inventory_url": "https://www.hemmings.com/classifieds/dealer/classic_auto_mall_inc"},"description": "1931 Ford Model A Pickup\n\n ''The first truck ever powered by internal combustion was designed and built in 1896 by Gottlieb Daimler of Germa…","sections": [{"title": "Summary","text": "1931 Ford Model A Pickup\n\n ''The first truck ever powered by internal combustion was designed and built in 1896 by Gottlieb Daimler of Germa…"}],"images": ["https://image.hmn.com/ajAlM6QOjHjsv8OORBjQwAQd6u0=/1471x0/filters:format(webp)/uimage/162082485.jpg","https://image.hmn.com/l3dyzU0gYfkVlSzTccn6_GtwDXg=/1621x0/filters:format(webp)/uimage/162082491.jpg","… 97 more"],"image_count": 99,"videos": [],"monthly_payment_estimate": null,"more_from_seller": [{"id": 2975459,"title": "1969 Buick Wildcat Convertible","price": 22900,"year": 1969,"location": "Morgantown, PA","url": "https://www.hemmings.com/classifieds/listing/1969-buick-wildcat-morgantown-pa-2975459"},{"id": 2939946,"title": "1965 Ford Mustang Hardtop","price": 18000,"year": 1965,"location": "Morgantown, PA","url": "https://www.hemmings.com/classifieds/listing/1965-ford-mustang-morgantown-pa-2939946"},"… 4 more"],"url": "https://www.hemmings.com/classifieds/listing/1931-ford-model-a-morgantown-pa-2976737","cached": false,"credits_used": 1}