# Get the filters

> Every value the search endpoints filter by, with how many videos or entries carry it: video categories (with titles and descriptions), models, colours and types; each directory section's filters, categories and sorts; and the move families.

`GET https://motionvideo.xyz/api/catalog/facets`

## Example request

```bash
curl https://motionvideo.xyz/api/catalog/facets
```

## Responses

### 200

The filter values.

| Header | Description |
| --- | --- |
| `Cache-Control` | Browsers reuse a response for 5 minutes and shared caches for an hour, then may serve it stale for up to a day while they revalidate. Value: `public, max-age=300, s-maxage=3600, stale-while-revalidate=86400` |

Body (`application/json`):

- `videos` (object, required)
  - `total` (integer, required)
  - `creators` (integer, required): How many creators have videos.
  - `categories` (array of object, required)
    - `id` (string, required) One of `product-ui`, `phone`, `charts`, `diagrams`, `kinetic-type`, `shapes`, `particles`, `characters`, `photos`, `music`, `code`.
    - `count` (integer, required)
    - `title` (string, required)
    - `description` (string, required)
    - `url` (string (uri), required)
  - `models` (array of object, required)
    - `id` (string, required) One of `Opus 5.5`, `Fable 5`, `Fable 5.1`, `Fable 5.2`, `Fable 5.5`, `Mythos 5`, `Mythos 5.2`, `GPT-6 Astra`, `Gemini 4 Argon`, `Gemini 4 Carbon`, `Gemini 4 Neon`.
    - `count` (integer, required)
    - `fullName` (string, required)
    - `family` (string, required)
  - `colors` (array of object, required)
    - `id` (string, required) One of `red`, `orange`, `yellow`, `green`, `teal`, `blue`, `purple`, `pink`, `brown`, `black`, `white`, `gray`.
    - `count` (integer, required)
    - `hex` (string, required)
  - `types` (array of FacetCount, required)
    - `id` (string, required)
    - `count` (integer, required)
  - `sorts` (array of string, required) One of `newest`, `oldest`.
- `directories` (array of object, required)
  - `section` (string, required) One of `tools`, `skills`, `creatives`, `extras`.
  - `total` (integer, required)
  - `filters` (array of FacetCount, required)
    - `id` (string, required)
    - `count` (integer, required)
  - `categories` (array of FacetCount, required)
    - `id` (string, required)
    - `count` (integer, required)
  - `sorts` (array of string, required) One of `added`, `stars`, `updated`, `newest`, `oldest`.
- `moves` (object, required)
  - `total` (integer, required)
  - `families` (array of object, required)
    - `id` (string, required) One of `timing`, `type`, `transitions`, `ui`, `vector`, `generative`, `camera`, `texture`, `data`, `sound`.
    - `count` (integer, required)

### 400

A parameter is unknown or has a value it can't take.

Body (`application/json`):

- `error` (string, required) One of `invalid_parameter`.
- `parameter` (string, required)
- `message` (string, required)
- `allowed` (array of string): The values the parameter can take, when it has a fixed set.