# TheCarApi Filter facets API

**Canonical:** https://apis.io/apis/thecarapi/thecarapi-filter-facets-api/  
**Provider:** TheCarApi — https://apis.io/providers/thecarapi/  
**Base URL:** https://api.thecarapi.com  
**Documentation:** https://thecarapi.com/docs

TheCarApi Filter facets API is one of 11 APIs that [TheCarApi](https://apis.io/providers/thecarapi/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. Tagged areas include Filter facets. The published artifact set on APIs.io includes an OpenAPI specification and API documentation.

Discover live filter values and counts. Every facet endpoint accepts the search filters, so a facet describes whatever slice of inventory you are looking at rather than the whole of it — each dimension ignoring only its own filter, so a user can switch brands without the option disappearing. Counts and the totals /api/search reports for the same filters cannot disagree. Facet responses cache for about 600 seconds, and a filter sidebar can read every flat dimension in one call with /api/facets.

## Operations (9)

| Method | Path | Summary |
|---|---|---|
| GET | `/api/facets` | Every flat facet dimension in one request instead of six |
| GET | `/api/brands` | List brands with round-trippable slugs and live inventory counts |
| GET | `/api/models` | List models for one brand with live inventory counts |
| GET | `/api/years` | List registration years available in current inventory |
| GET | `/api/fuels` | List canonical fuel groups available in current inventory |
| GET | `/api/gearboxes` | List canonical gearbox groups available in current inventory |
| GET | `/api/countries` | List vehicle-location countries and display names |
| GET | `/api/sites` | List auction source slugs with live inventory counts |
| GET | `/load-models` | Return the complete model catalog grouped by brand |

## Machine-readable artifacts (4)

- **OpenAPI** — https://raw.githubusercontent.com/api-evangelist/thecarapi/refs/heads/main/openapi/thecarapi-filter-facets-api-openapi.yml
- **PostmanCollection** — https://thecarapi.com/thecarapi.postman_collection.json
- **Documentation** — https://thecarapi.com/docs
- **LLMsTxt** — https://thecarapi.com/llms.txt

## Other TheCarApi APIs (10)

- [TheCarApi Auctions & history API](https://apis.io/apis/thecarapi/thecarapi-auctions-history-api/)
- [TheCarApi Catalog API](https://apis.io/apis/thecarapi/thecarapi-catalog-api/)
- [TheCarApi European classifieds API](https://apis.io/apis/thecarapi/thecarapi-european-classifieds-api/)
- [TheCarApi Health & contract API](https://apis.io/apis/thecarapi/thecarapi-health-contract-api/)
- [TheCarApi Import calculator API](https://apis.io/apis/thecarapi/thecarapi-import-calculator-api/)
- [TheCarApi Market intelligence API](https://apis.io/apis/thecarapi/thecarapi-market-intelligence-api/)
- [TheCarApi SEO helpers API](https://apis.io/apis/thecarapi/thecarapi-seo-helpers-api/)
- [TheCarApi Top offers API](https://apis.io/apis/thecarapi/thecarapi-top-offers-api/)
- [TheCarApi Vehicle details API](https://apis.io/apis/thecarapi/thecarapi-vehicle-details-api/)
- [TheCarApi Search and Discovery API](https://apis.io/apis/thecarapi/thecarapi-search-and-discovery-api/)

## Tags

Filter facets

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/thecarapi/thecarapi-filter-facets-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/thecarapi/.