Hemmings search facet counts
How many Hemmings listings match each filter value for a search: counts by make, model (with a make), year, category, price band (US dollars), condition, transmission, country, buying format, seller type and available/sold status. Takes the same filters as /hemmings/v1/search; the facet of a filter you set shows only the selected value.
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 |
|---|---|---|
q | string | Keywords, e.g. shelby. |
make | string | Make name or slug, e.g. ford, mercedes-benz (see /hemmings/v1/makes). Example: ford |
model | string | Model name or slug, with make, e.g. mustang (see /hemmings/v1/models). Example: mustang |
variant_id | string | One or more variant (trim) ids, comma separated, with make and model (see /hemmings/v1/variants). |
year_min | integer | Earliest model year. |
year_max | integer | Latest model year. |
price_min | integer | Lowest price in US dollars. |
price_max | integer | Highest price in US dollars. |
seller_type | string | private or dealer (comma separated for both). |
listing_type | string | Buying format, one or more of: classified, auction, make_offer, hemmings_auctions_only, hemmings_auctions_no_reserve, hemmings_auctions_reserve_met. |
status | string | available (default on the site) or sold; comma separated for both. |
category | string | One or more of: american, classics, muscle-cars, sports-cars, trucks, used-cars, luxury-cars, suvs, 4x4s, restomods-customs, convertibles, performance-cars, late-model, other, wagons, exotics, race, european, replicas-kits, british, military, rvs-trailers-boats, japanese, electric, motorcycles. |
condition | string | One or more of: mint, excellent, good, fair, project. |
transmission | string | auto or manual. |
country | string | Country name, e.g. United States, Canada. |
state | string | Two-letter state or province code, e.g. CA, ON. |
zip | string | ZIP or postal code to search around (with distance). |
distance | integer | Miles around zip (default 100). |
images_only | boolean | Only listings with photos. |
prices_only | boolean | Only listings that show a price. |
dealer_id | string | Only this dealer's listings (the dealer.id of a result). |
Every endpoint also takes fresh, raw, fields (see lean responses and caching).
Example
curl "https://api.api.sh/hemmings/v1/facets?make=ford&model=mustang" \
-H "x-api-key: $APISH_KEY" import os, requests
res = requests.get(
"https://api.api.sh/hemmings/v1/facets",
params={"make": "ford", "model": "mustang"},
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/facets");
url.searchParams.set("make", "ford");
url.searchParams.set("model", "mustang");
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)
{"query": {"make": "ford","model": "mustang"},"facets": {"category": [{"value": "american","name": "American","count": 919,"id": 22},{"value": "muscle-cars","name": "Muscle Cars","count": 919,"id": 3},"… 8 more"],"condition": [{"value": "mint","name": "Mint","count": 32},{"value": "excellent","name": "Excellent","count": 569},"… 3 more"],"country": [{"value": "United States","name": "United States","count": 872},{"value": "Canada","name": "Canada","count": 18},"… 1 more"],"price": [{"value": "*-99.0","name": null,"count": 0,"min": null,"max": 1},{"value": "100.0-500000.0","name": null,"count": 0,"min": 1,"max": 5000},"… 4 more"],"status": [{"value": "available","name": "Available","count": 919},{"value": "sold","name": "Sold","count": 0}],"listing_type": [{"value": "auction","name": "Auction","count": 40},{"value": "classified","name": "Classified","count": 825},"… 4 more"],"make": [{"value": "ford","name": "Ford","count": 919,"id": 582}],"model": [{"value": "mustang","name": "Mustang","count": 919,"id": 8365}],"seller_type": [{"value": "private","name": "Private Seller","count": 71},{"value": "dealer","name": "Dealer/Auction House","count": 845}],"transmission": [{"value": "auto","name": "auto","count": 438},{"value": "manual","name": "manual","count": 402}],"year": [{"value": "2026","name": "2026","count": 2},{"value": "2025","name": "2025","count": 5},"… 54 more"]},"cached": false,"credits_used": 1}