diff --git a/.changeset/first-version.md b/.changeset/first-version.md
index fe387c4..f78b71b 100644
--- a/.changeset/first-version.md
+++ b/.changeset/first-version.md
@@ -10,6 +10,7 @@ First version of `meili`, the Meilisearch CLI built for coding agents.
 - Tasks: `meili get tasks`, narrowed by `--ids`, `--statuses`, `--types`, `--index-ids`, `--batch-ids`, `--canceled-by` and the date filters of the route, paging with `--limit` and `--from` and following the `next` cursor with `--all`; `meili cancel tasks` and `meili delete tasks --yes`, which take the same filters and answer a task.
 - Search: `meili search --index <index> --q <query>`, on `POST /indexes/{index_uid}/search`, with every non-experimental search parameter of the route as a flag, from `--filter` and `--sort` to `--hybrid` and `--vector`; `--data` or `--file` carries a whole search body, which a flag of the same field overrides. `meili multi-search --queries '<json>'`, on `POST /multi-search`, runs several queries in one request, each naming its index, answered side by side or merged into one ranked list with `--federation`.
 - Similar documents: `meili similar --index <index> --id <document> --embedder <embedder>`, on `POST /indexes/{index_uid}/similar`, returns the documents of the index closest to one of them, narrowed by `--filter`, `--limit` and `--offset`; `--data` or `--file` carries a whole body, which a flag of the same field overrides.
+- Facet values: `meili facet-search --index <index> --facet-name <attribute>`, on `POST /indexes/{index_uid}/facet-search`, searches the values of one filterable attribute with `--facet-query` and counts them on the documents `--q` and `--filter` keep; `--data` or `--file` carries a whole body, which a flag of the same field overrides.
 - Settings: `meili get settings --index <index>`, which returns every setting with its current value or its default; `meili update settings --index <index>`, with one flag per setting, from `--searchable-attributes` and `--stop-words` to `--typo-tolerance` and `--embedders`, where a value of `null` resets that one setting and `--data` or `--file` carries a whole settings body; `meili delete settings --index <index> --yes`, which resets them all.
 - `meili schema` prints the index of the command tree as JSON, one entry per command with its routes, and `meili schema --command "get indexes"` prints one command in full, with its key actions and whether it returns a task.
 - Connection through `--project-url` and `--project-api-key`, or `MEILI_PROJECT_URL` and `MEILI_PROJECT_API_KEY`; `MEILI_MANAGEMENT_TOKEN` and `MEILI_MANAGEMENT_URL` for the Management API.
diff --git a/docs/contract/commands.md b/docs/contract/commands.md
index 54dce1c..4c7abe8 100644
--- a/docs/contract/commands.md
+++ b/docs/contract/commands.md
@@ -28,7 +28,7 @@ Every API command declares its routes, `static routes = ["GET /indexes", "GET /i
 7. **Values.** A scalar is passed as it is. A boolean is a bare flag, `--retrieve-vectors`, unless the route also reads `false` from it, as the settings do: it then takes its value, `--facet-search false`, because a bare flag says neither `false` nor `null`. An array of scalars is comma-separated, `--fields id,title`, as the API's own GET syntax. An object or a nested array is JSON text, `--typo-tolerance '{"enabled":false}'`. The value `null` sends a JSON null, `--expires-at null`, `--stop-words null`.
 8. **Body input.** On every route with a body, `--file <path>` or `--data '<json>'` replaces the body fields; `--file -` reads stdin. Path and query flags stay valid next to them. A body-field flag given together with `--file` or `--data` overrides that field, as a flag overrides its environment variable. When a route's body is not an object of named fields but the value itself, the array of identifiers of `delete documents --ids` or the documents of `add documents`, the body is that value, and its shape selects the route among the ones the command covers: `delete documents --data '[1,2]'` deletes by identifiers, `--data '{"filter":…}'` deletes by filter. Documents are sent as JSON, the only content type the document declares.
 9. **Routes that are not implemented.** The `GET` twin of a `POST` route that takes the same parameters in a body (search, similar, the list of documents); the unit route of a resource whose list filters by identifiers (documents, tasks, batches); the settings sub-routes, since `update settings` sends any subset and `null` resets one setting; `GET /api/v2/meilisearch-versions`. Each is recorded without command in the exceptions.
-10. **Experimental routes** are out of the contract until the feature is stable. Implementing one is a contract change: an exception row with the reason. `compact` is the one exception today. A body field or a query parameter that an experimental feature gates is out of the contract the same way: the command declares no flag for it, and `--data` or `--file` still carries it to the API. `useNetwork` on `get documents`, and `media`, `personalize`, `useNetwork` and `inlineRule` on `search`. These stay out of the exceptions table, which lists routes.
+10. **Experimental routes** are out of the contract until the feature is stable. Implementing one is a contract change: an exception row with the reason. `compact` is the one exception today. A body field or a query parameter that an experimental feature gates is out of the contract the same way: the command declares no flag for it, and `--data` or `--file` still carries it to the API. `useNetwork` on `get documents`, `media`, `personalize`, `useNetwork` and `inlineRule` on `search`, and `media` and `useNetwork` on `facet-search`. These stay out of the exceptions table, which lists routes.
 11. **Destructive commands.** A command of the verb `delete` takes `--yes` and refuses to run without it: `cli_usage`, exit 2, before any network call. `--yes` is a flag to write, never a question the CLI asks, see `output.md`.
 
 | Routes | Command |
@@ -47,6 +47,7 @@ Every API command declares its routes, `static routes = ["GET /indexes", "GET /i
 | `POST …/documents/delete-batch`, `POST …/documents/delete`, `DELETE …/documents` | `meili delete documents --index <index> (--ids <ids> \| --filter <filter> \| --all) --yes` |
 | `POST /indexes/{index_uid}/search` | `meili search --index <index> --q <query>` |
 | `POST /indexes/{index_uid}/similar` | `meili similar --index <index> --id <document> --embedder <embedder>` |
+| `POST /indexes/{index_uid}/facet-search` | `meili facet-search --index <index> --facet-name <attribute>` |
 | `POST /multi-search` | `meili multi-search --queries <json> [--federation <json>]` |
 | `GET /indexes/{index_uid}/settings` | `meili get settings --index <index>` |
 | `PATCH /indexes/{index_uid}/settings` | `meili update settings --index <index> --<setting> <value>` |
diff --git a/oclif.manifest.json b/oclif.manifest.json
index d807140..634b011 100644
--- a/oclif.manifest.json
+++ b/oclif.manifest.json
@@ -3018,6 +3018,310 @@
         "tasks.js"
       ]
     },
+    "facet-search": {
+      "aliases": [],
+      "args": {},
+      "description": "Search the values of one facet attribute of an index, counted on the documents --q and --filter keep.",
+      "examples": [
+        "<%= config.bin %> <%= command.id %> --index movies --facet-name genres --facet-query ac",
+        "<%= config.bin %> <%= command.id %> --index movies --facet-name genres --facet-query ac --output json",
+        "<%= config.bin %> <%= command.id %> --index movies --facet-name genres --q horror --filter 'rating > 4'",
+        "<%= config.bin %> <%= command.id %> --index movies --data '{\"facetName\":\"genres\",\"facetQuery\":\"ac\"}'"
+      ],
+      "flags": {
+        "output": {
+          "char": "o",
+          "description": "json (default): one document, the API body as it is, indented in a terminal, compact when piped. ndjson: one item per line, list commands only, streams with --all.",
+          "name": "output",
+          "hasDynamicHelp": false,
+          "helpValue": "<mode>",
+          "multiple": false,
+          "options": [
+            "json",
+            "ndjson"
+          ],
+          "type": "option"
+        },
+        "debug": {
+          "description": "Print every HTTP request and response on stderr, secrets redacted.",
+          "name": "debug",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "project-url": {
+          "description": "Project URL, the Meilisearch instance to talk to.",
+          "name": "project-url",
+          "hasDynamicHelp": false,
+          "helpValue": "<url>",
+          "multiple": false,
+          "type": "option"
+        },
+        "project-api-key": {
+          "description": "Project API key. `-` reads it from stdin.",
+          "name": "project-api-key",
+          "hasDynamicHelp": false,
+          "helpValue": "<key>",
+          "multiple": false,
+          "type": "option"
+        },
+        "project": {
+          "description": "A project of the config file. Cannot be combined with --project-url. Required when the file has several projects.",
+          "name": "project",
+          "hasDynamicHelp": false,
+          "helpValue": "<name>",
+          "multiple": false,
+          "type": "option"
+        },
+        "index": {
+          "description": "The index to search the facet values in.",
+          "name": "index",
+          "required": true,
+          "hasDynamicHelp": false,
+          "helpValue": "<index>",
+          "multiple": false,
+          "type": "option"
+        },
+        "facet-name": {
+          "description": "The facet attribute to search in. It must be one of the filterable attributes of the index.",
+          "name": "facet-name",
+          "hasDynamicHelp": false,
+          "helpValue": "<attribute>",
+          "multiple": false,
+          "type": "option"
+        },
+        "facet-query": {
+          "description": "The terms the facet values are matched against, the first word only. Omit it to return every value, up to 100.",
+          "name": "facet-query",
+          "hasDynamicHelp": false,
+          "helpValue": "<query>",
+          "multiple": false,
+          "type": "option"
+        },
+        "q": {
+          "description": "The search terms that narrow the documents the facet values are computed on, not the values themselves.",
+          "name": "q",
+          "hasDynamicHelp": false,
+          "helpValue": "<query>",
+          "multiple": false,
+          "type": "option"
+        },
+        "filter": {
+          "description": "Filter expression, for example `rating > 4`. Its array-of-arrays form goes through --data.",
+          "name": "filter",
+          "hasDynamicHelp": false,
+          "helpValue": "<filter>",
+          "multiple": false,
+          "type": "option"
+        },
+        "matching-strategy": {
+          "description": "How the terms of --q are relaxed when there are not enough results.",
+          "name": "matching-strategy",
+          "hasDynamicHelp": false,
+          "multiple": false,
+          "options": [
+            "last",
+            "all",
+            "frequency"
+          ],
+          "type": "option"
+        },
+        "attributes-to-search-on": {
+          "description": "Restrict the search of --q to these searchable attributes, comma-separated.",
+          "name": "attributes-to-search-on",
+          "hasDynamicHelp": false,
+          "helpValue": "<fields>",
+          "multiple": false,
+          "type": "option"
+        },
+        "ranking-score-threshold": {
+          "description": "Count only the documents whose ranking score reaches this value, between 0.0 and 1.0.",
+          "name": "ranking-score-threshold",
+          "hasDynamicHelp": false,
+          "helpValue": "<number>",
+          "multiple": false,
+          "type": "option"
+        },
+        "locales": {
+          "description": "ISO-639 locales of the query, comma-separated, instead of auto-detection.",
+          "name": "locales",
+          "hasDynamicHelp": false,
+          "helpValue": "<locales>",
+          "multiple": false,
+          "type": "option"
+        },
+        "hybrid": {
+          "description": "Hybrid search as JSON, for example `{\"embedder\":\"default\",\"semanticRatio\":0.5}`.",
+          "name": "hybrid",
+          "hasDynamicHelp": false,
+          "helpValue": "<json>",
+          "multiple": false,
+          "type": "option"
+        },
+        "vector": {
+          "description": "Query vector for a user-provided embedder, comma-separated numbers.",
+          "name": "vector",
+          "hasDynamicHelp": false,
+          "helpValue": "<numbers>",
+          "multiple": false,
+          "type": "option"
+        },
+        "exhaustive-facet-count": {
+          "description": "Count the facet values exhaustively instead of estimating the counts.",
+          "name": "exhaustive-facet-count",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "file": {
+          "description": "Read the body from a file. `-` reads from stdin.",
+          "exclusive": [
+            "data"
+          ],
+          "name": "file",
+          "hasDynamicHelp": false,
+          "helpValue": "<path>",
+          "multiple": false,
+          "type": "option"
+        },
+        "data": {
+          "description": "Inline JSON body.",
+          "name": "data",
+          "hasDynamicHelp": false,
+          "helpValue": "<json>",
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "hasDynamicHelp": false,
+      "hiddenAliases": [],
+      "id": "facet-search",
+      "pluginAlias": "@meilisearch/cli",
+      "pluginName": "@meilisearch/cli",
+      "pluginType": "core",
+      "strict": true,
+      "enableJsonFlag": false,
+      "api": "meilisearch",
+      "routes": [
+        "POST /indexes/{index_uid}/facet-search"
+      ],
+      "keyActions": [
+        "search"
+      ],
+      "connectionFlags": {
+        "project-url": {
+          "description": "Project URL, the Meilisearch instance to talk to.",
+          "helpValue": "<url>",
+          "input": [],
+          "multiple": false,
+          "type": "option"
+        },
+        "project-api-key": {
+          "description": "Project API key. `-` reads it from stdin.",
+          "helpValue": "<key>",
+          "input": [],
+          "multiple": false,
+          "type": "option"
+        },
+        "project": {
+          "description": "A project of the config file. Cannot be combined with --project-url. Required when the file has several projects.",
+          "helpValue": "<name>",
+          "input": [],
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "waitFlags": {
+        "wait": {
+          "description": "Poll the task until it reaches a final status, then print the final task.",
+          "allowNo": false,
+          "type": "boolean"
+        },
+        "timeout": {
+          "description": "Maximum wait time, for example 30s, 2m. Default 60s. Only with --wait.",
+          "helpValue": "<duration>",
+          "dependsOn": [
+            "wait"
+          ],
+          "input": [],
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "paginationFlags": {
+        "limit": {
+          "description": "Passed to the API.",
+          "helpValue": "<n>",
+          "input": [],
+          "multiple": false,
+          "type": "option"
+        },
+        "offset": {
+          "description": "Passed to the API.",
+          "helpValue": "<n>",
+          "input": [],
+          "multiple": false,
+          "type": "option"
+        },
+        "all": {
+          "description": "Fetch every page. Streams with ndjson, buffers into one array with json.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "fromPaginationFlags": {
+        "limit": {
+          "description": "Passed to the API.",
+          "helpValue": "<n>",
+          "input": [],
+          "multiple": false,
+          "type": "option"
+        },
+        "from": {
+          "description": "Passed to the API: the uid the page starts at, going down.",
+          "helpValue": "<uid>",
+          "input": [],
+          "multiple": false,
+          "type": "option"
+        },
+        "all": {
+          "description": "Fetch every page. Streams with ndjson, buffers into one array with json.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "bodyInputFlags": {
+        "file": {
+          "description": "Read the body from a file. `-` reads from stdin.",
+          "helpValue": "<path>",
+          "exclusive": [
+            "data"
+          ],
+          "input": [],
+          "multiple": false,
+          "type": "option"
+        },
+        "data": {
+          "description": "Inline JSON body.",
+          "helpValue": "<json>",
+          "input": [],
+          "multiple": false,
+          "type": "option"
+        }
+      },
+      "confirmFlags": {
+        "yes": {
+          "required": true,
+          "description": "Confirm the deletion. Nothing is sent to the API without it.",
+          "allowNo": false,
+          "type": "boolean"
+        }
+      },
+      "isESM": true,
+      "relativePath": [
+        "dist",
+        "commands",
+        "facet-search.js"
+      ]
+    },
     "get:documents": {
       "aliases": [],
       "args": {},
diff --git a/src/commands/facet-search.ts b/src/commands/facet-search.ts
new file mode 100644
index 0000000..6518838
--- /dev/null
+++ b/src/commands/facet-search.ts
@@ -0,0 +1,109 @@
+import { Flags } from "@oclif/core";
+import type { HybridSearch, SearchForFacetValuesParams } from "meilisearch";
+import { type Api, BaseCommand } from "../lib/base-command.js";
+import { readJsonObjectBody } from "../lib/input.js";
+import { asJson, asNumber } from "../lib/values.js";
+
+export default class FacetSearch extends BaseCommand {
+  static api: Api = "meilisearch";
+
+  static routes = ["POST /indexes/{index_uid}/facet-search"];
+
+  static keyActions = ["search"];
+
+  static override description =
+    "Search the values of one facet attribute of an index, counted on the documents --q and --filter keep.";
+
+  static override examples = [
+    "<%= config.bin %> <%= command.id %> --index movies --facet-name genres --facet-query ac",
+    "<%= config.bin %> <%= command.id %> --index movies --facet-name genres --facet-query ac --output json",
+    "<%= config.bin %> <%= command.id %> --index movies --facet-name genres --q horror --filter 'rating > 4'",
+    '<%= config.bin %> <%= command.id %> --index movies --data \'{"facetName":"genres","facetQuery":"ac"}\'',
+  ];
+
+  static override flags = {
+    ...BaseCommand.connectionFlags,
+    index: Flags.string({
+      required: true,
+      description: "The index to search the facet values in.",
+      helpValue: "<index>",
+    }),
+    "facet-name": Flags.string({
+      description:
+        "The facet attribute to search in. It must be one of the filterable attributes of the index.",
+      helpValue: "<attribute>",
+    }),
+    "facet-query": Flags.string({
+      description:
+        "The terms the facet values are matched against, the first word only. Omit it to return every value, up to 100.",
+      helpValue: "<query>",
+    }),
+    q: Flags.string({
+      description:
+        "The search terms that narrow the documents the facet values are computed on, not the values themselves.",
+      helpValue: "<query>",
+    }),
+    filter: Flags.string({
+      description:
+        "Filter expression, for example `rating > 4`. Its array-of-arrays form goes through --data.",
+      helpValue: "<filter>",
+    }),
+    "matching-strategy": Flags.option({
+      options: ["last", "all", "frequency"] as const,
+      description: "How the terms of --q are relaxed when there are not enough results.",
+    })(),
+    "attributes-to-search-on": Flags.string({
+      description: "Restrict the search of --q to these searchable attributes, comma-separated.",
+      helpValue: "<fields>",
+    }),
+    "ranking-score-threshold": Flags.string({
+      description:
+        "Count only the documents whose ranking score reaches this value, between 0.0 and 1.0.",
+      helpValue: "<number>",
+    }),
+    locales: Flags.string({
+      description: "ISO-639 locales of the query, comma-separated, instead of auto-detection.",
+      helpValue: "<locales>",
+    }),
+    hybrid: Flags.string({
+      description:
+        'Hybrid search as JSON, for example `{"embedder":"default","semanticRatio":0.5}`.',
+      helpValue: "<json>",
+    }),
+    vector: Flags.string({
+      description: "Query vector for a user-provided embedder, comma-separated numbers.",
+      helpValue: "<numbers>",
+    }),
+    "exhaustive-facet-count": Flags.boolean({
+      description: "Count the facet values exhaustively instead of estimating the counts.",
+    }),
+    ...BaseCommand.bodyInputFlags,
+  };
+
+  async run(): Promise<void> {
+    const { flags } = await this.parse(FacetSearch);
+    const fromFlags: Partial<SearchForFacetValuesParams> = {
+      facetName: flags["facet-name"],
+      facetQuery: flags["facet-query"],
+      q: flags.q,
+      filter: flags.filter,
+      matchingStrategy: flags["matching-strategy"],
+      attributesToSearchOn: flags["attributes-to-search-on"]?.split(","),
+      rankingScoreThreshold: asNumber(flags["ranking-score-threshold"]) as number | undefined,
+      locales: flags.locales?.split(","),
+      hybrid: asJson(flags.hybrid) as HybridSearch | undefined,
+      vector: flags.vector?.split(",").map(asNumber) as number[] | undefined,
+      exhaustiveFacetCount: flags["exhaustive-facet-count"] ? true : undefined,
+    };
+
+    // The body of --file or --data first, then the flags, which override a field of it (rule 8).
+    // The undefined entries are dropped rather than spread: an absent flag would otherwise
+    // erase the field the body carries, since JSON.stringify leaves an undefined value out.
+    const params = {
+      ...readJsonObjectBody(flags),
+      ...Object.fromEntries(Object.entries(fromFlags).filter(([, value]) => value !== undefined)),
+    } as SearchForFacetValuesParams;
+
+    await this.output(await this.meilisearch.index(flags.index).searchForFacetValues(params));
+  }
+}
diff --git a/test/commands/__snapshots__/facet-search.test.ts.snap b/test/commands/__snapshots__/facet-search.test.ts.snap
new file mode 100644
index 0000000..044cd93
--- /dev/null
+++ b/test/commands/__snapshots__/facet-search.test.ts.snap
@@ -0,0 +1,101 @@
+// Vitest Snapshot v1, https://vitest.dev/guide/snapshot.html
+
+exports[`meili facet-search > passes the API error of an attribute that is not filterable through and exits 1 1`] = `
+{
+  "exitCode": 1,
+  "stderr": "{"error":{"code":"invalid_facet_search_facet_name","type":"invalid_request","message":"Attribute \`title\` is not facet-searchable. Available facet-searchable attributes patterns are: \`genres\`.","link":"https://docs.meilisearch.com/errors#invalid_facet_search_facet_name"}}
+",
+  "stdout": "",
+}
+`;
+
+exports[`meili facet-search > prints its help without any network call 1`] = `
+"Search the values of one facet attribute of an index, counted on the documents --q and --filter keep.
+
+USAGE
+  $ meili facet-search --index <index> [-o <mode>] [--debug]
+    [--project-url <url>] [--project-api-key <key>] [--project <name>]
+    [--facet-name <attribute>] [--facet-query <query>] [--q <query>] [--filter
+    <filter>] [--matching-strategy last|all|frequency]
+    [--attributes-to-search-on <fields>] [--ranking-score-threshold <number>]
+    [--locales <locales>] [--hybrid <json>] [--vector <numbers>]
+    [--exhaustive-facet-count] [--file <path> | --data <json>]
+
+FLAGS
+  -o, --output=<mode>                     json (default): one document, the API
+                                          body as it is, indented in a terminal,
+                                          compact when piped. ndjson: one item
+                                          per line, list commands only, streams
+                                          with --all.
+      --attributes-to-search-on=<fields>  Restrict the search of --q to these
+                                          searchable attributes,
+                                          comma-separated.
+      --data=<json>                       Inline JSON body.
+      --debug                             Print every HTTP request and response
+                                          on stderr, secrets redacted.
+      --exhaustive-facet-count            Count the facet values exhaustively
+                                          instead of estimating the counts.
+      --facet-name=<attribute>            The facet attribute to search in. It
+                                          must be one of the filterable
+                                          attributes of the index.
+      --facet-query=<query>               The terms the facet values are matched
+                                          against, the first word only. Omit it
+                                          to return every value, up to 100.
+      --file=<path>                       Read the body from a file. \`-\` reads
+                                          from stdin.
+      --filter=<filter>                   Filter expression, for example \`rating
+                                          > 4\`. Its array-of-arrays form goes
+                                          through --data.
+      --hybrid=<json>                     Hybrid search as JSON, for example
+                                          \`{"embedder":"default","semanticRatio"
+                                          :0.5}\`.
+      --index=<index>                     (required) The index to search the
+                                          facet values in.
+      --locales=<locales>                 ISO-639 locales of the query,
+                                          comma-separated, instead of
+                                          auto-detection.
+      --matching-strategy=<option>        How the terms of --q are relaxed when
+                                          there are not enough results.
+                                          <options: last|all|frequency>
+      --project=<name>                    A project of the config file. Cannot
+                                          be combined with --project-url.
+                                          Required when the file has several
+                                          projects.
+      --project-api-key=<key>             Project API key. \`-\` reads it from
+                                          stdin.
+      --project-url=<url>                 Project URL, the Meilisearch instance
+                                          to talk to.
+      --q=<query>                         The search terms that narrow the
+                                          documents the facet values are
+                                          computed on, not the values
+                                          themselves.
+      --ranking-score-threshold=<number>  Count only the documents whose ranking
+                                          score reaches this value, between 0.0
+                                          and 1.0.
+      --vector=<numbers>                  Query vector for a user-provided
+                                          embedder, comma-separated numbers.
+
+DESCRIPTION
+  Search the values of one facet attribute of an index, counted on the documents
+  --q and --filter keep.
+
+EXAMPLES
+  $ meili facet-search --index movies --facet-name genres --facet-query ac
+
+  $ meili facet-search --index movies --facet-name genres --facet-query ac --output json
+
+  $ meili facet-search --index movies --facet-name genres --q horror --filter 'rating > 4'
+
+  $ meili facet-search --index movies --data '{"facetName":"genres","facetQuery":"ac"}'
+
+"
+`;
+
+exports[`meili facet-search > prints the API envelope as it is in JSON 1`] = `
+{
+  "exitCode": 0,
+  "stderr": "",
+  "stdout": "{"facetHits":[{"value":"action","count":273},{"value":"animated","count":15}],"facetQuery":"ac","processingTimeMs":0}
+",
+}
+`;
diff --git a/test/commands/facet-search.test.ts b/test/commands/facet-search.test.ts
new file mode 100644
index 0000000..62a8b34
--- /dev/null
+++ b/test/commands/facet-search.test.ts
@@ -0,0 +1,136 @@
+import { describe, expect, it } from "vitest";
+import FacetSearch from "../../src/commands/facet-search.js";
+import { MEILISEARCH_URL, meilisearchHandlers } from "../helpers/meilisearch-handlers.js";
+import { recordRequests, server, useMockServer } from "../helpers/msw.js";
+import { runCli, runCommand } from "../helpers/run-command.js";
+
+useMockServer();
+
+const env = { MEILI_PROJECT_URL: MEILISEARCH_URL };
+const facetHits = [
+  { value: "action", count: 273 },
+  { value: "animated", count: 15 },
+];
+
+/** The body the CLI sent to POST /indexes/{uid}/facet-search, request by request. */
+async function bodiesOf(argv: string[]): Promise<unknown[]> {
+  const requests = await recordRequests(async () => {
+    await runCommand(FacetSearch, argv, { env });
+  });
+  return requests.map((request) => JSON.parse(request.body));
+}
+
+describe("meili facet-search", () => {
+  it("prints its help without any network call", async () => {
+    const result = await runCli(["facet-search", "--help"]);
+    expect(result.exitCode).toBe(0);
+    expect(result.stderr).toBe("");
+    expect(result.stdout).toMatchSnapshot();
+  });
+
+  it("prints the API envelope as it is in JSON", async () => {
+    server.use(meilisearchHandlers.facetSearch(facetHits));
+    const result = await runCommand(
+      FacetSearch,
+      ["--index", "movies", "--facet-name", "genres", "--facet-query", "ac", "--output", "json"],
+      { env },
+    );
+    expect(result).toMatchSnapshot();
+  });
+
+  it("sends the parameters of the route in its body", async () => {
+    server.use(meilisearchHandlers.facetSearch(facetHits));
+    const bodies = await bodiesOf([
+      "--index",
+      "movies",
+      "--facet-name",
+      "genres",
+      "--facet-query",
+      "ac",
+      "--q",
+      "horror",
+      "--filter",
+      "rating > 4",
+      "--matching-strategy",
+      "all",
+      "--attributes-to-search-on",
+      "title,overview",
+      "--ranking-score-threshold",
+      "0.7",
+      "--locales",
+      "eng,fra",
+      "--hybrid",
+      '{"embedder":"default","semanticRatio":0.5}',
+      "--vector",
+      "0.1,0.2",
+      "--exhaustive-facet-count",
+    ]);
+    expect(bodies).toEqual([
+      {
+        facetName: "genres",
+        facetQuery: "ac",
+        q: "horror",
+        filter: "rating > 4",
+        matchingStrategy: "all",
+        attributesToSearchOn: ["title", "overview"],
+        rankingScoreThreshold: 0.7,
+        locales: ["eng", "fra"],
+        hybrid: { embedder: "default", semanticRatio: 0.5 },
+        vector: [0.1, 0.2],
+        exhaustiveFacetCount: true,
+      },
+    ]);
+  });
+
+  it("takes the body from --data, which a flag of the same field overrides", async () => {
+    server.use(meilisearchHandlers.facetSearch(facetHits));
+    expect(
+      await bodiesOf([
+        "--index",
+        "movies",
+        "--data",
+        '{"facetName":"genres","filter":[["a = 1"]]}',
+      ]),
+    ).toEqual([{ facetName: "genres", filter: [["a = 1"]] }]);
+    expect(
+      await bodiesOf([
+        "--index",
+        "movies",
+        "--data",
+        '{"facetName":"genres"}',
+        "--facet-name",
+        "authors",
+      ]),
+    ).toEqual([{ facetName: "authors" }]);
+  });
+
+  it("refuses --output ndjson: the response is facet hits, not a list envelope", async () => {
+    server.use(meilisearchHandlers.facetSearch(facetHits));
+    const result = await runCommand(
+      FacetSearch,
+      ["--index", "movies", "--facet-name", "genres", "--output", "ndjson"],
+      { env },
+    );
+    expect(result.exitCode).toBe(2);
+    expect(result.stdout).toBe("");
+    expect(JSON.parse(result.stderr).error.code).toBe("cli_usage");
+  });
+
+  it("passes the API error of an attribute that is not filterable through and exits 1", async () => {
+    server.use(
+      meilisearchHandlers.apiError("/indexes/movies/facet-search", 400, {
+        message:
+          "Attribute `title` is not facet-searchable. Available facet-searchable attributes patterns are: `genres`.",
+        code: "invalid_facet_search_facet_name",
+        type: "invalid_request",
+        link: "https://docs.meilisearch.com/errors#invalid_facet_search_facet_name",
+      }),
+    );
+    const result = await runCommand(
+      FacetSearch,
+      ["--index", "movies", "--facet-name", "title", "--output", "json"],
+      { env },
+    );
+    expect(result).toMatchSnapshot();
+  });
+});
diff --git a/test/contract/__snapshots__/commands.test.ts.snap b/test/contract/__snapshots__/commands.test.ts.snap
index b9135a7..50d0fdf 100644
--- a/test/contract/__snapshots__/commands.test.ts.snap
+++ b/test/contract/__snapshots__/commands.test.ts.snap
@@ -806,6 +806,134 @@ The file holds API keys and decides where every later command goes, for every pr
         "DELETE /tasks",
       ],
     },
+    {
+      "api": "meilisearch",
+      "description": "Search the values of one facet attribute of an index, counted on the documents --q and --filter keep.",
+      "examples": [
+        "meili facet-search --index movies --facet-name genres --facet-query ac",
+        "meili facet-search --index movies --facet-name genres --facet-query ac --output json",
+        "meili facet-search --index movies --facet-name genres --q horror --filter 'rating > 4'",
+        "meili facet-search --index movies --data '{"facetName":"genres","facetQuery":"ac"}'",
+      ],
+      "flags": [
+        {
+          "description": "Project URL, the Meilisearch instance to talk to.",
+          "helpValue": "<url>",
+          "name": "project-url",
+          "type": "option",
+        },
+        {
+          "description": "Project API key. \`-\` reads it from stdin.",
+          "helpValue": "<key>",
+          "name": "project-api-key",
+          "type": "option",
+        },
+        {
+          "description": "A project of the config file. Cannot be combined with --project-url. Required when the file has several projects.",
+          "helpValue": "<name>",
+          "name": "project",
+          "type": "option",
+        },
+        {
+          "description": "The index to search the facet values in.",
+          "helpValue": "<index>",
+          "name": "index",
+          "required": true,
+          "type": "option",
+        },
+        {
+          "description": "The facet attribute to search in. It must be one of the filterable attributes of the index.",
+          "helpValue": "<attribute>",
+          "name": "facet-name",
+          "type": "option",
+        },
+        {
+          "description": "The terms the facet values are matched against, the first word only. Omit it to return every value, up to 100.",
+          "helpValue": "<query>",
+          "name": "facet-query",
+          "type": "option",
+        },
+        {
+          "description": "The search terms that narrow the documents the facet values are computed on, not the values themselves.",
+          "helpValue": "<query>",
+          "name": "q",
+          "type": "option",
+        },
+        {
+          "description": "Filter expression, for example \`rating > 4\`. Its array-of-arrays form goes through --data.",
+          "helpValue": "<filter>",
+          "name": "filter",
+          "type": "option",
+        },
+        {
+          "description": "How the terms of --q are relaxed when there are not enough results.",
+          "name": "matching-strategy",
+          "options": [
+            "last",
+            "all",
+            "frequency",
+          ],
+          "type": "option",
+        },
+        {
+          "description": "Restrict the search of --q to these searchable attributes, comma-separated.",
+          "helpValue": "<fields>",
+          "name": "attributes-to-search-on",
+          "type": "option",
+        },
+        {
+          "description": "Count only the documents whose ranking score reaches this value, between 0.0 and 1.0.",
+          "helpValue": "<number>",
+          "name": "ranking-score-threshold",
+          "type": "option",
+        },
+        {
+          "description": "ISO-639 locales of the query, comma-separated, instead of auto-detection.",
+          "helpValue": "<locales>",
+          "name": "locales",
+          "type": "option",
+        },
+        {
+          "description": "Hybrid search as JSON, for example \`{"embedder":"default","semanticRatio":0.5}\`.",
+          "helpValue": "<json>",
+          "name": "hybrid",
+          "type": "option",
+        },
+        {
+          "description": "Query vector for a user-provided embedder, comma-separated numbers.",
+          "helpValue": "<numbers>",
+          "name": "vector",
+          "type": "option",
+        },
+        {
+          "description": "Count the facet values exhaustively instead of estimating the counts.",
+          "name": "exhaustive-facet-count",
+          "type": "boolean",
+        },
+        {
+          "description": "Read the body from a file. \`-\` reads from stdin.",
+          "exclusive": [
+            "data",
+          ],
+          "helpValue": "<path>",
+          "name": "file",
+          "type": "option",
+        },
+        {
+          "description": "Inline JSON body.",
+          "helpValue": "<json>",
+          "name": "data",
+          "type": "option",
+        },
+      ],
+      "id": "facet-search",
+      "keyActions": [
+        "search",
+      ],
+      "routes": [
+        "POST /indexes/{index_uid}/facet-search",
+      ],
+    },
     {
       "api": "meilisearch",
       "description": "List the documents of an index, narrowed by --ids or by --filter.",
@@ -2074,6 +2202,13 @@ The file holds API keys and decides where every later command goes, for every pr
           "DELETE /tasks",
         ],
       },
+      {
+        "description": "Search the values of one facet attribute of an index, counted on the documents --q and --filter keep.",
+        "id": "facet-search",
+        "routes": [
+          "POST /indexes/{index_uid}/facet-search",
+        ],
+      },
       {
         "description": "List the documents of an index, narrowed by --ids or by --filter.",
         "id": "get documents",
diff --git a/test/helpers/meilisearch-handlers.ts b/test/helpers/meilisearch-handlers.ts
index acfd529..69b3fd0 100644
--- a/test/helpers/meilisearch-handlers.ts
+++ b/test/helpers/meilisearch-handlers.ts
@@ -147,6 +147,16 @@ export const meilisearchHandlers = {
       });
     }),
 
+  /**
+   * `POST /indexes/{uid}/facet-search` answering the facet values it is given,
+   * with the `facetQuery` it was sent, `null` when the body carried none.
+   */
+  facetSearch: (facetHits: Array<{ value: string; count: number }>) =>
+    http.post(`${MEILISEARCH_URL}/indexes/:uid/facet-search`, async ({ request }) => {
+      const { facetQuery } = (await request.json()) as { facetQuery?: string };
+      return HttpResponse.json({ facetHits, facetQuery: facetQuery ?? null, processingTimeMs: 0 });
+    }),
+
   /**
    * `POST /multi-search` answering `response`, whatever shape it is given: the
    * route answers one envelope per query, or the merged hits of every query
diff --git a/test/integration/meilisearch/facet-search.test.ts b/test/integration/meilisearch/facet-search.test.ts
new file mode 100644
index 0000000..ec6a922
--- /dev/null
+++ b/test/integration/meilisearch/facet-search.test.ts
@@ -0,0 +1,131 @@
+import { randomUUID } from "node:crypto";
+import { Meilisearch, type SearchForFacetValuesResponse } from "meilisearch";
+import { afterAll, beforeAll, describe, expect, it } from "vitest";
+import { runBinary } from "../../helpers/run-binary.js";
+import { MASTER_KEY, MEILISEARCH_URL, meilisearchAvailable } from "./setup.js";
+
+const meilisearchUp = await meilisearchAvailable();
+
+const env = { MEILI_PROJECT_URL: MEILISEARCH_URL, MEILI_PROJECT_API_KEY: MASTER_KEY };
+const uid = `meili-cli-test-facet-search-${randomUUID().slice(0, 8)}`;
+const documents = [
+  { id: 1, title: "Nosferatu", genre: "horror", rating: 4.5 },
+  { id: 2, title: "Dracula", genre: "horror", rating: 4 },
+  { id: 3, title: "Solaris", genre: "scifi", rating: 4.8 },
+];
+
+describe.skipIf(!meilisearchUp)("meili facet-search against a real Meilisearch", () => {
+  const client = new Meilisearch({ host: MEILISEARCH_URL, apiKey: MASTER_KEY });
+
+  beforeAll(async () => {
+    await client.createIndex(uid, { primaryKey: "id" }).waitTask();
+    await client
+      .index(uid)
+      .updateSettings({ filterableAttributes: ["genre", "rating"] })
+      .waitTask();
+    await client.index(uid).addDocuments(documents).waitTask();
+  });
+
+  afterAll(async () => {
+    await client.deleteIndex(uid).waitTask();
+  });
+
+  it("returns the facet values that match --facet-query, with their counts", async () => {
+    const result = await runBinary(
+      [
+        "facet-search",
+        "--index",
+        uid,
+        "--facet-name",
+        "genre",
+        "--facet-query",
+        "ho",
+        "--output",
+        "json",
+      ],
+      env,
+    );
+    expect(result.exitCode).toBe(0);
+    expect(result.stderr).toBe("");
+    const body = JSON.parse(result.stdout) as SearchForFacetValuesResponse;
+    expect(body.facetQuery).toBe("ho");
+    expect(body.facetHits).toEqual([{ value: "horror", count: 2 }]);
+  });
+
+  it("returns every value of the facet without --facet-query", async () => {
+    const result = await runBinary(
+      ["facet-search", "--index", uid, "--facet-name", "genre", "--output", "json"],
+      env,
+    );
+    expect(result.exitCode).toBe(0);
+    const body = JSON.parse(result.stdout) as SearchForFacetValuesResponse;
+    expect(body.facetQuery).toBeNull();
+    expect(body.facetHits).toEqual([
+      { value: "horror", count: 2 },
+      { value: "scifi", count: 1 },
+    ]);
+  });
+
+  it("counts the values on the documents --filter keeps", async () => {
+    const result = await runBinary(
+      [
+        "facet-search",
+        "--index",
+        uid,
+        "--facet-name",
+        "genre",
+        "--filter",
+        "rating > 4.2",
+        "--output",
+        "json",
+      ],
+      env,
+    );
+    expect(result.exitCode).toBe(0);
+    const body = JSON.parse(result.stdout) as SearchForFacetValuesResponse;
+    expect(body.facetHits).toEqual([
+      { value: "horror", count: 1 },
+      { value: "scifi", count: 1 },
+    ]);
+  });
+
+  it("sends the body of --data, which a flag of the same field overrides", async () => {
+    const result = await runBinary(
+      [
+        "facet-search",
+        "--index",
+        uid,
+        "--data",
+        JSON.stringify({ facetName: "genre", facetQuery: "sc" }),
+        "--facet-query",
+        "ho",
+        "--output",
+        "json",
+      ],
+      env,
+    );
+    expect(result.exitCode).toBe(0);
+    const body = JSON.parse(result.stdout) as SearchForFacetValuesResponse;
+    expect(body.facetHits).toEqual([{ value: "horror", count: 2 }]);
+  });
+
+  it("lets the API refuse an attribute that is not filterable, with its own code", async () => {
+    const result = await runBinary(
+      ["facet-search", "--index", uid, "--facet-name", "title", "--output", "json"],
+      env,
+    );
+    expect(result.exitCode).toBe(1);
+    expect(result.stdout).toBe("");
+    expect(JSON.parse(result.stderr).error.code).toBe("invalid_facet_search_facet_name");
+  });
+
+  it("exits 4 with the API error when the index does not exist", async () => {
+    const result = await runBinary(
+      ["facet-search", "--index", `${uid}-missing`, "--facet-name", "genre", "--output", "json"],
+      env,
+    );
+    expect(result.exitCode).toBe(4);
+    expect(result.stdout).toBe("");
+    expect(JSON.parse(result.stderr).error.code).toBe("index_not_found");
+  });
+});