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}$
device
enum<string>
Filter by kind of device.
Available options:
desktop,
mobile
Response
Stats retrieved.
Inits users result.
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
Inits with users
curl --request GET \ --url https://{search_zone}-api.doofinder.com/api/v2/stats/inits/users \ --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":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"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/usage-\u0026-sessions/inits-with-users","slug":"/api-reference/usage-\u0026-sessions/inits-with-users","pageMetadata":{"title":"Inits with users","description":"Counts numbers of different users in sessions for a time period.","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/inits/users","href":"/api-reference/usage-\u0026-sessions/inits-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 in sessions 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":"Inits with users","description":"Counts numbers of different users in sessions for a time period.","deprecated":null,"version":null,"openapi":"/openapi/stats-v2.yaml get /api/v2/stats/inits/users","href":"/api-reference/usage-\u0026-sessions/inits-with-users","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Counts numbers of different users in sessions for a time period.","operationId":"initsByUser","parameters":["1ab9bec0-fe03-4b82-83fc-9b53488df584","b490ee07-b8ea-4814-96a4-fb31d76aa073","1912c935-a908-4441-a761-6a11cf18f187","0191e2a7-da94-4e78-af14-bedc3d219866"],"responses":{"200":"af885563-d847-4ffb-9931-1085cd40113c","400":"2e83244f-0ce7-46db-b2d8-1d01326cecba","401":"15a224ed-3e9b-4c1a-a2d6-6b3ccb7fe53c","403":"f7139849-650c-41c5-8100-926c8cfa16b8","404":"6f60aa83-269b-425c-8db4-b33f2421534d","408":"2eb16212-d3ca-4f98-9f57-f11921e29284","429":"9418c0a9-9143-427e-b1f6-3ffe1510722f"},"summary":"Inits with users","tags":["Usage \u0026 Sessions"],"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/inits/users","baseUrlOptions":["https://{search_zone}-api.doofinder.com","/"],"title":"Inits with users","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"1ab9bec0-fe03-4b82-83fc-9b53488df584":{"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"}},"b490ee07-b8ea-4814-96a4-fb31d76aa073":{"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"}},"1912c935-a908-4441-a761-6a11cf18f187":{"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[]"}},"0191e2a7-da94-4e78-af14-bedc3d219866":{"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":{"af885563-d847-4ffb-9931-1085cd40113c":{"content":{"application/json":{"schema":{"type":"object","title":"Inits Users","description":"Inits users result.","example":{"results":[{"sessions":12170,"unique_sessions":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":{"sessions":{"example":12170,"type":"integer","uniqueKey":"results.items.[INDEX].sessions","typeLabel":"integer"},"unique_sessions":{"example":159080,"type":"integer","uniqueKey":"results.items.[INDEX].unique_sessions","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":"Inits Users · object"},"examples":{"Example":{"title":"Example","value":{"results":[{"sessions":12170,"unique_sessions":159080,"users":5876}],"total":1,"total_count":1}}},"exampleType":"generated"}},"description":"Stats retrieved.","exampleType":"generated"},"2e83244f-0ce7-46db-b2d8-1d01326cecba":{"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"},"15a224ed-3e9b-4c1a-a2d6-6b3ccb7fe53c":{"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"},"f7139849-650c-41c5-8100-926c8cfa16b8":{"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"},"6f60aa83-269b-425c-8db4-b33f2421534d":{"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"},"2eb16212-d3ca-4f98-9f57-f11921e29284":{"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"},"9418c0a9-9143-427e-b1f6-3ffe1510722f":{"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":"Inits with users - Doofinder API Reference","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-05T10:48:00.738Z","originalFileLocation":"api-reference/usage-\u0026-sessions/inits-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 in sessions 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=\"Inits with users - Doofinder API Reference\">\u003cmeta data-mint-head property=\"og:description\" content=\"Counts numbers of different users in sessions 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/usage-\u0026amp;-sessions/inits-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=Usage+%26+Sessions\u0026amp;title=Inits+with+users\u0026amp;description=Counts+numbers+of+different+users+in+sessions+for+a+time+period.\u0026amp;theme=aed6141c6b33efdfd60407a2\u0026amp;signature=4ad29a5713f6162d8c6579da9c1a28c264cf82bcdc1c9d9bdcce07a80cd964c4\">\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=\"Inits with users - Doofinder API Reference\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Counts numbers of different users in sessions for a time period.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://doofinder.mintlify.site/_mintlify/api/og/v2?division=Usage+%26+Sessions\u0026amp;title=Inits+with+users\u0026amp;description=Counts+numbers+of+different+users+in+sessions+for+a+time+period.\u0026amp;theme=aed6141c6b33efdfd60407a2\u0026amp;signature=4ad29a5713f6162d8c6579da9c1a28c264cf82bcdc1c9d9bdcce07a80cd964c4\">\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/usage-\u0026amp;-sessions/inits-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/usage-%26-sessions/inits-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/usage-\u0026-sessions/inits-with-users#webpage\",\"url\":\"https://docs.doofinder.com/api-reference/usage-\u0026-sessions/inits-with-users\",\"name\":\"Inits with users\",\"description\":\"Counts numbers of different users in sessions for a time period.\",\"dateModified\":\"2026-11-05T10:48:00.738Z\",\"isPartOf\":{\"@id\":\"https://docs.doofinder.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.doofinder.com/api-reference/usage-\u0026-sessions/inits-with-users#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.doofinder.com/api-reference/usage-\u0026-sessions/inits-with-users#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.doofinder.com/api-reference/features/banners\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Usage \u0026 Sessions\",\"item\":\"https://docs.doofinder.com/api-reference/usage-\u0026-sessions/sessions\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Inits with users\",\"item\":\"https://docs.doofinder.com/api-reference/usage-\u0026-sessions/inits-with-users\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.doofinder.com/api-reference/usage-\u0026-sessions/inits-with-users#apireference\",\"headline\":\"Inits with users\",\"name\":\"Inits with users\",\"description\":\"Counts numbers of different users in sessions for a time period.\",\"url\":\"https://docs.doofinder.com/api-reference/usage-\u0026-sessions/inits-with-users\",\"mainEntityOfPage\":{\"@id\":\"https://docs.doofinder.com/api-reference/usage-\u0026-sessions/inits-with-users#webpage\"},\"dateModified\":\"2026-11-05T10:48:00.738Z\",\"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/usage-%26-sessions/inits-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","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","description":"Gets all sessions geolocation for a time period.","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","description":"Gets how many visits a Search engine receive and from that users how many inits \u0026 searches in a time period","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":"Inits 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"]}