Unique id of the search engine. It accepts an array of values. If you want to work with all user search engines just don't send this parameter. Arrays parameters must be in the format param[]=value.
Pattern: ^[a-f0-9]{32}$
hashid
string[]
Pattern: ^[a-f0-9]{32}$
sector
string
required
Sector name to compute the benchmark for (e.g. "fashion", "technology").
Response
Stats retrieved.
Stats counter with timestamp.
total
integer
Sum of all elements retrieved.
Example:
1
total_count
integer
Total sum of all elements count. If element does not have a "count", this has the same value as total.
Example:
12
results
object[]
Show child attributes
⌘I
Sector
curl --request GET \
--url https://{search_zone}-api.doofinder.com/api/v2/stats/sector/{name} \
--header 'Authorization: <api-key>'
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Doofinder API Reference","colors":{"primary":"#4842C1","light":"#6B5FD0","dark":"#1B1851"},"logo":{"light":"https://mintcdn.com/doofinder/HD8ly3p1reEAKAuv/logo/light.svg?fit=max\u0026auto=format\u0026n=HD8ly3p1reEAKAuv\u0026q=85\u0026s=ca28fd1998eb0d292938e50fb2d96875","dark":"https://mintcdn.com/doofinder/HD8ly3p1reEAKAuv/logo/dark.svg?fit=max\u0026auto=format\u0026n=HD8ly3p1reEAKAuv\u0026q=85\u0026s=0ca40ebfeba76f849ed289ee86846bbc"},"favicon":"https://mintcdn.com/doofinder/HD8ly3p1reEAKAuv/favicon.ico?fit=max\u0026auto=format\u0026n=HD8ly3p1reEAKAuv\u0026q=85\u0026s=1e4c48e6d03eaa30142032239384ec3e","navbar":{"links":[{"href":"https://admin.doofinder.com","label":"Admin Panel"},{"href":"https://support.doofinder.com","label":"Support"}],"primary":{"type":"button","label":"Get Started Free","href":"https://admin.doofinder.com/auth/signup"}},"footer":{"socials":{"x":"https://x.com/doofinder","github":"https://github.com/doofinder","linkedin":"https://www.linkedin.com/company/doofinder"}},"contextual":{"options":["copy","view","claude","chatgpt","perplexity","cursor","vscode","mcp"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"doofinder","hasAudioNarration":false,"actualSubdomain":"doofinder","customDomains":["docs.doofinder.com"],"gitSource":{"type":"github","owner":"doofinder","repo":"docs","deployBranch":"master","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af6c74d3a8cec7369632a1f","clientVersion":"0.0.4167","searchFilterCounts":[{"language":"default","tag":"Endpoints","count":79},{"language":"default","tag":"Management API","count":36},{"language":"default","tag":"Stats API","count":29},{"language":"default","tag":"Items","count":18},{"language":"default","tag":"Search API","count":12},{"language":"default","tag":"Indices","count":10},{"language":"default","tag":"Overview","count":9},{"language":"default","tag":"Features","count":7},{"language":"default","tag":"Search Engines","count":7},{"language":"default","tag":"Clicks \u0026 Interactions","count":6}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"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":"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":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"custom.css","content":"@font-face{font-family:'PlutoHeavy';src:url('https://support.doofinder.com/theme/fonts/pluto_heavy.woff2') format('woff2');font-weight:800;font-style:normal;font-display:swap}@font-face{font-family:'PlutoBold';src:url('https://support.doofinder.com/theme/fonts/pluto_bold.woff2') format('woff2');font-weight:700;font-style:normal;font-display:swap}@font-face{font-family:'PlutoRegular';src:url('https://support.doofinder.com/theme/fonts/pluto_regular.woff2') format('woff2');font-weight:400;font-style:normal;font-display:swap}:root{--df-bg: #F9F9FB;--df-sidebar: #F1EFFA;--df-primary: #4842C1;--df-navy: #1B1851;--df-text: #212529;--df-muted: #767A7B;--df-border: #E5E2F5;--df-yellow: #FFF031}html,body{font-family:'Roboto', system-ui, -apple-system, sans-serif!important;color:var(--df-text)!important;background-color:var(--df-bg)!important}h1,h2,h3{font-family:'PlutoBold', 'Roboto', system-ui, sans-serif!important;color:var(--df-navy)!important}h4,h5,h6{font-family:'PlutoBold', 'Roboto', system-ui, sans-serif!important}main,[class*=\"content\"],[class*=\"page\"]{background-color:var(--df-bg)}aside,[class*=\"sidebar\"],[class*=\"navigation\"],nav[aria-label]{border-right:1px solid var(--df-border)}header,[class*=\"topbar\"],[class*=\"navbar\"]{background-color:var(--df-bg);border-bottom:1px solid var(--df-border)}header{padding-bottom:1rem}nav [class*=\"navbar\"]{border-bottom:none}a{color:var(--df-primary)!important}li a{color:var(--df-text)!important}li a:hover{color:var(--df-navy)!important}div.nav-tabs :not(a[data-active=\"true\"]){color:var(--df-text)!important}[class*=\"active\"]>a,[class*=\"selected\"]>a,[aria-current=\"page\"]{color:var(--df-primary)!important;font-family:'PlutoBold', 'Roboto', system-ui, sans-serif}:not(pre)>code{background-color:var(--df-sidebar);color:var(--df-navy);border:1px solid var(--df-border);border-radius:4px;padding:1px 5px}[class*=\"callout\"],[class*=\"card\"]{border-radius:8px}thead{background-color:var(--df-sidebar)}thead th{color:var(--df-navy);font-family:'PlutoBold', 'Roboto', system-ui, sans-serif;padding:0.75rem!important}td{padding:0.75rem!important}table{border:1px solid var(--df-border);border-radius:8px}html.dark,[data-theme=\"dark\"]{--df-bg: #0F0D2A;--df-sidebar: #16133D;--df-primary: #7874E8;--df-navy: #CBC8FF;--df-text: #D8D5F0;--df-muted: #8E8BA6;--df-border: #352E78}@media (prefers-color-scheme: dark){:root:not(.light):not([data-theme=\"light\"]){--df-bg: #0F0D2A;--df-sidebar: #16133D;--df-primary: #7874E8;--df-navy: #CBC8FF;--df-text: #D8D5F0;--df-muted: #8E8BA6;--df-border: #352E78}}.dark\\:text-primary-light:is(.dark *){color:var(--df-text)!important}#content-area{max-width:50rem}.group:hover .dark\\:group-hover\\:text-primary-light:is(.dark *){color:var(--df-text)}.sticky .absolute{background-color:var(--df-sidebar)}.dark\\:bg-gray-800:is(.dark *){background-color:var(--df-muted)}::-webkit-scrollbar{width:6px;height:6px}::-webkit-scrollbar-track{background:var(--df-bg)}::-webkit-scrollbar-thumb{background:var(--df-border);border-radius:3px}::-webkit-scrollbar-thumb:hover{background:var(--df-primary)}"}],"page":{"pagePath":"api-reference/features/sector","slug":"/api-reference/features/sector","pageMetadata":{"title":"Sector","description":"Retrieve the median of the metric you send for the sector and/or the hashid.","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/sector/{name}","href":"/api-reference/features/sector","autogeneratedByOpenApi":true},"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: \"Retrieve the median of the metric you send for the sector and/or the hashid.\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Sector","description":"Retrieve the median of the metric you send for the sector and/or the hashid.","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/sector/{name}","href":"/api-reference/features/sector","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Retrieve the median of the metric you send for the sector and/or the hashid.","operationId":"sector","parameters":["540e566e-3143-4747-ae45-80b87ca7158f","cdf7ed7e-ab0b-47e0-bd48-c7687cd254a6","d702678d-54b0-46d4-9f00-531f8c7b7d59","42bca3f1-792b-4132-abd2-255baff26184","085c10a2-bf60-4ee5-bc65-ebfa1e60c919","f3d7c9e9-6d55-4448-bdac-364fab4334a0"],"responses":{"200":"4ce28e3a-5328-4a32-aebc-c8805bfb4918","400":"885c3675-0d0b-49f1-a93c-266e31666183","401":"09d4cfcc-daf4-4ec9-b0b0-c81456aa5914","403":"e1fdd7ba-e91d-4b25-a86d-a30d7903f22e","404":"68ed9bd2-e233-4441-87b2-d748afd6b2fa","408":"f7104ead-52b2-4e49-9337-795085c94596","429":"9a440f1b-0306-4cb5-8efa-478f24bff210"},"summary":"Sector","tags":["Features"],"method":"get","type":"path","servers":["2ca0d4c1-9bee-40c7-9a30-a77e9bd7eab5","9bf735f2-5dc2-4705-a892-27a4c029e111"],"security":["16ded568-b735-421d-a1f1-314d1d1f388d","79d58211-35d8-4013-bc43-8073225b5a49"],"path":"/api/v2/stats/sector/{name}","baseUrlOptions":["https://{search_zone}-api.doofinder.com","/"],"title":"Sector","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"540e566e-3143-4747-ae45-80b87ca7158f":{"description":"Start date of the period in the format of UNIX timestamp or YYYYMMDD.","in":"query","name":"from","required":true,"schema":{"pattern":"^20\\d{2}(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])$|^\\d{10}|^\\d{13}$","type":"string","isRequired":true,"description":"Start date of the period in the format of UNIX timestamp or YYYYMMDD.","uniqueKey":"","typeLabel":"string"}},"cdf7ed7e-ab0b-47e0-bd48-c7687cd254a6":{"description":"End date of the period in the format of UNIX timestamp or YYYYMMDD.","in":"query","name":"to","required":true,"schema":{"pattern":"^20\\d{2}(0[1-9]|1[012])(0[1-9]|[12][0-9]|3[01])$|^\\d{10}$|^\\d{13}","type":"string","isRequired":true,"description":"End date of the period in the format of UNIX timestamp or YYYYMMDD.","uniqueKey":"","typeLabel":"string"}},"d702678d-54b0-46d4-9f00-531f8c7b7d59":{"description":"Unique id of the search engine. It accepts an array of values. If you want to work with all user search engines just don't send this parameter. Arrays parameters must be in the format `param[]=value`.","in":"query","name":"hashids","schema":{"items":{"pattern":"^[a-f0-9]{32}$","type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"type":"array","description":"Unique id of the search engine. It accepts an array of values. If you want to work with all user search engines just don't send this parameter. Arrays parameters must be in the format `param[]=value`.","uniqueKey":"","typeLabel":"string[]"}},"42bca3f1-792b-4132-abd2-255baff26184":{"deprecated":true,"in":"query","name":"hashid","schema":{"items":{"pattern":"^[a-f0-9]{32}$","type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"type":"array","uniqueKey":"","typeLabel":"string[]"}},"085c10a2-bf60-4ee5-bc65-ebfa1e60c919":{"description":"Sector name to compute the benchmark for (e.g. \"fashion\", \"technology\").","in":"query","name":"sector","required":true,"schema":{"type":"string","isRequired":true,"description":"Sector name to compute the benchmark for (e.g. \"fashion\", \"technology\").","uniqueKey":"","typeLabel":"string"}},"f3d7c9e9-6d55-4448-bdac-364fab4334a0":{"description":"Filter by the name of sector.","in":"path","name":"name","required":true,"schema":{"enum":["click_through_rate","clicks_per_session","conversion_rate","searches_per_session","used_search","abandonment"],"type":"string","isRequired":true,"description":"Filter by the name of sector.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"4ce28e3a-5328-4a32-aebc-c8805bfb4918":{"content":{"application/json":{"schema":{"type":"object","title":"Counters Stats by Time","description":"Stats counter with timestamp.","example":{"results":[{"count":12,"timestamp":1581120000000}],"total":1,"total_count":12},"properties":{"total":{"description":"Sum of all elements retrieved.","example":1,"type":"integer","uniqueKey":"total","typeLabel":"integer"},"total_count":{"description":"Total sum of all elements count. If element does not have a \"count\", this has the same value as `total`.","example":12,"type":"integer","uniqueKey":"total_count","typeLabel":"integer"},"results":{"items":{"properties":{"count":{"example":12,"type":"integer","uniqueKey":"results.items.[INDEX].count","typeLabel":"integer"},"timestamp":{"example":1581120000000,"type":"integer","uniqueKey":"results.items.[INDEX].timestamp","typeLabel":"integer"}},"type":"object","uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"results","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"Counters Stats by Time · object"},"examples":{"Example":{"title":"Example","value":{"results":[{"count":12,"timestamp":1581120000000}],"total":1,"total_count":12}}},"exampleType":"generated"}},"description":"Stats retrieved.","exampleType":"generated"},"885c3675-0d0b-49f1-a93c-266e31666183":{"content":{"application/json":{"example":{"error":{"code":"bad_params","message":"Bad parameters error"}},"schema":{"description":"Standard error wrapper for all Stats API error responses.","properties":{"error":{"properties":{"code":{"description":"Machine-readable error code.","example":"not_authenticated","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable error description.","example":"Authentication required","type":"string","uniqueKey":"error.message","typeLabel":"string"}},"required":["code"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"bad_params","message":"Bad parameters error"}}}},"exampleType":"examples"}},"description":"Bad Request — invalid or missing query parameters.","exampleType":"examples"},"09d4cfcc-daf4-4ec9-b0b0-c81456aa5914":{"content":{"application/json":{"example":{"error":{"code":"not_authenticated","message":"Authentication required"}},"schema":{"description":"Standard error wrapper for all Stats API error responses.","properties":{"error":{"properties":{"code":{"description":"Machine-readable error code.","example":"not_authenticated","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable error description.","example":"Authentication required","type":"string","uniqueKey":"error.message","typeLabel":"string"}},"required":["code"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"not_authenticated","message":"Authentication required"}}}},"exampleType":"examples"}},"description":"Unauthorized — no valid API token provided.","exampleType":"examples"},"e1fdd7ba-e91d-4b25-a86d-a30d7903f22e":{"content":{"application/json":{"example":{"error":{"code":"access_denied","message":"Access denied"}},"schema":{"description":"Standard error wrapper for all Stats API error responses.","properties":{"error":{"properties":{"code":{"description":"Machine-readable error code.","example":"not_authenticated","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable error description.","example":"Authentication required","type":"string","uniqueKey":"error.message","typeLabel":"string"}},"required":["code"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"access_denied","message":"Access denied"}}}},"exampleType":"examples"}},"description":"Forbidden — token is valid but does not have access to this search engine.","exampleType":"examples"},"68ed9bd2-e233-4441-87b2-d748afd6b2fa":{"content":{"application/json":{"example":{"error":{"code":"not_found","message":"Not found"}},"schema":{"description":"Standard error wrapper for all Stats API error responses.","properties":{"error":{"properties":{"code":{"description":"Machine-readable error code.","example":"not_authenticated","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable error description.","example":"Authentication required","type":"string","uniqueKey":"error.message","typeLabel":"string"}},"required":["code"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"not_found","message":"Not found"}}}},"exampleType":"examples"}},"description":"Not Found — the requested search engine or resource does not exist.","exampleType":"examples"},"f7104ead-52b2-4e49-9337-795085c94596":{"content":{"application/json":{"example":{"error":{"code":"timeout","message":"Request timed out"}},"schema":{"description":"Standard error wrapper for all Stats API error responses.","properties":{"error":{"properties":{"code":{"description":"Machine-readable error code.","example":"not_authenticated","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable error description.","example":"Authentication required","type":"string","uniqueKey":"error.message","typeLabel":"string"}},"required":["code"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"timeout","message":"Request timed out"}}}},"exampleType":"examples"}},"description":"Request Timeout — the stats backend took too long; retry after a short delay.","exampleType":"examples"},"9a440f1b-0306-4cb5-8efa-478f24bff210":{"content":{"application/json":{"example":{"error":{"code":"too_many_requests","message":"Too many requests"}},"schema":{"description":"Standard error wrapper for all Stats API error responses.","properties":{"error":{"properties":{"code":{"description":"Machine-readable error code.","example":"not_authenticated","type":"string","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"description":"Human-readable error description.","example":"Authentication required","type":"string","uniqueKey":"error.message","typeLabel":"string"}},"required":["code"],"type":"object","isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"required":["error"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"too_many_requests","message":"Too many requests"}}}},"exampleType":"examples"}},"description":"Too Many Requests — rate limit exceeded; back off and retry.","exampleType":"examples"}},"security":{"16ded568-b735-421d-a1f1-314d1d1f388d":{"api_token":{"description":"Doofinder API key. The `Token` prefix is part of the header value, so enter it too — the field is sent verbatim as:\n\n Authorization: Token \u003capi_key>\n","in":"header","name":"Authorization","type":"apiKey","x-default":"Token \u003cyour_api_key>","scopes":[],"schemeName":"api_token"}},"79d58211-35d8-4013-bc43-8073225b5a49":{"jwt_token":{"description":"JWT signed with your API key (HS256). The `Bearer` prefix is part of the header value, so enter it too — the field is sent verbatim as:\n\n Authorization: Bearer \u003cjwt_token>\n","in":"header","name":"Authorization","type":"apiKey","x-default":"Bearer \u003cyour_jwt_token>","scopes":[],"schemeName":"jwt_token"}}},"servers":{"2ca0d4c1-9bee-40c7-9a30-a77e9bd7eab5":{"url":"https://{search_zone}-api.doofinder.com","variables":{"search_zone":{"default":"eu1","enum":["eu1","us1","ap1"]}}},"9bf735f2-5dc2-4705-a892-27a4c029e111":{"url":"/"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Doofinder API key. The `Token` prefix is part of the header value, so enter it too — the field is sent verbatim as:\n\n Authorization: Token \u003capi_key>\n","in":"header","name":"Authorization","type":"apiKey","x-default":"Token \u003cyour_api_key>","scopes":[],"schemeName":"api_token"},"schema":{"title":"Authorization","type":"string","description":"Doofinder API key. The `Token` prefix is part of the header value, so enter it too — the field is sent verbatim as:\n\n Authorization: Token \u003capi_key>\n","isRequired":true,"default":"Token \u003cyour_api_key>","typeLabel":"string","deprecated":false},"schemeName":"api_token","name":"Authorization"}],"title":"api_token"},{"schemes":[{"scheme":{"description":"JWT signed with your API key (HS256). The `Bearer` prefix is part of the header value, so enter it too — the field is sent verbatim as:\n\n Authorization: Bearer \u003cjwt_token>\n","in":"header","name":"Authorization","type":"apiKey","x-default":"Bearer \u003cyour_jwt_token>","scopes":[],"schemeName":"jwt_token"},"schema":{"title":"Authorization","type":"string","description":"JWT signed with your API key (HS256). The `Bearer` prefix is part of the header value, so enter it too — the field is sent verbatim as:\n\n Authorization: Bearer \u003cjwt_token>\n","isRequired":true,"default":"Bearer \u003cyour_jwt_token>","typeLabel":"string","deprecated":false},"schemeName":"jwt_token","name":"Authorization"}],"title":"jwt_token"}]},"originalFileLocation":"openapi/stats-v2.yaml"},"subdomain":"doofinder","siteName":"Doofinder API Reference","title":"Sector - Doofinder API Reference","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T10:48:00.851Z","originalFileLocation":"api-reference/features/sector.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=\"Retrieve the median of the metric you send for the sector and/or the hashid.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Doofinder API Reference\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/doofinder/iTirxgRWYarfPToo/_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/doofinder/iTirxgRWYarfPToo/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/doofinder/iTirxgRWYarfPToo/_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/doofinder/iTirxgRWYarfPToo/_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/doofinder/iTirxgRWYarfPToo/_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/doofinder/iTirxgRWYarfPToo/_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/doofinder/iTirxgRWYarfPToo/_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/doofinder/iTirxgRWYarfPToo/_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/doofinder/iTirxgRWYarfPToo/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Sector - Doofinder API Reference\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve the median of the metric you send for the sector and/or the hashid.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Doofinder API Reference\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.doofinder.com/api-reference/features/sector\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://doofinder.mintlify.site/_mintlify/api/og/v2?division=Features\u0026amp;title=Sector\u0026amp;description=Retrieve+the+median+of+the+metric+you+send+for+the+sector+and%2For+the+hashid.\u0026amp;theme=aed6141c6b33efdfd60407a2\u0026amp;signature=7c8ad279b32fd21146118747fb5fbe262922a6a93b9dc67ada84b5a95be32828\">\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=\"Sector - Doofinder API Reference\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve the median of the metric you send for the sector and/or the hashid.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://doofinder.mintlify.site/_mintlify/api/og/v2?division=Features\u0026amp;title=Sector\u0026amp;description=Retrieve+the+median+of+the+metric+you+send+for+the+sector+and%2For+the+hashid.\u0026amp;theme=aed6141c6b33efdfd60407a2\u0026amp;signature=7c8ad279b32fd21146118747fb5fbe262922a6a93b9dc67ada84b5a95be32828\">\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/doofinder/iTirxgRWYarfPToo/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Doofinder API Reference\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4842C1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.doofinder.com/api-reference/features/sector\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/features/sector.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.doofinder.com/#organization\",\"name\":\"Doofinder API Reference\",\"url\":\"https://docs.doofinder.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/doofinder/HD8ly3p1reEAKAuv/logo/light.svg?fit=max\u0026auto=format\u0026n=HD8ly3p1reEAKAuv\u0026q=85\u0026s=ca28fd1998eb0d292938e50fb2d96875\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.doofinder.com#website\",\"name\":\"Doofinder API Reference\",\"url\":\"https://docs.doofinder.com\",\"publisher\":{\"@id\":\"https://docs.doofinder.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.doofinder.com/api-reference/features/sector#webpage\",\"url\":\"https://docs.doofinder.com/api-reference/features/sector\",\"name\":\"Sector\",\"description\":\"Retrieve the median of the metric you send for the sector and/or the hashid.\",\"dateModified\":\"2026-11-05T10:48:00.851Z\",\"isPartOf\":{\"@id\":\"https://docs.doofinder.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.doofinder.com/api-reference/features/sector#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.doofinder.com/api-reference/features/sector#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.doofinder.com/api-reference/features/banners\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Features\",\"item\":\"https://docs.doofinder.com/api-reference/features/banners\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Sector\",\"item\":\"https://docs.doofinder.com/api-reference/features/sector\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.doofinder.com/api-reference/features/sector#apireference\",\"headline\":\"Sector\",\"name\":\"Sector\",\"description\":\"Retrieve the median of the metric you send for the sector and/or the hashid.\",\"url\":\"https://docs.doofinder.com/api-reference/features/sector\",\"mainEntityOfPage\":{\"@id\":\"https://docs.doofinder.com/api-reference/features/sector#webpage\"},\"dateModified\":\"2026-11-05T10:48:00.851Z\",\"publisher\":{\"@id\":\"https://docs.doofinder.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.doofinder.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Doofinder API Reference\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Doofinder API Reference\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/features/sector.md","siteName":"Doofinder API Reference","nav":{"global":null,"tabs":[{"tab":"Getting Started","pages":[{"title":"Getting Started","href":""}]},{"tab":"Search API","pages":[{"title":"Search API","href":"/search-api/overview"}]},{"tab":"Management API","pages":[{"title":"Management API","href":"/management-api/overview"}]},{"tab":"Stats API","groups":[{"group":"Overview","pages":[{"title":"Stats API","href":"/stats-api/overview"}]},{"group":"Endpoints","pages":[{"group":"Features","pages":[{"title":"Banners","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/banners","href":"/api-reference/features/banners"},{"title":"Custom results","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/custom-results","href":"/api-reference/features/custom-results"},{"title":"Facets","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/facets","href":"/api-reference/features/facets"},{"title":"Top facets values","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/facets/top","href":"/api-reference/features/top-facets-values"},{"title":"Facets by day","description":"Gets how many times facets filters have been used in a time period, grouped by day.","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/facets_by_day","href":"/api-reference/features/facets-by-day"},{"title":"Sector","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/sector/{name}","href":"/api-reference/features/sector"},{"title":"Visit stats","description":"Save visit event on Doofinder statistics","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml post /api/v2/stats/visit","href":"/api-reference/features/visit-stats"}]},{"group":"Conversions \u0026 Sales","pages":[{"title":"Checkout cart process","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml post /api/v2/stats/carts","href":"/api-reference/conversions-\u0026-sales/checkout-cart-process"},{"title":"Checkouts","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/checkouts","href":"/api-reference/conversions-\u0026-sales/checkouts"},{"title":"Sales","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/sales","href":"/api-reference/conversions-\u0026-sales/sales"},{"title":"Sale confirm","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml post /api/v2/stats/sales","href":"/api-reference/conversions-\u0026-sales/sale-confirm"},{"title":"Get top sales","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/top-sales","href":"/api-reference/conversions-\u0026-sales/get-top-sales"}]},{"group":"Clicks \u0026 Interactions","pages":[{"title":"Clicked items","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/clicked_items","href":"/api-reference/clicks-\u0026-interactions/clicked-items"},{"title":"Clicks items and position","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/clicked_items/position","href":"/api-reference/clicks-\u0026-interactions/clicks-items-and-position"},{"title":"Clicked item searches","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/clicked_items/searches","href":"/api-reference/clicks-\u0026-interactions/clicked-item-searches"},{"title":"Clicks","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/clicks","href":"/api-reference/clicks-\u0026-interactions/clicks"},{"title":"Clicks with users","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/clicks/users","href":"/api-reference/clicks-\u0026-interactions/clicks-with-users"},{"title":"Redirections","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/redirects","href":"/api-reference/clicks-\u0026-interactions/redirections"}]},{"group":"Usage \u0026 Sessions","pages":[{"title":"Sessions","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/inits","href":"/api-reference/usage-\u0026-sessions/sessions"},{"title":"Sessions geolocation","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/inits/locations","href":"/api-reference/usage-\u0026-sessions/sessions-geolocation"},{"title":"Inits with users","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/inits/users","href":"/api-reference/usage-\u0026-sessions/inits-with-users"},{"title":"Search engine usage","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/search_engine_users","href":"/api-reference/usage-\u0026-sessions/search-engine-usage"},{"title":"Usage","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/usage","href":"/api-reference/usage-\u0026-sessions/usage"}]},{"group":"Searches","pages":[{"title":"Results searches","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/results/top","href":"/api-reference/searches/results-searches"},{"title":"Searches","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/searches","href":"/api-reference/searches/searches"},{"title":"Searches locations","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/searches/locations","href":"/api-reference/searches/searches-locations"},{"title":"Popular searches","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/searches/popular","href":"/api-reference/searches/popular-searches"},{"title":"Top searches","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/searches/top","href":"/api-reference/searches/top-searches"}]}]}]},{"tab":"Recommendations API","pages":[{"title":"Recommendations API","href":"/recommendations-api/overview"}]},{"tab":"Category Merchandising API","pages":[{"title":"Category Merchandising API","href":"/category-merchandising/overview"}]}]},"basePath":"","title":"Sector - Doofinder API Reference","buildId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","deploymentId":"dpl_9RFrWkXdFTJCytfx6jAofvAaEXr6","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-BgGj2PGS.js","utils-BhNOqRKb.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-BAgRNUZo.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-CGkb0TPw.js","snippetPresets-ChLkL1a6.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","Page-C7x-eUfk.js","ApiExamples-Ef10Jrbx.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DlVCnjU8.js","shallow-BA55zJxQ.js","getApiPlaygroundDisplay-DR09dKtp.js","CodeSnippet-BZ8J8Kll.js","CodeSnippets-CcguVheG.js","getPastedJson-D5UqeqBp.js","icon-DpD0l99C.js","MethodPill-Wg2NXsp_.js","DuplicateIcon-CCSyX8lh.js","createIcon-C4Ukv9HX.js","DynamicMarkdown-RhjEuCHC.js","SectionHeading-DL1MykRq.js","axios-vUo_bRtp.js","Markdown-BwQ4RMdp.js","dist-CiVXVcSh.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","katex-YMM-FMeD.js","html-void-elements-mCSPHezU.js","marked.esm-CZWythHk.js","AssistantPageLink-Dic2Jtb2.js"]}