Hemmings search facet counts

GET https://api.api.sh/hemmings/v1/facets
1 credit / call automotive try it in the playground →

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

nametypedescription
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"

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}
The fastest way to see the full response is the playground: it runs this endpoint with your account and shows the exact JSON.