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.
{"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":"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}],"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/clicks-\u0026-interactions/clicks-with-users","slug":"/api-reference/clicks-\u0026-interactions/clicks-with-users","pageMetadata":{"title":"Clicks with users","description":"Counts numbers of different users and products in clicks for a time period.","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/clicks/users","href":"/api-reference/clicks-\u0026-interactions/clicks-with-users","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: \"Counts numbers of different users and products in clicks for a time period.\"\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":"Clicks with users","description":"Counts numbers of different users and products in clicks for a time period.","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/clicks/users","href":"/api-reference/clicks-\u0026-interactions/clicks-with-users","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Counts numbers of different users and products in clicks for a time period.","operationId":"clicksByUsers","parameters":["ed479e79-65dd-4122-b097-d76805f40227","a5282f56-7cbc-4f4c-a4b2-a22ec068d6e0","f99bebb7-56b8-495d-9173-186b1824a838","6a2f3656-78f5-4c25-b009-975f96a6f19e","0c797eb4-3249-4576-8089-1c26a3411012","782a3681-5daa-4a11-aa3d-884dcb130d1b","772997b3-294a-4b87-83cf-354ae5b43db3"],"responses":{"200":"a96636bd-4560-4894-82e1-7bdc31ef918c","400":"64811553-0e58-41db-9d8f-7e26f41186fe","401":"1d1ac82c-4541-4c64-abe8-95cdb1a9636b","403":"71ad2b99-a2a7-44c4-8dfc-0078b815e54d","404":"5b41a4df-49c9-4bf7-8b72-b6abba2667ce","408":"bee752c5-b52c-48a9-b7e8-2081af510123","429":"de90dac8-cc77-47b5-873f-ab09391454fa"},"summary":"Clicks with users","tags":["Clicks \u0026 Interactions"],"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/clicks/users","baseUrlOptions":["https://{search_zone}-api.doofinder.com","/"],"title":"Clicks with users","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"ed479e79-65dd-4122-b097-d76805f40227":{"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"}},"a5282f56-7cbc-4f4c-a4b2-a22ec068d6e0":{"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"}},"f99bebb7-56b8-495d-9173-186b1824a838":{"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[]"}},"6a2f3656-78f5-4c25-b009-975f96a6f19e":{"description":"Filter by index name.\n\nParameters:\n * name *: The name of the index to filter\n * hashid *: The hashid where `name` belongs\n\nFormat:\n indices[i][name]=value\u0026indices[i][hashid]=hashid.\n","example":"indices[1][name]=product1\u0026indices[1][hashid]=hashid1\u0026indices[2][name]=product2\u0026indices[2][hashid]=hashid2","in":"query","name":"indices","schema":{"type":"object","description":"Filter by index name.\n\nParameters:\n * name *: The name of the index to filter\n * hashid *: The hashid where `name` belongs\n\nFormat:\n indices[i][name]=value\u0026indices[i][hashid]=hashid.\n","uniqueKey":"","typeLabel":"object"}},"0c797eb4-3249-4576-8089-1c26a3411012":{"description":"An string used to filter stats by input query.","in":"query","name":"query","schema":{"type":"string","description":"An string used to filter stats by input query.","uniqueKey":"","typeLabel":"string"}},"782a3681-5daa-4a11-aa3d-884dcb130d1b":{"description":"Filter by a doofinder item id. You can get this value from the playground.","in":"query","name":"dfid","schema":{"type":"string","description":"Filter by a doofinder item id. You can get this value from the playground.","uniqueKey":"","typeLabel":"string"}},"772997b3-294a-4b87-83cf-354ae5b43db3":{"description":"Filter by kind of device.","in":"query","name":"device","schema":{"enum":["desktop","mobile"],"type":"string","description":"Filter by kind of device.","uniqueKey":"","typeLabel":"enum\u003cstring>"}}},"responses":{"a96636bd-4560-4894-82e1-7bdc31ef918c":{"content":{"application/json":{"schema":{"type":"object","title":"Clicks Users","description":"Clicks users result.","example":{"results":[{"clicks":12170,"product_clicks":159080,"users":5876}],"total":1,"total_count":1},"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":{"clicks":{"example":12170,"type":"integer","uniqueKey":"results.items.[INDEX].clicks","typeLabel":"integer"},"product_clicks":{"example":159080,"type":"integer","uniqueKey":"results.items.[INDEX].product_clicks","typeLabel":"integer"},"users":{"example":5876,"type":"integer","uniqueKey":"results.items.[INDEX].users","typeLabel":"integer"}},"type":"object","uniqueKey":"results.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"results","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"Clicks Users · object"},"examples":{"Example":{"title":"Example","value":{"results":[{"clicks":12170,"product_clicks":159080,"users":5876}],"total":1,"total_count":1}}},"exampleType":"generated"}},"description":"Stats retrieved.","exampleType":"generated"},"64811553-0e58-41db-9d8f-7e26f41186fe":{"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"},"1d1ac82c-4541-4c64-abe8-95cdb1a9636b":{"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"},"71ad2b99-a2a7-44c4-8dfc-0078b815e54d":{"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"},"5b41a4df-49c9-4bf7-8b72-b6abba2667ce":{"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"},"bee752c5-b52c-48a9-b7e8-2081af510123":{"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"},"de90dac8-cc77-47b5-873f-ab09391454fa":{"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":"Clicks with users - Doofinder API Reference","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T10:48:00.657Z","originalFileLocation":"api-reference/clicks-\u0026-interactions/clicks-with-users.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=\"Counts numbers of different users and products in clicks for a time period.\">\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=\"Clicks with users - Doofinder API Reference\">\u003cmeta data-mint-head property=\"og:description\" content=\"Counts numbers of different users and products in clicks for a time period.\">\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/clicks-\u0026amp;-interactions/clicks-with-users\">\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=Clicks+%26+Interactions\u0026amp;title=Clicks+with+users\u0026amp;description=Counts+numbers+of+different+users+and+products+in+clicks+for+a+time+period.\u0026amp;theme=aed6141c6b33efdfd60407a2\u0026amp;signature=989fcf8037029a1d85d0f381651f2dae39f1fc99ac129030fd8608e4f6f282f9\">\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=\"Clicks with users - Doofinder API Reference\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Counts numbers of different users and products in clicks for a time period.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://doofinder.mintlify.site/_mintlify/api/og/v2?division=Clicks+%26+Interactions\u0026amp;title=Clicks+with+users\u0026amp;description=Counts+numbers+of+different+users+and+products+in+clicks+for+a+time+period.\u0026amp;theme=aed6141c6b33efdfd60407a2\u0026amp;signature=989fcf8037029a1d85d0f381651f2dae39f1fc99ac129030fd8608e4f6f282f9\">\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/clicks-\u0026amp;-interactions/clicks-with-users\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/clicks-%26-interactions/clicks-with-users.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/clicks-\u0026-interactions/clicks-with-users#webpage\",\"url\":\"https://docs.doofinder.com/api-reference/clicks-\u0026-interactions/clicks-with-users\",\"name\":\"Clicks with users\",\"description\":\"Counts numbers of different users and products in clicks for a time period.\",\"dateModified\":\"2026-11-05T10:48:00.657Z\",\"isPartOf\":{\"@id\":\"https://docs.doofinder.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.doofinder.com/api-reference/clicks-\u0026-interactions/clicks-with-users#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.doofinder.com/api-reference/clicks-\u0026-interactions/clicks-with-users#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.doofinder.com/api-reference/features/banners\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Clicks \u0026 Interactions\",\"item\":\"https://docs.doofinder.com/api-reference/clicks-\u0026-interactions/clicked-items\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Clicks with users\",\"item\":\"https://docs.doofinder.com/api-reference/clicks-\u0026-interactions/clicks-with-users\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.doofinder.com/api-reference/clicks-\u0026-interactions/clicks-with-users#apireference\",\"headline\":\"Clicks with users\",\"name\":\"Clicks with users\",\"description\":\"Counts numbers of different users and products in clicks for a time period.\",\"url\":\"https://docs.doofinder.com/api-reference/clicks-\u0026-interactions/clicks-with-users\",\"mainEntityOfPage\":{\"@id\":\"https://docs.doofinder.com/api-reference/clicks-\u0026-interactions/clicks-with-users#webpage\"},\"dateModified\":\"2026-11-05T10:48:00.657Z\",\"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/clicks-%26-interactions/clicks-with-users.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","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","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","description":"Counts number of clicks in a time period grouped by day.","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","description":"Gets redirections and how many times users make use of them in a time period.","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":"Clicks with users - 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"]}