---
title: "Facet keywords for a signal category"
method: POST
path: "/api/v2/supersearch-enrichment/signal-keywords-facet"
tags: ["SuperSearchEnrichment"]
---

# Facet keywords for a signal category

`POST /api/v2/supersearch-enrichment/signal-keywords-facet`

Return the top matching keyword tokens for a given signal category and keyword field, aggregated from the last 90 days of signal data. Powers the Signals filter autocomplete in the Lead Finder. Unknown (category, field) pairs return 400.


Requires one of the following scopes: `supersearch_enrichments:read`, `supersearch_enrichments:all`, `all:read`, `all:all`

## Request body

- object
  - `category` string, required — Signal category to facet against (e.g. `linkedin_post_contact`).
  - `field` string, required — Indexed keyword field on `autobound_signals` to aggregate on.
  - `prefix` string — Optional case-insensitive prefix to narrow the tokens returned.
  - `limit` number — Max number of keyword buckets to return (1-100).

## Response `200`

Default Response

- object
  - `keywords` object[] — Keyword tokens ordered by descending frequency.
    - `keyword` string — The keyword token (lowercased).
    - `count` number — Number of signal records with this token in the last 90 days.

## Other responses

- `401` — This request is unauthorized (either the Authorization header is missing or invalid, or the API key has been revoked)
- `402` — This request cannot be fulfilled because the workspace does not have an active paid plan
- `404` — The requested resource was not found
- `429` — You have exceeded the rate limit. Please check the rate limit docs for more information.

---

[API](https://skmtc.net/instantly/apis/api-explorer.md) · [All operations](https://skmtc.net/instantly/apis/api-explorer/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/instantly/api-explorer/revisions/378d1e253fe7/schema)