# Facet Search

### Search for Vehicles by facets <a href="#search-for-vehicles-by-facets" id="search-for-vehicles-by-facets"></a>

The Vehicle Facets API allows you to narrow down the matching vehicle based on the vehicle's parameters. The facets available are: `year`, `make`, `model`, `badge`, `series`, `transmission`, `body`, `body_style`, `fuel`, `engine` and `wheelbase`.

If you would like to return aggregations of factes, use a comma-separated list in the `facets` field: eg. `facets=badge,series,transmission`.

### Facets User Interface Example <a href="#search-for-vehicles-by-facets" id="search-for-vehicles-by-facets"></a>

This function is useful when supplying data to drop-downs for display on a form. A good example of using Facets API is [Westside Auto](https://www.westsideauto.com.au/).

<figure><img src="https://content.gitbook.com/content/K6ugEamiHrCyaXQ4C4xg/blobs/6GDZ7yxZ3uWx0QdjDwd8/image.png" alt=""><figcaption></figcaption></figure>

For a preview of how facets in implemented inside the AutoGrab web app see the video below.

{% embed url="<https://www.loom.com/share/a19c3e50f95f4ed286583956c2e22693>" %}