---
title: "Get prompt facets"
method: GET
path: "/api/v1/prompts/facets"
tags: ["Prompts"]
---

# Get prompt facets

`GET /api/v1/prompts/facets`

## Request

- Base URL: `https://numonic.ai`
- URL: `https://numonic.ai/api/v1/prompts/facets`
- Auth: API key in header `x-api-key`

Retrieve context-aware facet counts for the prompt filter panel. Each facet dimension (categories, models, tags) is counted with all other active filters applied but not its own filter, enabling progressive Amazon/Etsy-style faceting.

## Query parameters

- `q` string: Free-text search query
- `category` string: Comma-separated category filter
- `model` string: Comma-separated model filter
- `tags` string: Comma-separated tag filter
- `has_variables` 'true' | 'false'
- `min_score` number
- `max_score` number

## Response `200`

Facet counts

- object
  - `categories` object[], required
    - `value` string, required
    - `count` integer, required
  - `models` object[], required
    - `value` string, required
    - `count` integer, required
  - `tags` object[], required
    - `value` string, required
    - `count` integer, required
  - `has_variables` object, required
    - `true` integer, required
    - `false` integer, required
  - `score_ranges` object, required
    - `excellent` integer, required
    - `good` integer, required
    - `fair` integer, required
    - `poor` integer, required
    - `unrated` integer, required

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/numonic/apis/numonic-api.md) · [All operations](https://skmtc.dev/numonic/apis/numonic-api/llms.txt) · [OpenAPI document](https://skmtc.dev/numonic/apis/numonic-api/revisions/6c559bef1e35?raw)