Returns a paginated list of people (visitors) over the requested date range, with their key
attributes (identity, location, source, device, revenue, sessions). Supports optional filters.Request:
cURL
curl -X GET 'https://taap.it/api/v1/radar/people?start=2026-01-01T00:00:00Z&end=2026-01-31T23:59:59Z&limit=50&sort=recent' \ -H 'Authorization: Bearer taapit_your_api_key_here'
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/schema.json","name":"taap.it API","colors":{"primary":"#0D9373","light":"#07C983","dark":"#0D9373"},"logo":{"light":"https://mintcdn.com/taapit/HdiP2EtQB3X8WbsF/images/logo.svg?fit=max\u0026auto=format\u0026n=HdiP2EtQB3X8WbsF\u0026q=85\u0026s=2ff95b7ba2e8293fd544920343d71f8f","dark":"https://mintcdn.com/taapit/HdiP2EtQB3X8WbsF/images/logo.svg?fit=max\u0026auto=format\u0026n=HdiP2EtQB3X8WbsF\u0026q=85\u0026s=2ff95b7ba2e8293fd544920343d71f8f"},"favicon":"https://mintcdn.com/taapit/HdiP2EtQB3X8WbsF/images/favicon-32x32.png?fit=max\u0026auto=format\u0026n=HdiP2EtQB3X8WbsF\u0026q=85\u0026s=e55775b1ac27ad69c39ed47a39465f25","styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":""},{"language":"fr","href":"fr"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"taapit","hasAudioNarration":false,"actualSubdomain":"taapit","customDomains":["docs.taap.it"],"gitSource":{"type":"github","owner":"taapit","repo":"taapit-api","deployBranch":"main","contentDirectory":"docs","isPrivate":true,"mountPath":"","label":""},"feedback":{"edits":false},"entitlements":{},"buildId":"6ae92616d9a51c36fb3c2318:success","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"fr","tag":"Référence API","count":30},{"language":"en","tag":"API Reference","count":29},{"language":"en","tag":"Radar API","count":9},{"language":"fr","tag":"API Radar","count":9},{"language":"en","tag":"Conversions","count":6},{"language":"fr","tag":"Conversions","count":6},{"language":"en","tag":"Links API","count":5},{"language":"en","tag":"Projects API","count":5},{"language":"fr","tag":"API Domaines","count":5},{"language":"fr","tag":"API Links","count":5},{"language":"fr","tag":"API Projets","count":5},{"language":"en","tag":"Domains API","count":4},{"language":"en","tag":"Stats API","count":4},{"language":"en","tag":"Getting started","count":4},{"language":"fr","tag":"API Statistiques","count":4},{"language":"fr","tag":"Commencer","count":4},{"language":"en","tag":"Events API","count":2},{"language":"en","tag":"Automatic Integrations","count":2},{"language":"fr","tag":"API Events","count":2},{"language":"fr","tag":"Intégrations automatiques","count":2}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/radar/people","slug":"/api-reference/radar/people","pageMetadata":{"title":"People","api":"GET https://taap.it/api/v1/radar/people","description":"List people (visitors) for the project bound to your API key","href":"/api-reference/radar/people"},"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: \"List people (visitors) for the project bound to your API key\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,..._provideComponents(),...props.components},{CodeBlock,Expandable,Heading,ParamField,ResponseField}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Expandable)_missingMdxReference(`Expandable`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!ParamField)_missingMdxReference(`ParamField`,true);if(!ResponseField)_missingMdxReference(`ResponseField`,true);return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Returns a paginated list of people (visitors) over the requested date range, with their key\nattributes (identity, location, source, device, revenue, sessions). Supports optional filters.`}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Request:`})}),`\n`,_jsx(CodeBlock,{filename:`cURL`,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -X`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` GET`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'https://taap.it/api/v1/radar/people?start=2026-01-01T00:00:00Z\u0026end=2026-01-31T23:59:59Z\u0026limit=50\u0026sort=recent'`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D7BA7D`},children:` \\\\`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -H`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'Authorization: Bearer taapit_your_api_key_here'`})]}),`\n`]})})}),`\n`,_jsx(_components.p,{children:_jsx(_components.strong,{children:`Response:`})}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`22`,language:`json`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`json`,children:_jsxs(_components.code,{language:`json`,numberOfLines:`22`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"data\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"visitorId\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"v_8a1c2d\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"name\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Quiet Fox\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"email\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"jane@example.com\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"status\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"identified\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"countryCode\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"FR\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"countryName\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"France\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"source\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"google\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"browser\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"Chrome\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"device\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"desktop\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"revenue\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`120.0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"sessions\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`4`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"events\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`37`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"firstSeen\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-01-03T09:12:00.000Z\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"lastSeen\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"2026-01-28T17:42:00.000Z\"`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ],`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"total\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`1842`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#116329`,\"--shiki-dark\":`#9CDCFE`},children:` \"limit\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`: `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`50`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`authorization`,children:`Authorization`}),`\n`,_jsx(ParamField,{header:`Authorization`,type:`string`,required:true,id:`param-authorization`,children:_jsxs(_components.p,{children:[`Bearer token with your Radar API key. Format: `,_jsx(_components.code,{children:`Bearer taapit_...`})]})}),`\n`,_jsx(Heading,{level:`2`,id:`query-parameters`,children:`Query Parameters`}),`\n`,_jsx(ParamField,{query:`start`,type:`string`,required:true,id:`param-start`,children:_jsxs(_components.p,{children:[`Start of the range, ISO 8601 (UTC). Example: `,_jsx(_components.code,{children:`2026-01-01T00:00:00Z`}),`.`]})}),`\n`,_jsx(ParamField,{query:`end`,type:`string`,required:true,id:`param-end`,children:_jsxs(_components.p,{children:[`End of the range, ISO 8601 (UTC). Example: `,_jsx(_components.code,{children:`2026-01-31T23:59:59Z`}),`.`]})}),`\n`,_jsx(ParamField,{query:`sort`,type:`string`,default:`recent`,id:`param-sort`,children:_jsxs(_components.p,{children:[`Sort order. `,_jsx(_components.code,{children:`recent`}),` (last activity), `,_jsx(_components.code,{children:`revenue`}),`, `,_jsx(_components.code,{children:`sessions`}),` or `,_jsx(_components.code,{children:`events`}),`.`]})}),`\n`,_jsx(ParamField,{query:`limit`,type:`integer`,default:`200`,id:`param-limit`,children:_jsxs(_components.p,{children:[`Maximum number of people to return. Capped at `,_jsx(_components.code,{children:`1000`}),`.`]})}),`\n`,_jsx(ParamField,{query:`country`,type:`string`,id:`param-country`,children:_jsxs(_components.p,{children:[`Filter by ISO-2 country code (e.g. `,_jsx(_components.code,{children:`FR`}),`).`]})}),`\n`,_jsx(ParamField,{query:`browser`,type:`string`,id:`param-browser`,children:_jsxs(_components.p,{children:[`Filter by browser name (e.g. `,_jsx(_components.code,{children:`Chrome`}),`).`]})}),`\n`,_jsx(ParamField,{query:`device`,type:`string`,id:`param-device`,children:_jsxs(_components.p,{children:[`Filter by device type (`,_jsx(_components.code,{children:`desktop`}),`, `,_jsx(_components.code,{children:`mobile`}),`, `,_jsx(_components.code,{children:`tablet`}),`).`]})}),`\n`,_jsx(ParamField,{query:`referrer`,type:`string`,id:`param-referrer`,children:_jsx(_components.p,{children:`Filter by traffic source / referrer.`})}),`\n`,_jsx(ParamField,{query:`identity`,type:`string`,id:`param-identity`,children:_jsxs(_components.p,{children:[`Filter by identity status (`,_jsx(_components.code,{children:`identified`}),` or `,_jsx(_components.code,{children:`anonymous`}),`).`]})}),`\n`,_jsx(ParamField,{query:`activity`,type:`string`,id:`param-activity`,children:_jsx(_components.p,{children:`Filter by activity level.`})}),`\n`,_jsx(Heading,{level:`2`,id:`response-fields`,children:`Response Fields`}),`\n`,_jsxs(ResponseField,{name:`data`,type:`array`,required:true,id:`param-data`,children:[_jsx(_components.p,{children:`Array of people.`}),_jsxs(Expandable,{title:`Person`,defaultOpen:true,children:[_jsx(ResponseField,{name:`visitorId`,type:`string`,id:`param-visitor-id`,children:`Stable visitor identifier.`}),_jsx(ResponseField,{name:`name`,type:`string`,id:`param-name`,children:`Real name if known, otherwise a generated alias.`}),_jsx(ResponseField,{name:`email`,type:`string | null`,id:`param-email`,children:`Email when the visitor is identified.`}),_jsxs(ResponseField,{name:`status`,type:`string`,id:`param-status`,children:[_jsx(_components.code,{children:`identified`}),` or `,_jsx(_components.code,{children:`anonymous`}),`.`]}),_jsxs(ResponseField,{name:`countryCode`,type:`string`,id:`param-country-code`,children:[`ISO-2 country code, or `,_jsx(_components.code,{children:`XX`}),` if unknown.`]}),_jsx(ResponseField,{name:`countryName`,type:`string`,id:`param-country-name`,children:`Human-readable country name.`}),_jsx(ResponseField,{name:`source`,type:`string`,id:`param-source`,children:`Traffic source / referrer.`}),_jsx(ResponseField,{name:`browser`,type:`string`,id:`param-browser-1`,children:`Browser name.`}),_jsx(ResponseField,{name:`device`,type:`string`,id:`param-device-1`,children:`Device type.`}),_jsx(ResponseField,{name:`revenue`,type:`number`,id:`param-revenue`,children:`Total attributed revenue.`}),_jsx(ResponseField,{name:`sessions`,type:`number`,id:`param-sessions`,children:`Number of sessions.`}),_jsx(ResponseField,{name:`events`,type:`number`,id:`param-events`,children:`Number of events.`}),_jsx(ResponseField,{name:`firstSeen`,type:`string`,id:`param-first-seen`,children:`First activity, ISO 8601.`}),_jsx(ResponseField,{name:`lastSeen`,type:`string`,id:`param-last-seen`,children:`Last activity, ISO 8601.`})]})]}),`\n`,_jsx(ResponseField,{name:`total`,type:`integer`,id:`param-total`,children:_jsxs(_components.p,{children:[`Total number of people in the range (unfiltered). Equals `,_jsx(_components.code,{children:`data.length`}),` when filters are applied.`]})}),`\n`,_jsx(ResponseField,{name:`limit`,type:`integer`,id:`param-limit-1`,children:_jsx(_components.p,{children:`The effective limit applied to this response.`})})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"People","api":"GET https://taap.it/api/v1/radar/people","description":"List people (visitors) for the project bound to your API key","href":"/api-reference/radar/people"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Authorization","slug":"authorization","depth":2,"children":[]},{"title":"Query Parameters","slug":"query-parameters","depth":2,"children":[]},{"title":"Response Fields","slug":"response-fields","depth":2,"children":[]}],"codeExamples":{},"endpoint":{"title":"People","path":"/api/v1/radar/people","servers":[{"url":"https://taap.it"}],"method":"get","request":{"security":[],"parameters":{"query":{"start":{"schema":[{"type":"string","description":"Start of the range, ISO 8601 (UTC). Example: `2026-01-01T00:00:00Z` .","required":true}]},"end":{"schema":[{"type":"string","description":"End of the range, ISO 8601 (UTC). Example: `2026-01-31T23:59:59Z` .","required":true}]},"sort":{"schema":[{"type":"string","description":"Sort order. `recent` (last activity), `revenue` , `sessions` or `events` ."}]},"limit":{"schema":[{"type":"integer","description":"Maximum number of people to return. Capped at `1000` ."}]},"country":{"schema":[{"type":"string","description":"Filter by ISO-2 country code (e.g. `FR` )."}]},"browser":{"schema":[{"type":"string","description":"Filter by browser name (e.g. `Chrome` )."}]},"device":{"schema":[{"type":"string","description":"Filter by device type ( `desktop` , `mobile` , `tablet` )."}]},"referrer":{"schema":[{"type":"string","description":"Filter by traffic source / referrer."}]},"identity":{"schema":[{"type":"string","description":"Filter by identity status ( `identified` or `anonymous` )."}]},"activity":{"schema":[{"type":"string","description":"Filter by activity level."}]}},"header":{"Authorization":{"schema":[{"type":"string","description":"Bearer token with your Radar API key. Format: `Bearer taapit_...`","required":true}]}},"cookie":{},"path":{}},"body":{}},"response":{"200":{"application/json":{"schemaArray":[{"type":"object","properties":{"data":[{"type":"array","items":[{"type":"object","properties":{"visitorId":[{"type":"string","description":"Stable visitor identifier."}],"name":[{"type":"string","description":"Real name if known, otherwise a generated alias."}],"email":[{"type":"object","properties":{},"description":"Email when the visitor is identified."}],"status":[{"type":"string","description":"`identified` or `anonymous` ."}],"countryCode":[{"type":"string","description":"ISO-2 country code, or `XX` if unknown."}],"countryName":[{"type":"string","description":"Human-readable country name."}],"source":[{"type":"string","description":"Traffic source / referrer."}],"browser":[{"type":"string","description":"Browser name."}],"device":[{"type":"string","description":"Device type."}],"revenue":[{"type":"number","description":"Total attributed revenue."}],"sessions":[{"type":"number","description":"Number of sessions."}],"events":[{"type":"number","description":"Number of events."}],"firstSeen":[{"type":"string","description":"First activity, ISO 8601."}],"lastSeen":[{"type":"string","description":"Last activity, ISO 8601."}]}}],"description":"Array of people.","required":true}],"total":[{"type":"integer","description":"Total number of people in the range (unfiltered). Equals `data.length` when filters are applied."}],"limit":[{"type":"integer","description":"The effective limit applied to this response."}]}}],"examples":{"example":{"value":{"data":[{"visitorId":"\u003cstring>","name":"\u003cstring>","email":{},"status":"\u003cstring>","countryCode":"\u003cstring>","countryName":"\u003cstring>","source":"\u003cstring>","browser":"\u003cstring>","device":"\u003cstring>","revenue":123,"sessions":123,"events":123,"firstSeen":"\u003cstring>","lastSeen":"\u003cstring>"}],"total":123,"limit":123}}}}}},"deprecated":false}},"jsLinks":[],"subdomain":"taapit","siteName":"taap.it API","title":"People - taap.it API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/api-reference/radar/people","matchLevel":0},"fr":{"href":"/fr/api-reference/radar/people","matchLevel":1}}},"lastModified":"2026-06-29T14:44:55.915Z","originalFileLocation":"api-reference/radar/people.mdx","locale":"en"},"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=\"List people (visitors) for the project bound to your API key\">\u003cmeta data-mint-head name=\"application-name\" content=\"taap.it API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/taapit/FoM6EIaZ1C8zsUEO/_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/taapit/FoM6EIaZ1C8zsUEO/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/taapit/FoM6EIaZ1C8zsUEO/_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/taapit/FoM6EIaZ1C8zsUEO/_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/taapit/FoM6EIaZ1C8zsUEO/_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/taapit/FoM6EIaZ1C8zsUEO/_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/taapit/FoM6EIaZ1C8zsUEO/_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/taapit/FoM6EIaZ1C8zsUEO/_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/taapit/FoM6EIaZ1C8zsUEO/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"People - taap.it API\">\u003cmeta data-mint-head property=\"og:description\" content=\"List people (visitors) for the project bound to your API key\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"taap.it API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.taap.it/api-reference/radar/people\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://taapit.mintlify.site/_mintlify/api/og/v2?division=Radar+API\u0026amp;title=People\u0026amp;description=List+people+%28visitors%29+for+the+project+bound+to+your+API+key\u0026amp;theme=67deebb0e8b4c1bab48e29b6\u0026amp;signature=b9f3498a37a24b6d1e28052c9e07847bce0079733deff934e56c1ce27c457683\">\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=\"People - taap.it API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"List people (visitors) for the project bound to your API key\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://taapit.mintlify.site/_mintlify/api/og/v2?division=Radar+API\u0026amp;title=People\u0026amp;description=List+people+%28visitors%29+for+the+project+bound+to+your+API+key\u0026amp;theme=67deebb0e8b4c1bab48e29b6\u0026amp;signature=b9f3498a37a24b6d1e28052c9e07847bce0079733deff934e56c1ce27c457683\">\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/taapit/FoM6EIaZ1C8zsUEO/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"taap.it API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0D9373\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.taap.it/api-reference/radar/people\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/radar/people.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.taap.it/api-reference/radar/people\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"fr\" href=\"https://docs.taap.it/fr/api-reference/radar/people\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.taap.it/api-reference/radar/people\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.taap.it/#organization\",\"name\":\"taap.it API\",\"url\":\"https://docs.taap.it\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/taapit/HdiP2EtQB3X8WbsF/images/logo.svg?fit=max\u0026auto=format\u0026n=HdiP2EtQB3X8WbsF\u0026q=85\u0026s=2ff95b7ba2e8293fd544920343d71f8f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.taap.it#website\",\"name\":\"taap.it API\",\"url\":\"https://docs.taap.it\",\"publisher\":{\"@id\":\"https://docs.taap.it/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.taap.it/api-reference/radar/people#webpage\",\"url\":\"https://docs.taap.it/api-reference/radar/people\",\"name\":\"People\",\"description\":\"List people (visitors) for the project bound to your API key\",\"dateModified\":\"2026-06-29T14:44:55.915Z\",\"isPartOf\":{\"@id\":\"https://docs.taap.it#website\"},\"breadcrumb\":{\"@id\":\"https://docs.taap.it/api-reference/radar/people#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.taap.it/api-reference/radar/people#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://docs.taap.it/api-reference/events/lead\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Radar API\",\"item\":\"https://docs.taap.it/api-reference/radar/introduction\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"People\",\"item\":\"https://docs.taap.it/api-reference/radar/people\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.taap.it/api-reference/radar/people#apireference\",\"headline\":\"People\",\"name\":\"People\",\"description\":\"List people (visitors) for the project bound to your API key\",\"url\":\"https://docs.taap.it/api-reference/radar/people\",\"mainEntityOfPage\":{\"@id\":\"https://docs.taap.it/api-reference/radar/people#webpage\"},\"dateModified\":\"2026-06-29T14:44:55.915Z\",\"publisher\":{\"@id\":\"https://docs.taap.it/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.taap.it#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"taap.it API\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"taap.it API\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/radar/people.md","siteName":"taap.it API","nav":{"global":null,"languages":[{"language":"en","default":true,"groups":[{"group":"Getting started","pages":[{"title":"taap.it API Documentation","href":""},{"title":"Introduction","href":"/introduction"},{"title":"Quickstart Guide","href":"/quickstart"},{"title":"Authentication","href":"/authentication"}]},{"group":"Conversions","pages":[{"title":"Overview","href":"/conversions/overview"},{"title":"How Conversions Work","href":"/conversions/how-conversions-work"},{"group":"Automatic Integrations","pages":[{"title":"Stripe","href":"/conversions/automatic/stripe"},{"title":"Shopify","href":"/conversions/automatic/shopify"}]},{"group":"Manual Integration","pages":[{"title":"Client-side Integration","href":"/conversions/manual/client-side"},{"title":"Server-side Integration (Recommended)","href":"/conversions/manual/server-side"}]}]},{"group":"API Reference","pages":[{"group":"Events API","pages":[{"title":"Track Lead","api":"POST /api/events/lead","href":"/api-reference/events/lead"},{"title":"Track Sale","api":"POST /api/events/sale","href":"/api-reference/events/sale"}]},{"group":"Links API","pages":[{"title":"Create Link","api":"POST https://api.taap.it/v1/links","href":"/api-reference/links/create"},{"title":"List Links","api":"GET https://api.taap.it/v1/links","href":"/api-reference/links/list"},{"title":"Retrieve Link","api":"GET https://api.taap.it/v1/links/{link_id}","href":"/api-reference/links/get"},{"title":"Update Link","api":"PUT https://api.taap.it/v1/links/{link_id}","href":"/api-reference/links/update"},{"title":"Delete Link","api":"DELETE https://api.taap.it/v1/links/{link_id}","href":"/api-reference/links/delete"}]},{"group":"Domains API","pages":[{"title":"Create Domain","api":"POST https://api.taap.it/v1/domains","href":"/api-reference/domains/create"},{"title":"List Domains","api":"GET https://api.taap.it/v1/domains","href":"/api-reference/domains/list"},{"title":"Retrieve Domain","api":"GET https://api.taap.it/v1/domains/{domain_id}","href":"/api-reference/domains/get"},{"title":"Delete Domain","api":"DELETE https://api.taap.it/v1/domains/{domain_id}","href":"/api-reference/domains/delete"}]},{"group":"Projects API","pages":[{"title":"Create Project","api":"POST https://api.taap.it/v1/projects","href":"/api-reference/projects/create"},{"title":"List Projects","api":"GET https://api.taap.it/v1/projects","href":"/api-reference/projects/list"},{"title":"Retrieve Project","api":"GET https://api.taap.it/v1/projects/{project_id}","href":"/api-reference/projects/get"},{"title":"Update Project","api":"PUT https://api.taap.it/v1/projects/{project_id}","href":"/api-reference/projects/update"},{"title":"Delete Project","api":"DELETE https://api.taap.it/v1/projects/{project_id}","href":"/api-reference/projects/delete"}]},{"group":"Stats API","pages":[{"title":"Link Statistics","api":"GET https://api.taap.it/v1/stats/links/{link_id}","href":"/api-reference/stats/link-stats"},{"title":"Link Stats Summary","api":"GET https://api.taap.it/v1/stats/links/{link_id}/summary","href":"/api-reference/stats/link-summary"},{"title":"Workspace Statistics","api":"GET https://api.taap.it/v1/stats/workspaces","href":"/api-reference/stats/workspace-stats"},{"title":"Workspace Stats Summary","api":"GET https://api.taap.it/v1/stats/workspaces/summary","href":"/api-reference/stats/workspace-summary"}]},{"group":"Radar API","pages":[{"title":"Radar API","href":"/api-reference/radar/introduction"},{"title":"Metrics","api":"GET https://taap.it/api/v1/radar/overview","href":"/api-reference/radar/metrics"},{"title":"Time series","api":"GET https://taap.it/api/v1/radar/timeseries","href":"/api-reference/radar/timeseries"},{"title":"Realtime","api":"GET https://taap.it/api/v1/radar/realtime","href":"/api-reference/radar/realtime"},{"title":"Breakdowns","api":"GET https://taap.it/api/v1/radar/breakdowns","description":"Retrieve top pages, sources, locations and devices","href":"/api-reference/radar/breakdowns"},{"title":"People","api":"GET https://taap.it/api/v1/radar/people","href":"/api-reference/radar/people"},{"title":"Person details","api":"GET https://taap.it/api/v1/radar/people/details","description":"Retrieve a single person with their sessions and activity heatmap","href":"/api-reference/radar/people-details"},{"title":"Last visitors","api":"GET https://taap.it/api/v1/radar/last-visitors","href":"/api-reference/radar/last-visitors"},{"title":"Custom events","api":"GET https://taap.it/api/v1/radar/custom-events","href":"/api-reference/radar/custom-events"}]}]}]},{"language":"fr","pages":[{"title":"fr","href":"/fr/api-reference/radar/people"}]}]},"basePath":"","title":"People - taap.it API","buildId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","deploymentId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff"],"chunks":["OpenApiReferenceProvider-DDP9JXtj.js","utils-8yQyvEtx.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CBCFR8Sn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-rQaXkUHa.js","snippetPresets-J5KpBTgV.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BVxVH4Cj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BxdQ2vIi.js","shallow-BjV2tFiD.js","getApiPlaygroundDisplay-C_55tL4O.js","CodeSnippet-C0JpiCOC.js","CodeSnippets-w9Ps7djG.js","Page-DTNSD-0M.js","getPastedJson-BDfB-H8d.js","icon-g-kUkkO9.js","MethodPill-v4l6fq0h.js","DuplicateIcon-CvLo-CfU.js","createIcon-165clrrV.js","DynamicMarkdown-D3RQ-fEj.js","SectionHeading-vvo-3yLf.js","axios-vUo_bRtp.js"]}