Discover

List filter values

Existing values of a keyword facet with counts (and its coverage), optionally under filters.

POST/v1/filters/values

MCP tool list_filter_valuesscope companies:readNo record cost

Parameters

fieldstringrequired

filtersobjectoptional

limitintegeroptional

(min 1, max 200)

containsstringoptional

jobs catalogues only: keep values whose code, name or definition contains this (case-insensitive)

What your agent reads

The tool description exactly as an MCP client receives it in tools/list — it doubles as the full behaviour of the endpoint.

Existing values of a keyword facet with counts (and its coverage), optionally under filters. Values are case-sensitive — look them up instead of guessing. Jobs catalogues (versioned, with live counts): field='job_function' | 'job_family' | 'job_seniority' | 'work_category' | 'role_tag' (Role Tree v2), 'tech' (technology catalogue — use `contains` to search its 6,296 slugs), 'tech_group' (cross-category tool groups such as 'gtm-stack', for uses_tech {group, min_count}), 'intent' (intent library), 'hiring_flag'.

Request

curl -X POST "https://api.breaknorm.co/v1/filters/values" \
  -H "Authorization: Bearer $BREAKNORM_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "field": "company_type"
  }'

Response · 200

{
  "field": "company_type",
  "coverage_pct": 100,
  "values": [
    {
      "value": "service",
      "count": 23982022
    },
    {
      "value": "webshop",
      "count": 3349413
    },
    {
      "value": "portal_media",
      "count": 3185661
    },
    "… 8 more"
  ]
}