How Pinto gives every session a stable, distinct browser identity.
Every Pinto session is fingerprinted as a real, distinct device. On first use, Pinto generates a stable browser profile and stores it on the session. A given client always sends the same identity, but different clients look like different devices.Each profile includes:
a User-Agent (Chrome, Firefox, Edge, Safari, or Opera on Windows, macOS, Linux, Android, or iOS)
a matching Accept-Language
consistent sec-ch-ua, sec-ch-ua-mobile, and sec-ch-ua-platform headers
This lets many anonymous readers avoid tripping a single global fingerprint.To pin a session to one egress IP, inject a custom fetch. See Proxies and custom fetch.
⌘I
{"docsConfig":{"theme":"luma","$schema":"https://mintlify.com/docs.json","name":"Traceryn","description":"Documentation for Traceryn, an open-source organization building developer-first TypeScript tools and SDKs, including TikTok SDK, Pinto, and more projects to come.","colors":{"primary":"#1E3A8A","light":"#3B82F6","dark":"#1E3A8A"},"logo":{"light":"https://raw.githubusercontent.com/Traceryn/.github/main/profile/Tracerynorg.png","dark":"https://raw.githubusercontent.com/Traceryn/.github/main/profile/Tracerynorg.png","href":"/"},"favicon":"https://raw.githubusercontent.com/Traceryn/.github/main/profile/Tracerynorg.png","appearance":{"default":"light"},"background":{"color":{"light":"#FFFFFF","dark":"#000000"}},"navbar":{"links":[{"icon":"heart","href":"https://github.com/sponsors/Corex24","label":"Sponsor"}],"primary":{"type":"github","href":"https://github.com/Traceryn"}},"footer":{"socials":{"github":"https://github.com/Traceryn"}},"seo":{"metatags":{"description":"Documentation for Traceryn, an open-source organization building developer-first TypeScript tools and SDKs, including TikTok SDK, Pinto, and more projects to come.","keywords":"Traceryn, open source, TypeScript, Node.js, SDK, TikTok SDK, TikTok API, Pinto, Pinterest API, developer tools, web data","author":"Corex Anthony","theme-color":"#1E3A8A","og:type":"website","og:site_name":"Traceryn Docs","og:title":"Traceryn Docs | Open-source developer tools and SDKs","og:description":"Guides and API references for every Traceryn project: TikTok SDK, Pinto, and the tools still to come.","og:image":"https://raw.githubusercontent.com/Traceryn/.github/main/profile/Tracerynorg.png","og:locale":"en_US","twitter:card":"summary_large_image","twitter:title":"Traceryn Docs | Open-source developer tools and SDKs","twitter:description":"Guides and API references for every Traceryn project: TikTok SDK, Pinto, and the tools still to come.","twitter:image":"https://raw.githubusercontent.com/Traceryn/.github/main/profile/Tracerynorg.png"},"indexing":"navigable"},"fonts":{"family":"Geist"},"contextual":{"options":["copy","view","chatgpt","claude","mcp","add-mcp","cursor","perplexity"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"traceryn","hasAudioNarration":false,"actualSubdomain":"traceryn","customDomains":[],"gitSource":{"type":"github","owner":"traceryn","repo":"doc","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":"","_id":"6ae69c1e833f98ca2ec82ed4"},"chroma":{"latestBuiltDeploymentHistoryId":"6ae6a05d8c40a3519a1895af","collectionId":"822edd32-5dbe-49f4-9d1c-6dfe4493dfd2","liveDeploymentHistoryId":"6ae6a05d8c40a3519a1895af","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6ae6a7c3149aa82e6210ad42","clientVersion":"0.0.4044","searchFilterCounts":[{"language":"default","tag":"Pinto","count":14},{"language":"default","tag":"TikTok SDK","count":9},{"language":"default","tag":"Get started","count":6},{"language":"default","tag":"Reading data","count":5},{"language":"default","tag":"Production","count":4},{"language":"default","tag":"Guides","count":4},{"language":"default","tag":"Home","count":2},{"language":"default","tag":"Start here","count":2},{"language":"default","tag":"Sessions","count":2},{"language":"default","tag":"Reference","count":2}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","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":"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":"llms-txt-v2","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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":"#footer a[href*=\"mintlify.com\"],[data-layout-item=footer] a[href*=\"mintlify.com\"],footer a[href*=\"mintlify.com\"]{display:none!important}.traceryn-copyright{width:100%;margin-top:1rem;text-align:center;font-size:.875rem;opacity:.7}"}],"page":{"pagePath":"pinto/fingerprinting","slug":"/pinto/fingerprinting","pageMetadata":{"title":"Device fingerprinting","sidebarTitle":"Fingerprinting","description":"How Pinto gives every session a stable, distinct browser identity.","href":"/pinto/fingerprinting"},"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: \"How Pinto gives every session a stable, distinct browser identity.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,p:`p`,ul:`ul`,..._provideComponents(),...props.components};return _jsxs(_Fragment,{children:[_jsx(_components.p,{children:`Every Pinto session is fingerprinted as a real, distinct device. On first use, Pinto generates a stable browser profile and stores it on the session. A given client always sends the same identity, but different clients look like different devices.`}),`\n`,_jsx(_components.p,{children:`Each profile includes:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[`a `,_jsx(_components.code,{children:`User-Agent`}),` (Chrome, Firefox, Edge, Safari, or Opera on Windows, macOS, Linux, Android, or iOS)`]}),`\n`,_jsxs(_components.li,{children:[`a matching `,_jsx(_components.code,{children:`Accept-Language`})]}),`\n`,_jsxs(_components.li,{children:[`consistent `,_jsx(_components.code,{children:`sec-ch-ua`}),`, `,_jsx(_components.code,{children:`sec-ch-ua-mobile`}),`, and `,_jsx(_components.code,{children:`sec-ch-ua-platform`}),` headers`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`This lets many anonymous readers avoid tripping a single global fingerprint.`}),`\n`,_jsxs(_components.p,{children:[`To pin a session to one egress IP, inject a custom `,_jsx(_components.code,{children:`fetch`}),`. See `,_jsx(_components.a,{href:`/pinto/proxies`,children:`Proxies and custom fetch`}),`.`]})]})}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":"Device fingerprinting","sidebarTitle":"Fingerprinting","description":"How Pinto gives every session a stable, distinct browser identity.","href":"/pinto/fingerprinting"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/traceryn/556fb13c2a09ac11/footer.js"],"subdomain":"traceryn","siteName":"Traceryn","title":"Traceryn Docs | Open-source developer tools and SDKs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-01T02:02:21.220Z","originalFileLocation":"pinto/fingerprinting.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=\"light\"}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=\"How Pinto gives every session a stable, distinct browser identity.\">\u003cmeta data-mint-head name=\"keywords\" content=\"Traceryn, open source, TypeScript, Node.js, SDK, TikTok SDK, TikTok API, Pinto, Pinterest API, developer tools, web data\">\u003cmeta data-mint-head name=\"application-name\" content=\"Traceryn\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://raw.githubusercontent.com/Traceryn/.github/main/profile/Tracerynorg.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://raw.githubusercontent.com/Traceryn/.github/main/profile/Tracerynorg.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://raw.githubusercontent.com/Traceryn/.github/main/profile/Tracerynorg.png\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/png\" href=\"https://raw.githubusercontent.com/Traceryn/.github/main/profile/Tracerynorg.png\">\u003cmeta data-mint-head property=\"og:title\" content=\"Traceryn Docs | Open-source developer tools and SDKs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Guides and API references for every Traceryn project: TikTok SDK, Pinto, and the tools still to come.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Traceryn Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://traceryn.mintlify.app/pinto/fingerprinting\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://raw.githubusercontent.com/Traceryn/.github/main/profile/Tracerynorg.png\">\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=\"Traceryn Docs | Open-source developer tools and SDKs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Guides and API references for every Traceryn project: TikTok SDK, Pinto, and the tools still to come.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://raw.githubusercontent.com/Traceryn/.github/main/profile/Tracerynorg.png\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/traceryn/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Traceryn\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#1E3A8A\">\u003cmeta data-mint-head name=\"og:locale\" content=\"en_US\">\u003cmeta data-mint-head name=\"author\" content=\"Corex Anthony\">\u003cmeta data-mint-head name=\"theme-color\" content=\"#1E3A8A\">\u003clink data-mint-head rel=\"canonical\" href=\"https://traceryn.mintlify.app/pinto/fingerprinting\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/pinto/fingerprinting.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://traceryn.mintlify.app/#organization\",\"name\":\"Traceryn\",\"url\":\"https://traceryn.mintlify.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://raw.githubusercontent.com/Traceryn/.github/main/profile/Tracerynorg.png\"}},{\"@type\":\"WebSite\",\"@id\":\"https://traceryn.mintlify.app#website\",\"name\":\"Traceryn\",\"url\":\"https://traceryn.mintlify.app\",\"publisher\":{\"@id\":\"https://traceryn.mintlify.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://traceryn.mintlify.app/pinto/fingerprinting#webpage\",\"url\":\"https://traceryn.mintlify.app/pinto/fingerprinting\",\"name\":\"Device fingerprinting\",\"description\":\"How Pinto gives every session a stable, distinct browser identity.\",\"dateModified\":\"2026-11-01T02:02:21.220Z\",\"isPartOf\":{\"@id\":\"https://traceryn.mintlify.app#website\"},\"breadcrumb\":{\"@id\":\"https://traceryn.mintlify.app/pinto/fingerprinting#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://traceryn.mintlify.app/pinto/fingerprinting#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Sessions\",\"item\":\"https://traceryn.mintlify.app/pinto/authentication\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Device fingerprinting\",\"item\":\"https://traceryn.mintlify.app/pinto/fingerprinting\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://traceryn.mintlify.app/pinto/fingerprinting#article\",\"headline\":\"Device fingerprinting\",\"name\":\"Device fingerprinting\",\"description\":\"How Pinto gives every session a stable, distinct browser identity.\",\"url\":\"https://traceryn.mintlify.app/pinto/fingerprinting\",\"mainEntityOfPage\":{\"@id\":\"https://traceryn.mintlify.app/pinto/fingerprinting#webpage\"},\"image\":\"https://raw.githubusercontent.com/Traceryn/.github/main/profile/Tracerynorg.png\",\"dateModified\":\"2026-11-01T02:02:21.220Z\",\"publisher\":{\"@id\":\"https://traceryn.mintlify.app/#organization\"},\"isPartOf\":{\"@id\":\"https://traceryn.mintlify.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Traceryn\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Traceryn","nav":{"global":null,"tabs":[{"tab":"Home","icon":"house","pages":[{"title":"Home","href":""}]},{"tab":"TikTok SDK","icon":"tiktok","pages":[{"title":"TikTok SDK","href":"/tiktok-sdk/overview"}]},{"tab":"Pinto","icon":"pinterest","groups":[{"group":"Get started","icon":"rocket","pages":[{"title":"Pinto overview","sidebarTitle":"Overview","href":"/pinto/overview"},{"title":"How Pinto works","sidebarTitle":"How it works","href":"/pinto/how-it-works"},{"title":"Pinto quickstart","sidebarTitle":"Quickstart","href":"/pinto/quickstart"}]},{"group":"Reading data","icon":"database","pages":[{"title":"Reading pins","sidebarTitle":"Pins","href":"/pinto/pins"},{"title":"Reading users","sidebarTitle":"Users","href":"/pinto/users"},{"title":"Reading boards","sidebarTitle":"Boards","href":"/pinto/boards"},{"title":"Search","href":"/pinto/search"},{"title":"Downloading media","sidebarTitle":"Media","href":"/pinto/media"}]},{"group":"Sessions","icon":"key","pages":[{"title":"Authentication and sessions","sidebarTitle":"Authentication","description":"Use your own Pinterest cookies with Pinto, and save, restore, and isolate sessions.","href":"/pinto/authentication"},{"title":"Device fingerprinting","sidebarTitle":"Fingerprinting","href":"/pinto/fingerprinting"}]},{"group":"Production","icon":"server","pages":[{"title":"Scaling with the gateway","sidebarTitle":"Scaling","description":"Serve high traffic with Pinto's Gateway, SessionPool, CacheStore, and GlobalRateLimiter.","href":"/pinto/scaling"},{"title":"Proxies and custom fetch","sidebarTitle":"Proxies","href":"/pinto/proxies"},{"title":"Error handling","sidebarTitle":"Errors","href":"/pinto/errors"},{"title":"Configuration","href":"/pinto/configuration"}]}]}]},"basePath":"","title":"Traceryn Docs | Open-source developer tools and SDKs","buildId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","deploymentId":"dpl_DeHjVRGfFnhYQwHnfC2pjeXXv8h9","dynamics":[],"chunks":[]}