Use this to decide which filters to offer in your app before you offer them: which sports get a story ring, which sections get a tab, which authors get a row. One request replaces probing /v1/feed/filter once per value.The counts are over exactly the content the feed serves — published, ready, non-deleted items of a supported type — and honour the same exclude.* and media-negotiation rules as filtered feeds. For any value v, counts[v] equals the number of items a feed filtered to v would page through.
Authenticate with a publishable key (X-API-Key: pk_…). The endpoint is safe to call from client apps on every launch: responses are cached for 60 seconds per organisation and query.
Query parameters
string
required
The dimension to break the catalogue down by. One of tags, section, author, content_type, or metadata.<key> for a custom metadata field (for example metadata.sport). These are the same include dimensions FeedFilter accepts.
integer
default:"0"
Drop values with fewer than this many matching items. Use it to hide filters that would open a nearly empty feed.
string
Comma-separated values to exclude before counting. Also accepts exclude.sections, exclude.authors, exclude.content_types and exclude.metadata.<key>, with the same semantics as the feed’s exclusion filters.
Response
string
The dimension that was counted, echoed back.
object
A map of value → number of matching items, ordered by count descending, then value ascending. Each item counts once per distinct value it carries, so an item tagged baseball and bats appears in both counts.
Counts are per organisation and reflect the catalogue at the time of the request (up to 60 seconds of caching).
Only values that can be requested are listed: string tags with no commas or whitespace, non-empty sections and authors, and string metadata values.
Organisations on the discovery feed see counts for the discovery pool (video and live stream content), which match that pool’s X-Pool-Size header for the same filter.
For the SDK side of this — opening a filtered feed from a tapped tile — see per-tile feeds.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"shortkit","description":"Drop-in short-form video feeds for your app. TikTok-quality video experience without the infrastructure complexity.","colors":{"primary":"#181818","light":"#FAFAFA","dark":"#181818"},"logo":{"light":"https://mintcdn.com/shortkit-d6329983/xRYeGsJb7E_Zbka4/logo/light.svg?fit=max\u0026auto=format\u0026n=xRYeGsJb7E_Zbka4\u0026q=85\u0026s=6e9cf028d262e4df25460990c6b6fb92","dark":"https://mintcdn.com/shortkit-d6329983/xRYeGsJb7E_Zbka4/logo/dark.svg?fit=max\u0026auto=format\u0026n=xRYeGsJb7E_Zbka4\u0026q=85\u0026s=3fb8423af1636034446e105862945831","href":"https://shortkit.dev"},"favicon":"https://mintcdn.com/shortkit-d6329983/xRYeGsJb7E_Zbka4/favicon.svg?fit=max\u0026auto=format\u0026n=xRYeGsJb7E_Zbka4\u0026q=85\u0026s=32b084e8c8fac95e722b85a1f4c7c735","api":{"playground":{"display":"simple"},"mdx":{"auth":{"method":"bearer"},"server":"https://api.shortkit.dev"}},"background":{"color":{"light":"#FFFFFF","dark":"#111111"}},"navbar":{"links":[{"href":"https://shortkit.dev","label":"Home"}],"primary":{"type":"button","label":"Contact Us","href":"https://calendly.com/michael-shortkit/20-min-meeting"}},"footer":{},"fonts":{"heading":{"family":"Manrope","weight":500},"body":{"family":"Manrope","weight":400}},"styling":{"codeblocks":{"theme":{"light":"github-light-default","dark":"github-dark-default"}},"latex":false},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"navigation":{"global":{"anchors":[]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"shortkit-d6329983","hasAudioNarration":false,"actualSubdomain":"shortkit-d6329983","customDomains":["docs.shortkit.dev"],"gitSource":{"type":"github","owner":"shortkit","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6b0236c86418b78986140664","clientVersion":"0.0.4270","searchFilterCounts":[{"language":"default","tag":"API Reference","count":39},{"language":"default","tag":"Reference","count":36},{"language":"default","tag":"Docs","count":17},{"language":"default","tag":"Content","count":16},{"language":"default","tag":"Live Streams","count":8},{"language":"default","tag":"Surveys","count":7},{"language":"default","tag":"Analytics \u0026 Events","count":6},{"language":"default","tag":"Build Your Experience","count":5},{"language":"default","tag":"Ad Configuration","count":3},{"language":"default","tag":"Overview","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"treatment","enabled":true,"payload":{"type":"string","value":"treatment"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"/* cyrillic-ext */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhGq3-OXg.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhPq3-OXg.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhIq3-OXg.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhEq3-OXg.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhFq3-OXg.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 400;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhLq38.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhGq3-OXg.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhPq3-OXg.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhIq3-OXg.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhEq3-OXg.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhFq3-OXg.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 500;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhLq38.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n/* cyrillic-ext */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhGq3-OXg.woff2) format('woff2');\n unicode-range: U+0460-052F, U+1C80-1C8A, U+20B4, U+2DE0-2DFF, U+A640-A69F, U+FE2E-FE2F;\n}\n/* cyrillic */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhPq3-OXg.woff2) format('woff2');\n unicode-range: U+0301, U+0400-045F, U+0490-0491, U+04B0-04B1, U+2116;\n}\n/* greek */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhIq3-OXg.woff2) format('woff2');\n unicode-range: U+0370-0377, U+037A-037F, U+0384-038A, U+038C, U+038E-03A1, U+03A3-03FF;\n}\n/* vietnamese */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhEq3-OXg.woff2) format('woff2');\n unicode-range: U+0102-0103, U+0110-0111, U+0128-0129, U+0168-0169, U+01A0-01A1, U+01AF-01B0, U+0300-0301, U+0303-0304, U+0308-0309, U+0323, U+0329, U+1EA0-1EF9, U+20AB;\n}\n/* latin-ext */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhFq3-OXg.woff2) format('woff2');\n unicode-range: U+0100-02BA, U+02BD-02C5, U+02C7-02CC, U+02CE-02D7, U+02DD-02FF, U+0304, U+0308, U+0329, U+1D00-1DBF, U+1E00-1E9F, U+1EF2-1EFF, U+2020, U+20A0-20AB, U+20AD-20C4, U+2113, U+2C60-2C7F, U+A720-A7FF;\n}\n/* latin */\n@font-face {\n font-family: 'Roboto Mono';\n font-style: normal;\n font-weight: 600;\n font-display: swap;\n src: url(/_mintlify/assets/fonts/google/s/robotomono/v31/L0x5DF4xlVMF-BfR8bXMIjhLq38.woff2) format('woff2');\n unicode-range: U+0000-00FF, U+0131, U+0152-0153, U+02BB-02BC, U+02C6, U+02DA, U+02DC, U+0304, U+0308, U+0329, U+2000-206F, U+20AC, U+2122, U+2191, U+2193, U+2212, U+2215, U+FEFF, U+FFFD;\n}\n:root{--sk-ink: #181818;--sk-muted: #686868;--sk-line: #e4e4e4;--sk-soft: #f5f5f5;--sk-soft-2: #f4f4f5;--sk-paper: #ffffff;--sk-hover: #383838;--sk-mono: 'Roboto Mono', ui-monospace, SFMono-Regular, Menlo, monospace;--sk-radius-card: 14px;--sk-radius-control: 8px}html.dark,.dark{--sk-ink: #ededed;--sk-muted: #9a9a9a;--sk-line: #262626;--sk-soft: #181818;--sk-soft-2: #1c1c1c;--sk-paper: #111111;--sk-hover: #d4d4d4}html{-webkit-font-smoothing:antialiased;-moz-osx-font-smoothing:grayscale}::selection{background:#181818;color:#ffffff}html.dark ::selection{background:#ededed;color:#111111}*:focus-visible{outline:2px solid #767676!important;outline-offset:2px}#page-title,.mdx-content h1,.mdx-content h2,.mdx-content h3,.mdx-content h4{color:var(--sk-ink)}#page-title{font-weight:500!important;letter-spacing:-0.035em!important}.mdx-content h2{font-weight:500;letter-spacing:-0.03em}.mdx-content h3,.mdx-content h4{font-weight:550;letter-spacing:-0.02em}.eyebrow{font-family:var(--sk-mono)!important;font-size:11px!important;font-weight:500!important;letter-spacing:0.14em;text-transform:uppercase;color:var(--sk-muted)!important}.sidebar-group-header{font-family:var(--sk-mono);font-size:11px;font-weight:500;text-transform:uppercase;letter-spacing:0.14em;color:var(--sk-muted)!important}:not(pre)>code{font-family:var(--sk-mono)!important;background:var(--sk-soft-2)!important;border:1px solid var(--sk-line)!important;border-radius:5px!important;padding:0.1rem 0.35rem!important;color:var(--sk-ink)!important;font-size:0.85em}.mdx-content a:not(.card):not([class*=\"card\"]){text-decoration-color:#b5b5b5;text-underline-offset:4px;transition:color 0.15s ease, text-decoration-color 0.15s ease}.mdx-content a:not(.card):not([class*=\"card\"]):hover{color:var(--sk-hover)!important;text-decoration-color:currentColor}html.dark .mdx-content a:not(.card):not([class*=\"card\"]){text-decoration-color:#555555}#navbar{background:rgba(255, 255, 255, 0.98)!important;border-bottom:1px solid var(--sk-line)!important}html.dark #navbar{background:rgba(17, 17, 17, 0.96)!important}#navbar .nav-logo{height:1.625rem!important}.nav-tabs-item[data-active=\"true\"]{color:var(--sk-ink)!important}.nav-tabs-item[data-active=\"true\"]>div:last-child{background-color:var(--sk-ink)!important}#topbar-cta-button a>span:first-child{background:#181818!important;border-radius:var(--sk-radius-control)!important;opacity:1!important}#topbar-cta-button a:hover>span:first-child{background:#383838!important}html.dark #topbar-cta-button a>span:first-child{background:#ededed!important}html.dark #topbar-cta-button a:hover>span:first-child{background:#ffffff!important}html.dark #topbar-cta-button a .text-white,html.dark #topbar-cta-button a svg{color:#111111!important}#topbar-cta-button a{padding-left:0.875rem!important;padding-right:0.75rem!important}#search-bar-entry{border-radius:var(--sk-radius-control)!important;border-color:var(--sk-line)!important}#sidebar,#sidebar-content{border-color:var(--sk-line)!important}#sidebar-content button[aria-expanded] svg,#sidebar-content [data-state]>svg{display:none!important}#sidebar-content button[aria-expanded]{display:flex!important;align-items:center!important;width:100%;position:relative}#sidebar-content button[aria-expanded]::after{content:'';display:inline-block;width:12px;height:12px;min-width:12px;flex-shrink:0;background-color:currentColor;opacity:0.4;-webkit-mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpolyline points='9 18 15 12 9 6'/%3E%3C/svg%3E\") center / contain no-repeat;mask:url(\"data:image/svg+xml,%3Csvg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 24 24' fill='none' stroke='currentColor' stroke-width='2.5' stroke-linecap='round' stroke-linejoin='round'%3E%3Cpolyline points='9 18 15 12 9 6'/%3E%3C/svg%3E\") center / contain no-repeat;margin-left:auto;transition:transform 0.2s ease, opacity 0.2s ease}#sidebar-content button[aria-expanded=\"true\"]::after{transform:rotate(90deg);opacity:0.6}#sidebar-content a[class*=\"bg-primary/10\"]{background:var(--sk-soft-2)!important;color:var(--sk-ink)!important;border-radius:var(--sk-radius-control)!important}html.dark #sidebar-content a[class*=\"bg-primary/10\"]{background:#1f1f1f!important}#sidebar-content a{padding-left:1.5rem!important;border-radius:var(--sk-radius-control)!important}.toc-item[data-active=\"true\"]>a{color:var(--sk-ink)!important;font-weight:550}pre,pre code,.code-block code,.code-group code{font-family:var(--sk-mono)!important}.code-block,.code-group{border-radius:12px!important;border-color:var(--sk-line)!important;box-shadow:none!important}.code-group{background:var(--sk-soft)!important}.code-block [data-component-part=\"code-block-root\"]{border-radius:11px}.code-group [role=\"tab\"],.code-group [role=\"tablist\"] button{font-family:var(--sk-mono)!important;font-size:12px!important;font-weight:500!important}.code-group [role=\"tab\"][aria-selected=\"true\"],.code-group [role=\"tab\"][data-selected],.code-group [role=\"tab\"][data-active=\"true\"]{color:var(--sk-ink)!important}ul[role=\"tablist\"][data-component-part=\"tabs-list\"]{border-bottom:1px solid var(--sk-line)!important}[data-component-part=\"tab-button\"]{font-family:var(--sk-mono)!important;font-size:12.5px!important;font-weight:500!important}[data-component-part=\"tab-button\"][data-active=\"true\"]{color:var(--sk-ink)!important;border-color:var(--sk-ink)!important}[data-component-part=\"tab-button\"][data-active=\"false\"]{color:var(--sk-muted)!important}[data-component-part=\"tab-button\"][data-active=\"false\"]:hover{color:var(--sk-ink)!important}.callout{background:var(--sk-soft)!important;border:1px solid var(--sk-line)!important;border-radius:12px!important}.callout,.callout [data-component-part=\"callout-content\"],.callout [data-component-part=\"callout-content\"] *{color:var(--sk-ink)}.callout [data-component-part=\"callout-content\"]{color:var(--sk-ink)!important}.callout [data-component-part=\"callout-icon\"] svg{color:var(--sk-ink)!important}.callout[data-callout-type=\"warning\"] [data-component-part=\"callout-icon\"] svg{color:#a16207!important}.callout[data-callout-type=\"danger\"] [data-component-part=\"callout-icon\"] svg{color:#b91c1c!important}html.dark .callout[data-callout-type=\"warning\"] [data-component-part=\"callout-icon\"] svg{color:#eab308!important}html.dark .callout[data-callout-type=\"danger\"] [data-component-part=\"callout-icon\"] svg{color:#f87171!important}.callout :not(pre)>code{background:transparent!important;border:none!important;padding:0!important;border-radius:0!important;font-weight:600}.card{border:1px solid var(--sk-line)!important;border-radius:16px!important;box-shadow:none!important;transition:border-color 0.15s ease, background-color 0.15s ease}.card:hover{border-color:var(--sk-ink)!important}.accordion,details{border-color:var(--sk-line)!important;border-radius:12px!important}.mdx-content table th,.mdx-content table td,.mdx-content table tr{border-color:var(--sk-line)!important}.field{border-color:var(--sk-line)!important}::-webkit-scrollbar{width:6px;height:6px}::-webkit-scrollbar-track{background:transparent}::-webkit-scrollbar-thumb{background:#cfcfcf;border-radius:999px}html.dark ::-webkit-scrollbar-thumb{background:#3a3a3a}#pagination{display:flex!important;justify-content:space-between!important;width:100%!important}footer{border-top:1px solid var(--sk-line)!important}body:has(.changelog-wrapper) #sidebar-content,body:has(.changelog-wrapper) #sidebar,body:has(.changelog-wrapper) #table-of-contents,body:has(.changelog-wrapper) #table-of-contents-content{display:none!important}body:has(.changelog-wrapper) article>h1:first-of-type,body:has(.changelog-wrapper) .page-header,body:has(.changelog-wrapper) article>p:first-of-type{display:none!important}.changelog-wrapper{max-width:620px;margin:0 auto;padding:2rem 0}.changelog-entry{border-left:1px solid var(--sk-line);padding:0 0 2.5rem 1.5rem;position:relative}.changelog-entry:last-child{padding-bottom:0}.changelog-entry::before{content:'';position:absolute;left:-4px;top:6px;width:7px;height:7px;border-radius:50%;background:var(--sk-ink)}.changelog-header{display:flex;align-items:center;justify-content:space-between;margin-bottom:0.5rem}.changelog-date{font-family:var(--sk-mono);font-size:0.75rem;letter-spacing:0.08em;color:var(--sk-muted);font-weight:500}.changelog-tags-row{display:flex;gap:0.375rem}.changelog-tag{font-family:var(--sk-mono);font-size:0.65rem;font-weight:500;color:var(--sk-muted);background:var(--sk-soft);border:1px solid var(--sk-line);padding:0.125rem 0.5rem;border-radius:5px;text-transform:lowercase;letter-spacing:0.02em}.changelog-entry h3{font-size:1.05rem;font-weight:550;letter-spacing:-0.02em;margin:0 0 0.375rem 0;color:var(--sk-ink)}.changelog-entry p{font-size:0.875rem;line-height:1.6;color:var(--sk-muted);margin:0}.changelog-entry code{font-family:var(--sk-mono);font-size:0.8rem}.sk-dg{--sk-dg-keep: var(--sk-ink);--sk-dg-rem: #a16207;--sk-dg-rem-bg: #fdf6e6;--sk-dg-cur: #2454b8;--sk-dg-cur-bg: #eaf1fd;--sk-dg-bnd: #6d28d9;--sk-dg-bnd-bg: #f4efff}html.dark .sk-dg{--sk-dg-rem: #eab308;--sk-dg-rem-bg: #241f0e;--sk-dg-cur: #7aa2f7;--sk-dg-cur-bg: #121c30;--sk-dg-bnd: #b794f6;--sk-dg-bnd-bg: #1d1430}.sk-ex{border:1px solid var(--sk-line);border-radius:12px;background:var(--sk-soft);padding:18px;margin:20px 0 26px}.sk-ex-row{display:flex;align-items:center;gap:12px;margin-top:9px;flex-wrap:wrap}.sk-ex-row:first-of-type{margin-top:0}.sk-cap{font-family:var(--sk-mono);font-size:9.5px;font-weight:500;letter-spacing:0.1em;text-transform:uppercase;color:var(--sk-muted);flex:0 0 72px;text-align:right}.sk-strip{display:flex;gap:3px;flex-wrap:wrap}.sk-strip span{width:24px;height:24px;border-radius:4px;border:1px solid var(--sk-line);background:var(--sk-paper);font-family:var(--sk-mono);font-size:9px;font-weight:500;line-height:22px;text-align:center;color:var(--sk-muted)}.sk-strip span.k{border-color:var(--sk-dg-keep);color:var(--sk-ink)}.sk-strip span.r{background:var(--sk-dg-rem-bg);border-color:var(--sk-dg-rem);color:var(--sk-dg-rem)}.sk-strip span.i{border-color:var(--sk-dg-keep);background:var(--sk-soft-2);color:var(--sk-ink)}.sk-strip span.d{border-color:var(--sk-dg-rem);border-style:dashed;color:var(--sk-dg-rem)}.sk-strip span.c{background:var(--sk-dg-cur-bg);border-color:var(--sk-dg-cur);color:var(--sk-dg-cur)}.sk-strip span.b{background:var(--sk-dg-bnd-bg);border-color:var(--sk-dg-bnd);color:var(--sk-dg-bnd)}.sk-strip span.o{opacity:0.3}.sk-key{display:flex;flex-wrap:wrap;gap:8px 18px;margin-top:15px;font-family:var(--sk-mono);font-size:10.5px;font-weight:500;color:var(--sk-muted)}.sk-key i{display:inline-block;width:10px;height:10px;border-radius:3px;border:1px solid var(--sk-line);margin-right:6px;vertical-align:-1px}.sk-key .k i{border-color:var(--sk-dg-keep)}.sk-key .r i{background:var(--sk-dg-rem-bg);border-color:var(--sk-dg-rem)}.sk-key .c i{background:var(--sk-dg-cur-bg);border-color:var(--sk-dg-cur)}.sk-key .b i{background:var(--sk-dg-bnd-bg);border-color:var(--sk-dg-bnd)}.sk-key .i i{background:var(--sk-soft-2);border-color:var(--sk-dg-keep)}.sk-key .d i{border-color:var(--sk-dg-rem);border-style:dashed}.sk-fields{display:flex;flex-direction:column;gap:1px;background:var(--sk-line);border:1px solid var(--sk-line);border-radius:12px;overflow:hidden;margin:20px 0}.sk-f{background:var(--sk-paper);padding:15px 17px}.sk-f-hd{display:flex;justify-content:space-between;align-items:baseline;gap:14px;flex-wrap:wrap}.sk-f-nm{font-family:var(--sk-mono);font-size:13px;font-weight:600;color:var(--sk-ink)}.sk-f-v{font-family:var(--sk-mono);font-size:12.5px;font-weight:600;color:var(--sk-ink);font-variant-numeric:tabular-nums}.sk-f-v.na{color:var(--sk-muted);font-weight:500}.sk-f p{margin:6px 0 0;color:var(--sk-muted);font-size:14px;max-width:66ch}.sk-f .sk-strip{margin-top:11px}.sk-f-tp{margin-top:10px!important;border-left:2px solid var(--sk-line);padding-left:11px;font-size:13px!important}.sk-f-tp strong{color:var(--sk-ink);font-weight:600}.sk-rej table{width:100%}.sk-rej td.rsn{white-space:nowrap;width:1%;font-family:var(--sk-mono)}.sk-rej td.md{white-space:nowrap;width:1%;font-family:var(--sk-mono);font-size:12px;color:var(--sk-muted)}.sk-rej td.md.both{white-space:normal}.sk-rej td.md code{white-space:nowrap;word-break:keep-all;overflow-wrap:normal}.sk-rej td.md.one code,.sk-rej td.md.both code{color:#6d28d9;font-weight:600}html.dark .sk-rej td.md.one code,html.dark .sk-rej td.md.both code{color:#b794f6}"}]}
{"page":{"pagePath":"api/content/facets","slug":"/api/content/facets","pageMetadata":{"title":"Get Catalogue Breakdown","sidebarTitle":"Catalogue breakdown","api":"GET /v1/feed/facets","description":"Returns how many feed items match each value of one filter dimension — tags, section, author, content type or a metadata key.","href":"/api/content/facets"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns how many feed items match each value of one filter dimension — tags, section, author, content type or a metadata key.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Info,ParamField,ResponseField}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use this to decide which filters to offer in your app before you offer them: which sports get a story ring, which sections get a tab, which authors get a row. One request replaces probing `,_jsx(_components.code,{children:`/v1/feed/filter`}),` once per value.`]}),`\n`,_jsxs(_components.p,{children:[`The counts are over exactly the content the `,_jsx(_components.a,{href:`/sdk/feed`,children:`feed`}),` serves — published, ready, non-deleted items of a supported type — and honour the same `,_jsx(_components.code,{children:`exclude.*`}),` and media-negotiation rules as filtered feeds. For any value `,_jsx(_components.code,{children:`v`}),`, `,_jsx(_components.code,{children:`counts[v]`}),` equals the number of items a feed filtered to `,_jsx(_components.code,{children:`v`}),` would page through.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Authenticate with a `,_jsx(_components.strong,{children:`publishable`}),` key (`,_jsx(_components.code,{children:`X-API-Key: pk_…`}),`). The endpoint is safe to call from client apps on every launch: responses are cached for 60 seconds per organisation and query.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query parameters`}),`\n`,_jsx(ParamField,{query:`by`,type:`string`,required:true,id:`param-by`,children:_jsxs(_components.p,{children:[`The dimension to break the catalogue down by. One of `,_jsx(_components.code,{children:`tags`}),`, `,_jsx(_components.code,{children:`section`}),`, `,_jsx(_components.code,{children:`author`}),`, `,_jsx(_components.code,{children:`content_type`}),`, or `,_jsx(_components.code,{children:`metadata.\u003ckey>`}),` for a custom metadata field (for example `,_jsx(_components.code,{children:`metadata.sport`}),`). These are the same include dimensions `,_jsx(_components.code,{children:`FeedFilter`}),` accepts.`]})}),`\n`,_jsx(ParamField,{query:`min`,type:`integer`,default:`0`,id:`param-min`,children:_jsx(_components.p,{children:`Drop values with fewer than this many matching items. Use it to hide filters that would open a nearly empty feed.`})}),`\n`,_jsx(ParamField,{query:`exclude.tags`,type:`string`,id:`param-exclude-tags`,children:_jsxs(_components.p,{children:[`Comma-separated values to exclude before counting. Also accepts `,_jsx(_components.code,{children:`exclude.sections`}),`, `,_jsx(_components.code,{children:`exclude.authors`}),`, `,_jsx(_components.code,{children:`exclude.content_types`}),` and `,_jsx(_components.code,{children:`exclude.metadata.\u003ckey>`}),`, with the same semantics as the feed’s exclusion filters.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`data.by`,type:`string`,id:`param-data-by`,children:_jsx(_components.p,{children:`The dimension that was counted, echoed back.`})}),`\n`,_jsx(ResponseField,{name:`data.counts`,type:`object`,id:`param-data-counts`,children:_jsxs(_components.p,{children:[`A map of value → number of matching items, ordered by count descending, then value ascending. Each item counts once per distinct value it carries, so an item tagged `,_jsx(_components.code,{children:`baseball`}),` and `,_jsx(_components.code,{children:`bats`}),` appears in both counts.`]})}),`\n`,_jsxs(_components.p,{children:[`Invalid `,_jsx(_components.code,{children:`by`}),` values return `,_jsx(_components.code,{children:`400`}),`.`]}),`\n`,`\n`,`\n`,_jsx(Heading,{level:`2`,id:`notes`,children:`Notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Counts are per organisation and reflect the catalogue at the time of the request (up to 60 seconds of caching).`}),`\n`,_jsx(_components.li,{children:`Only values that can be requested are listed: string tags with no commas or whitespace, non-empty sections and authors, and string metadata values.`}),`\n`,_jsxs(_components.li,{children:[`Organisations on the discovery feed see counts for the discovery pool (video and live stream content), which match that pool’s `,_jsx(_components.code,{children:`X-Pool-Size`}),` header for the same filter.`]}),`\n`,_jsxs(_components.li,{children:[`For the SDK side of this — opening a filtered feed from a tapped tile — see `,_jsx(_components.a,{href:`/sdk/player-and-widget#per-tile-feeds`,children:`per-tile feeds`}),`.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light-default","dark":"github-dark-default"}},"config":{},"pageMetadata":{"title":"Get Catalogue Breakdown","sidebarTitle":"Catalogue breakdown","api":"GET /v1/feed/facets","description":"Returns how many feed items match each value of one filter dimension — tags, section, author, content type or a metadata key.","href":"/api/content/facets"}}},"mdxSourceWithNoJs":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Info,ParamField,RequestExample,ResponseExample,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!RequestExample)_missingMdxReference(`RequestExample`,true);if(!ResponseExample)_missingMdxReference(`ResponseExample`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Use this to decide which filters to offer in your app before you offer them: which sports get a story ring, which sections get a tab, which authors get a row. One request replaces probing `,_jsx(_components.code,{children:`/v1/feed/filter`}),` once per value.`]}),`\n`,_jsxs(_components.p,{children:[`The counts are over exactly the content the `,_jsx(_components.a,{href:`/sdk/feed`,children:`feed`}),` serves — published, ready, non-deleted items of a supported type — and honour the same `,_jsx(_components.code,{children:`exclude.*`}),` and media-negotiation rules as filtered feeds. For any value `,_jsx(_components.code,{children:`v`}),`, `,_jsx(_components.code,{children:`counts[v]`}),` equals the number of items a feed filtered to `,_jsx(_components.code,{children:`v`}),` would page through.`]}),`\n`,_jsx(Info,{children:_jsxs(_components.p,{children:[`Authenticate with a `,_jsx(_components.strong,{children:`publishable`}),` key (`,_jsx(_components.code,{children:`X-API-Key: pk_…`}),`). The endpoint is safe to call from client apps on every launch: responses are cached for 60 seconds per organisation and query.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query parameters`}),`\n`,_jsx(ParamField,{query:`by`,type:`string`,required:true,id:`param-by`,children:_jsxs(_components.p,{children:[`The dimension to break the catalogue down by. One of `,_jsx(_components.code,{children:`tags`}),`, `,_jsx(_components.code,{children:`section`}),`, `,_jsx(_components.code,{children:`author`}),`, `,_jsx(_components.code,{children:`content_type`}),`, or `,_jsx(_components.code,{children:`metadata.\u003ckey>`}),` for a custom metadata field (for example `,_jsx(_components.code,{children:`metadata.sport`}),`). These are the same include dimensions `,_jsx(_components.code,{children:`FeedFilter`}),` accepts.`]})}),`\n`,_jsx(ParamField,{query:`min`,type:`integer`,default:`0`,id:`param-min`,children:_jsx(_components.p,{children:`Drop values with fewer than this many matching items. Use it to hide filters that would open a nearly empty feed.`})}),`\n`,_jsx(ParamField,{query:`exclude.tags`,type:`string`,id:`param-exclude-tags`,children:_jsxs(_components.p,{children:[`Comma-separated values to exclude before counting. Also accepts `,_jsx(_components.code,{children:`exclude.sections`}),`, `,_jsx(_components.code,{children:`exclude.authors`}),`, `,_jsx(_components.code,{children:`exclude.content_types`}),` and `,_jsx(_components.code,{children:`exclude.metadata.\u003ckey>`}),`, with the same semantics as the feed’s exclusion filters.`]})}),`\n`,_jsx(Heading,{level:`2`,id:`response`,children:`Response`}),`\n`,_jsx(ResponseField,{name:`data.by`,type:`string`,id:`param-data-by`,children:_jsx(_components.p,{children:`The dimension that was counted, echoed back.`})}),`\n`,_jsx(ResponseField,{name:`data.counts`,type:`object`,id:`param-data-counts`,children:_jsxs(_components.p,{children:[`A map of value → number of matching items, ordered by count descending, then value ascending. Each item counts once per distinct value it carries, so an item tagged `,_jsx(_components.code,{children:`baseball`}),` and `,_jsx(_components.code,{children:`bats`}),` appears in both counts.`]})}),`\n`,_jsxs(_components.p,{children:[`Invalid `,_jsx(_components.code,{children:`by`}),` values return `,_jsx(_components.code,{children:`400`}),`.`]}),`\n`,_jsxs(RequestExample,{children:[_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default github-dark-default`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0d1117`,color:`#1f2328`,\"--shiki-dark\":`#e6edf3`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#FFA657`},children:`curl`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:` \"https://api.shortkit.dev/v1/feed/facets?by=tags\u0026min=10\"`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:` \"X-API-Key: pk_live_your_publishable_key\"`})]}),`\n`]})})}),_jsx(CodeBlock,{filename:`Swift`,numberOfLines:`6`,language:`swift`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default github-dark-default`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0d1117`,color:`#1f2328`,\"--shiki-dark\":`#e6edf3`},language:`swift`,children:_jsxs(_components.code,{language:`swift`,numberOfLines:`6`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`var`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` request `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:` URLRequest`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`url`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`URL`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`string`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"https://api.shortkit.dev/v1/feed/facets?by=tags\u0026min=10\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`)`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`!`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`request.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`setValue`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`(publishableKey, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`forHTTPHeaderField`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"X-API-Key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`let`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` (data, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`_`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`) `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:` try`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:` await`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` URLSession.shared.`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`for`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: request)`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`struct`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#FFA657`},children:` Facets`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`Decodable `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`{ `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`struct`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#FFA657`},children:` Data`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`Decodable `}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`{ `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`let`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` by: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`String`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`; let counts: [`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`String`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`Int`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`] }; let data: Data }`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`let`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` counts `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`=`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:` try`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:` JSONDecoder`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`().`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`decode`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`(Facets.`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`self`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`from`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: data).data.counts`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#8B949E`},children:`// [\"baseball\": 143, \"hockey\": 101, \"lacrosse\": 74, …]`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`Python`,numberOfLines:`9`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default github-dark-default`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0d1117`,color:`#1f2328`,\"--shiki-dark\":`#e6edf3`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`9`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`import`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` requests`})]}),`\n`,_jsx(_components.span,{className:`line`}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`resp `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` requests.get(`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:` \"https://api.shortkit.dev/v1/feed/facets\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#FFA657`},children:` headers`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"X-API-Key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"pk_live_your_publishable_key\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`},`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#FFA657`},children:` params`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`{`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"by\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"tags\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`, `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"min\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`10`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`},`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`)`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`resp.raise_for_status()`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`counts `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#FF7B72`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` resp.json()[`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`][`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"counts\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`]`})]}),`\n`]})})})]}),`\n`,_jsxs(ResponseExample,{children:[_jsx(CodeBlock,{filename:`200`,numberOfLines:`15`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default github-dark-default`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0d1117`,color:`#1f2328`,\"--shiki-dark\":`#e6edf3`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`15`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"by\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"tags\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"counts\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"baseball\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`143`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"hockey\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`101`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"lacrosse\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`74`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"golf\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`52`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"football\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`26`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"meta\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"req_f88e2990fd11\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`}`})}),`\n`]})})}),_jsx(CodeBlock,{filename:`400`,numberOfLines:`12`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default github-dark-default`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0d1117`,color:`#1f2328`,\"--shiki-dark\":`#e6edf3`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`12`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#79C0FF`},children:`null`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"meta\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: {`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"request_id\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"req_f88e2990fd12\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` },`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"errors\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"code\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"invalid_request\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#7EE787`},children:` \"message\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#A5D6FF`},children:`\"Invalid 'by' value 'bogus' (one of: tags, section, author, content_type, metadata.\u003ckey>).\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#E6EDF3`},children:`}`})}),`\n`]})})})]}),`\n`,_jsx(Heading,{level:`2`,id:`notes`,children:`Notes`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`Counts are per organisation and reflect the catalogue at the time of the request (up to 60 seconds of caching).`}),`\n`,_jsx(_components.li,{children:`Only values that can be requested are listed: string tags with no commas or whitespace, non-empty sections and authors, and string metadata values.`}),`\n`,_jsxs(_components.li,{children:[`Organisations on the discovery feed see counts for the discovery pool (video and live stream content), which match that pool’s `,_jsx(_components.code,{children:`X-Pool-Size`}),` header for the same filter.`]}),`\n`,_jsxs(_components.li,{children:[`For the SDK side of this — opening a filtered feed from a tapped tile — see `,_jsx(_components.a,{href:`/sdk/player-and-widget#per-tile-feeds`,children:`per-tile feeds`}),`.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"codeStyling":{"theme":{"light":"github-light-default","dark":"github-dark-default"}},"config":{},"pageMetadata":{"title":"Get Catalogue Breakdown","sidebarTitle":"Catalogue breakdown","api":"GET /v1/feed/facets","description":"Returns how many feed items match each value of one filter dimension — tags, section, author, content type or a metadata key.","href":"/api/content/facets"}}}},"mdxExtracts":{"tableOfContents":[{"title":"Query parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Response","slug":"response","depth":2,"children":[]},{"title":"Notes","slug":"notes","depth":2,"children":[]}],"codeExamples":{"request":{"type":"RequestExample","children":[{"filename":"cURL","html":"\u003cpre class=\"shiki shiki-themes github-light-default github-dark-default\" style=\"background-color:#ffffff;--shiki-dark-bg:#0d1117;color:#1f2328;--shiki-dark:#e6edf3\" language=\"shellscript\">\u003ccode language=\"shellscript\" numberOfLines=\"2\">\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#FFA657\">curl\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\"> \"https://api.shortkit.dev/v1/feed/facets?by=tags\u0026#x26;min=10\"\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\"> \\\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\"> -H\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\"> \"X-API-Key: pk_live_your_publishable_key\"\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Swift","html":"\u003cpre class=\"shiki shiki-themes github-light-default github-dark-default\" style=\"background-color:#ffffff;--shiki-dark-bg:#0d1117;color:#1f2328;--shiki-dark:#e6edf3\" language=\"swift\">\u003ccode language=\"swift\" numberOfLines=\"6\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">var\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\"> request \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">=\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\"> URLRequest\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">(\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">url\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">URL\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">(\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">string\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"https://api.shortkit.dev/v1/feed/facets?by=tags\u0026#x26;min=10\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">)\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">!\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">request.\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">setValue\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">(publishableKey, \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">forHTTPHeaderField\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"X-API-Key\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">let\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\"> (data, \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">_\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">) \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">=\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\"> try\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\"> await\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\"> URLSession.shared.\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">data\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">(\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">for\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: request)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">struct\u003c/span>\u003cspan style=\"color:#953800;--shiki-dark:#FFA657\"> Facets\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">Decodable \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">{ \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">struct\u003c/span>\u003cspan style=\"color:#953800;--shiki-dark:#FFA657\"> Data\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">Decodable \u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">{ \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">let\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\"> by: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">String\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">; let counts: [\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">String\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">Int\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">] }; let data: Data }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">let\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\"> counts \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">=\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\"> try\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\"> JSONDecoder\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">().\u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">decode\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">(Facets.\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">self\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">, \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">from\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: data).data.counts\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#6E7781;--shiki-dark:#8B949E\">// [\"baseball\": 143, \"hockey\": 101, \"lacrosse\": 74, …]\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"Python","html":"\u003cpre class=\"shiki shiki-themes github-light-default github-dark-default\" style=\"background-color:#ffffff;--shiki-dark-bg:#0d1117;color:#1f2328;--shiki-dark:#e6edf3\" language=\"python\">\u003ccode language=\"python\" numberOfLines=\"9\">\u003cspan class=\"line\">\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">import\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\"> requests\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">resp \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\"> requests.get(\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\"> \"https://api.shortkit.dev/v1/feed/facets\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#FFA657\"> headers\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"X-API-Key\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"pk_live_your_publishable_key\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#953800;--shiki-dark:#FFA657\"> params\u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">{\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"by\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"tags\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">, \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"min\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">10\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">},\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">)\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">resp.raise_for_status()\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">counts \u003c/span>\u003cspan style=\"color:#CF222E;--shiki-dark:#FF7B72\">=\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\"> resp.json()[\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">][\u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"counts\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">]\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]},"response":{"type":"ResponseExample","children":[{"filename":"200","html":"\u003cpre class=\"shiki shiki-themes github-light-default github-dark-default\" style=\"background-color:#ffffff;--shiki-dark-bg:#0d1117;color:#1f2328;--shiki-dark:#e6edf3\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"15\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"by\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"tags\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"counts\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"baseball\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">143\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"hockey\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">101\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"lacrosse\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">74\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"golf\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">52\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"football\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">26\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"meta\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"req_f88e2990fd11\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"},{"filename":"400","html":"\u003cpre class=\"shiki shiki-themes github-light-default github-dark-default\" style=\"background-color:#ffffff;--shiki-dark-bg:#0d1117;color:#1f2328;--shiki-dark:#e6edf3\" language=\"json\">\u003ccode language=\"json\" numberOfLines=\"12\">\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">{\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"data\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0550AE;--shiki-dark:#79C0FF\">null\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"meta\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"request_id\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"req_f88e2990fd12\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\"> },\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"errors\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: [\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\"> {\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"code\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"invalid_request\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">,\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#116329;--shiki-dark:#7EE787\"> \"message\"\u003c/span>\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">: \u003c/span>\u003cspan style=\"color:#0A3069;--shiki-dark:#A5D6FF\">\"Invalid 'by' value 'bogus' (one of: tags, section, author, content_type, metadata.\u0026#x3C;key>).\"\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\"> }\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\"> ]\u003c/span>\u003c/span>\n\u003cspan class=\"line\">\u003cspan style=\"color:#1F2328;--shiki-dark:#E6EDF3\">}\u003c/span>\u003c/span>\n\u003c/code>\u003c/pre>"}],"attributes":[]}},"endpoint":{"title":"Get Catalogue Breakdown","path":"/v1/feed/facets","servers":[{"url":"https://api.shortkit.dev"}],"method":"get","request":{"security":[{"title":"Bearer Auth","parameters":{"header":{"Authorization":{"type":"http","scheme":"bearer","description":"Bearer authentication header of the form `Bearer \u003ctoken>`, where `\u003ctoken>` is your auth token."}},"query":{},"cookie":{}}}],"parameters":{"query":{"by":{"schema":[{"type":"string","description":"The dimension to break the catalogue down by. One of `tags` , `section` , `author` , `content_type` , or `metadata.\u003ckey>` for a custom metadata field (for example `metadata.sport` ). These are the same include dimensions `FeedFilter` accepts.","required":true}]},"min":{"schema":[{"type":"integer","description":"Drop values with fewer than this many matching items. Use it to hide filters that would open a nearly empty feed."}]},"exclude.tags":{"schema":[{"type":"string","description":"Comma-separated values to exclude before counting. Also accepts `exclude.sections` , `exclude.authors` , `exclude.content_types` and `exclude.metadata.\u003ckey>` , with the same semantics as the feed’s exclusion filters."}]}},"header":{},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"data.by":[{"type":"string","description":"The dimension that was counted, echoed back."}],"data.counts":[{"type":"object","properties":{},"description":"A map of value → number of matching items, ordered by count descending, then value ascending. Each item counts once per distinct value it carries, so an item tagged `baseball` and `bats` appears in both counts."}]}}],"examples":{"example":{"value":{"data.by":"\u003cstring>","data.counts":{}}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"shortkit-d6329983","siteName":"shortkit","title":"Get Catalogue Breakdown - shortkit","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-04T06:43:21.989Z","originalFileLocation":"api/content/facets.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns how many feed items match each value of one filter dimension — tags, section, author, content type or a metadata key.\">\u003cmeta data-mint-head name=\"application-name\" content=\"shortkit\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/shortkit-d6329983/Bj3XCpJA-IWB2r2g/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/shortkit-d6329983/Bj3XCpJA-IWB2r2g/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/shortkit-d6329983/Bj3XCpJA-IWB2r2g/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/shortkit-d6329983/Bj3XCpJA-IWB2r2g/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/shortkit-d6329983/Bj3XCpJA-IWB2r2g/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/shortkit-d6329983/Bj3XCpJA-IWB2r2g/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/shortkit-d6329983/Bj3XCpJA-IWB2r2g/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/shortkit-d6329983/Bj3XCpJA-IWB2r2g/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/shortkit-d6329983/Bj3XCpJA-IWB2r2g/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Catalogue Breakdown - shortkit\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns how many feed items match each value of one filter dimension — tags, section, author, content type or a metadata key.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"shortkit\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.shortkit.dev/api/content/facets\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://shortkit-d6329983.mintlify.site/_mintlify/api/og/v2?division=Content\u0026amp;title=Get+Catalogue+Breakdown\u0026amp;description=Returns+how+many+feed+items+match+each+value+of+one+filter+dimension+%E2%80%94+tags%2C+section%2C+author%2C+content+type+or+a+metadata+key.\u0026amp;theme=ffe1833799302b20bddde6e9\u0026amp;signature=f1e1b10ebd1d4eb02751e17106dff471b72cd8cff913a68dc18979fb6a2fa8d0\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get Catalogue Breakdown - shortkit\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns how many feed items match each value of one filter dimension — tags, section, author, content type or a metadata key.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://shortkit-d6329983.mintlify.site/_mintlify/api/og/v2?division=Content\u0026amp;title=Get+Catalogue+Breakdown\u0026amp;description=Returns+how+many+feed+items+match+each+value+of+one+filter+dimension+%E2%80%94+tags%2C+section%2C+author%2C+content+type+or+a+metadata+key.\u0026amp;theme=ffe1833799302b20bddde6e9\u0026amp;signature=f1e1b10ebd1d4eb02751e17106dff471b72cd8cff913a68dc18979fb6a2fa8d0\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/shortkit-d6329983/Bj3XCpJA-IWB2r2g/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"shortkit\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#181818\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.shortkit.dev/api/content/facets\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api/content/facets.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.shortkit.dev/#organization\",\"name\":\"shortkit\",\"url\":\"https://docs.shortkit.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/shortkit-d6329983/xRYeGsJb7E_Zbka4/logo/light.svg?fit=max\u0026auto=format\u0026n=xRYeGsJb7E_Zbka4\u0026q=85\u0026s=6e9cf028d262e4df25460990c6b6fb92\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.shortkit.dev#website\",\"name\":\"shortkit\",\"url\":\"https://docs.shortkit.dev\",\"publisher\":{\"@id\":\"https://docs.shortkit.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.shortkit.dev/api/content/facets#webpage\",\"url\":\"https://docs.shortkit.dev/api/content/facets\",\"name\":\"Get Catalogue Breakdown\",\"description\":\"Returns how many feed items match each value of one filter dimension — tags, section, author, content type or a metadata key.\",\"dateModified\":\"2026-11-04T06:43:21.989Z\",\"isPartOf\":{\"@id\":\"https://docs.shortkit.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.shortkit.dev/api/content/facets#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.shortkit.dev/api/content/facets#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference\",\"item\":\"https://docs.shortkit.dev/api/content/object\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Content\",\"item\":\"https://docs.shortkit.dev/api/content/object\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Get Catalogue Breakdown\",\"item\":\"https://docs.shortkit.dev/api/content/facets\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.shortkit.dev/api/content/facets#apireference\",\"headline\":\"Get Catalogue Breakdown\",\"name\":\"Get Catalogue Breakdown\",\"description\":\"Returns how many feed items match each value of one filter dimension — tags, section, author, content type or a metadata key.\",\"url\":\"https://docs.shortkit.dev/api/content/facets\",\"mainEntityOfPage\":{\"@id\":\"https://docs.shortkit.dev/api/content/facets#webpage\"},\"dateModified\":\"2026-11-04T06:43:21.989Z\",\"publisher\":{\"@id\":\"https://docs.shortkit.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.shortkit.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"shortkit\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"shortkit\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api/content/facets.md","siteName":"shortkit","nav":{"global":{"anchors":[]},"tabs":[{"tab":"Docs","icon":"book-open","pages":[{"title":"Docs","href":"/sdk/installation"}]},{"tab":"API Reference","icon":"square-terminal","groups":[{"group":"Overview","pages":[{"title":"API Introduction","href":"/api/overview"},{"title":"Authentication","href":"/api/authentication"},{"title":"Errors","href":"/api/errors"}]},{"group":"Reference","pages":[{"group":"Content","expanded":true,"pages":[{"title":"The Content Object","href":"/api/content/object"},{"title":"Upload Content","api":"POST /v1/content/upload","href":"/api/content/upload"},{"title":"Create Image Carousel","api":"POST /v1/content/images","href":"/api/content/images"},{"title":"Import Content","api":"POST /v1/content/import","href":"/api/content/import"},{"title":"List Content","api":"GET /v1/content","href":"/api/content/list"},{"title":"Get Content","api":"GET /v1/content/{id}","href":"/api/content/get"},{"title":"Playback token","href":"/api/content/playback-token"},{"title":"Get Content Count","api":"GET /v1/content/count","description":"Returns the total number of content items, optionally filtered by upload status.","href":"/api/content/count"},{"title":"Get Catalogue Breakdown","sidebarTitle":"Catalogue breakdown","api":"GET /v1/feed/facets","href":"/api/content/facets"},{"title":"Search Content","api":"GET /v1/content/search","description":"Search content by title, description, tags, section, and author.","href":"/api/content/search"},{"title":"Update Content","api":"PATCH /v1/content/{id}","href":"/api/content/update"},{"title":"Bulk update content metadata","api":"POST /v1/content/bulk-update","href":"/api/content/bulk-update"},{"title":"Delete Content","api":"DELETE /v1/content/{id}","href":"/api/content/delete"}]},{"group":"Live Streams","expanded":true,"pages":[{"title":"The Live Stream Object","href":"/api/live-streams/object"},{"title":"Create Live Stream","api":"POST /v1/live-streams","href":"/api/live-streams/create"},{"title":"List Live Streams","api":"GET /v1/live-streams","href":"/api/live-streams/list"},{"title":"Get Live Stream","api":"GET /v1/live-streams/{id}","href":"/api/live-streams/get"},{"title":"Get Live Stream Status","api":"GET /v1/live-streams/status","href":"/api/live-streams/status"},{"title":"End Live Stream","api":"POST /v1/live-streams/{id}/end","href":"/api/live-streams/end"},{"title":"Delete Live Stream","api":"DELETE /v1/live-streams/{id}","href":"/api/live-streams/delete"},{"title":"Create Clips","api":"POST /v1/live-streams/{id}/clips","href":"/api/live-streams/clip"}]},{"group":"Surveys","expanded":true,"pages":[{"title":"The Survey Object","href":"/api/surveys/object"},{"title":"Create Survey","api":"POST /v1/surveys","href":"/api/surveys/create"},{"title":"List Surveys","api":"GET /v1/surveys","href":"/api/surveys/list"},{"title":"Get Survey","api":"GET /v1/surveys/{id}","href":"/api/surveys/get"},{"title":"Update Survey","api":"PUT /v1/surveys/{id}","href":"/api/surveys/update"},{"title":"Delete Survey","api":"DELETE /v1/surveys/{id}","href":"/api/surveys/delete"},{"title":"Submit Response","api":"POST /v1/surveys/{id}/responses","href":"/api/surveys/submit-response"}]},{"group":"Analytics \u0026 Events","expanded":true,"pages":[{"title":"The Event Object","href":"/api/analytics/event-object"},{"title":"Event Forwarding","sidebarTitle":"Event Forwarding","href":"/api/analytics/event-forwarding"},{"title":"List Events","api":"GET /v1/events/explore","href":"/api/analytics/list-events"},{"title":"Metrics Overview","href":"/api/analytics/metrics"},{"title":"Get Metric","api":"GET /v1/metrics/{metric}","href":"/api/analytics/get-metric"},{"title":"Get Metric Timeseries","api":"GET /v1/metrics/{metric}/timeseries","href":"/api/analytics/get-timeseries"}]},{"group":"Ad Configuration","expanded":true,"pages":[{"title":"The Ad Config Object","href":"/api/ad-config/object"},{"title":"Get Ad Config","api":"GET /v1/ad-config","href":"/api/ad-config/get"},{"title":"Update Ad Config","api":"PUT /v1/ad-config","href":"/api/ad-config/update"}]}]}]},{"tab":"Changelog","icon":"newspaper","pages":[{"title":"Changelog","href":"/changelog"}]}]},"basePath":"","title":"Get Catalogue Breakdown - shortkit","deploymentId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","buildId":"dpl_DyXGnKeCjZyA3sUdfMJ7FjkdBefg","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-CiUHMMOm.js","snippetPresets-BgfXU7Bw.js","utils-DWvOwgy_.js","style-to-object-BY3JEAdk.js","utils-BN7RXSMJ.js","v4-DIgz8zy6.js","addUniqueKeysToSchema-CFw8bq89.js","conditional-requirements-CFM0id0Q.js","cloneDeep-CAwdfOU2.js","_Uint8Array-BJr8e-ZL.js","isObject-FP1Yky1u.js","ApiExamples-XX0UgMZK.js","usePlaygroundInputsStore-DXDFSa1V.js","shallow-CdX5aREi.js","isEqual-CoOaxexF.js","CodeSnippets-Cg2wpzWm.js","CodeSnippet-D_HwgQO_.js","getApiPlaygroundDisplay-CmCoerhe.js","Page-CVJ-f_k1.js","DynamicMarkdown-CQM9Bhbv.js","SectionHeading-DpbrP8nQ.js","icon-BPCgijHy.js","MethodPill-GQ8DuY0c.js","getPastedJson-Cb5mT31m.js","Check2Icon-a7bUI6e8.js","axios-CsQoIw0U.js"]}