How sure we are, 0-100, that this profile is the requested person, when resolved from email or name. Below 50 the profile is our best guess and may well be someone else. Absent when linkedin_url was supplied.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"TAMTAM","colors":{"primary":"#0c31c1","light":"#3554d4","dark":"#081f7a"},"logo":{"light":"https://mintcdn.com/tamtam/1lHFBYsUpWvVAToh/assets/logo/light.svg?fit=max\u0026auto=format\u0026n=1lHFBYsUpWvVAToh\u0026q=85\u0026s=5291cd6148923d32a8552bdb99ef3669","dark":"https://mintcdn.com/tamtam/1lHFBYsUpWvVAToh/assets/logo/dark.svg?fit=max\u0026auto=format\u0026n=1lHFBYsUpWvVAToh\u0026q=85\u0026s=32b84eb16f13c1a361f8318778532924"},"favicon":"https://mintcdn.com/tamtam/1lHFBYsUpWvVAToh/assets/favicon.png?fit=max\u0026auto=format\u0026n=1lHFBYsUpWvVAToh\u0026q=85\u0026s=f532f912a05f0bdb216d0903aae60d4a","navbar":{"links":[],"primary":{"type":"button","label":"Visit tamtam.ai","href":"https://www.tamtam.ai"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/tamtam-ai"}},"contextual":{"options":["copy","view","chatgpt","claude","perplexity","mcp","cursor","vscode"],"display":"header"},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"tamtam","hasAudioNarration":false,"actualSubdomain":"tamtam","customDomains":["docs.api.tamtam.ai"],"gitSource":{"type":"gitlab","owner":"tamtamai","repo":"tamtam","projectId":76070796,"deployBranch":"production","contentDirectory":"backend/public-api/docs","isPrivate":true,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae36362864324a0b7688ac3","collectionId":"60ec3be8-4567-4986-a371-38355385382b","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae36362864324a0b7688ac3"},"entitlements":{},"buildId":"6ae498f016d886c98de48553","clientVersion":"0.0.4021","searchFilterCounts":[{"language":"default","tag":"API reference","count":88},{"language":"default","tag":"Signals","count":11},{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"Companies","count":7},{"language":"default","tag":"People Search","count":7},{"language":"default","tag":"LinkedIn Content Signals","count":6},{"language":"default","tag":"Smart Verticals","count":6},{"language":"default","tag":"Webhooks","count":6},{"language":"default","tag":"Concepts","count":5},{"language":"default","tag":"Contact Searches","count":5}]},"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":"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":"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":"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}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/people-extract/extract-a-persons-profile","slug":"/api-reference/people-extract/extract-a-persons-profile","pageMetadata":{"title":"Extract a person's profile","description":"Resolve a person from the best available input and return their full LinkedIn profile with experiences.\n\n**Resolution priority:** `linkedin_url` > `email` > `firstname`/`lastname`.\n\nAll fields are optional, but at least one resolution path must be provided. `company_name` improves accuracy for email and name-based resolution.\n\nCosts 1 credit.","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/extract","href":"/api-reference/people-extract/extract-a-persons-profile","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {Fragment: _Fragment, jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n strong: \"strong\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_Fragment, {\n children: [_jsx(_components.p, {\n children: \"Resolve a person from the best available input and return their full LinkedIn profile with experiences.\"\n }), \"\\n\", _jsxs(_components.p, {\n children: [_jsx(_components.strong, {\n children: \"Resolution priority:\"\n }), \" \", _jsx(_components.code, {\n children: \"linkedin_url\"\n }), \" > \", _jsx(_components.code, {\n children: \"email\"\n }), \" > \", _jsx(_components.code, {\n children: \"firstname\"\n }), \"/\", _jsx(_components.code, {\n children: \"lastname\"\n }), \".\"]\n }), \"\\n\", _jsxs(_components.p, {\n children: [\"All fields are optional, but at least one resolution path must be provided. \", _jsx(_components.code, {\n children: \"company_name\"\n }), \" improves accuracy for email and name-based resolution.\"]\n }), \"\\n\", _jsx(_components.p, {\n children: \"Costs 1 credit.\"\n })]\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":"Extract a person's profile","description":"Resolve a person from the best available input and return their full LinkedIn profile with experiences.\n\n**Resolution priority:** `linkedin_url` > `email` > `firstname`/`lastname`.\n\nAll fields are optional, but at least one resolution path must be provided. `company_name` improves accuracy for email and name-based resolution.\n\nCosts 1 credit.","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/extract","href":"/api-reference/people-extract/extract-a-persons-profile","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"description":"Resolve a person from the best available input and return their full LinkedIn profile with experiences.\n\n**Resolution priority:** `linkedin_url` > `email` > `firstname`/`lastname`.\n\nAll fields are optional, but at least one resolution path must be provided. `company_name` improves accuracy for email and name-based resolution.\n\nCosts 1 credit.","operationId":"extract-person","requestBody":"c86c7b25-e700-4375-8a05-6b4f2795edf4","responses":{"200":"14f2c0a8-405e-4afc-b525-fb7862faf1d4","default":"4824df22-65a8-412f-bcca-4152de28d7ef"},"security":["b446abc7-e3b7-4a3f-98b9-2a85578ed80c","c1789839-843c-4182-b84b-8a653e229aff"],"summary":"Extract a person's profile","tags":["People Extract"],"method":"post","type":"path","servers":["83ce9b4e-1db5-4c96-8b86-10e3c4245028"],"path":"/v2/people/extract","baseUrlOptions":["https://api.tamtam.ai/api"],"title":"Extract a person's profile","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"company_name":{"description":"Company name (improves matching accuracy for email and name-based resolution)","examples":["Acme Corp"],"type":"string","uniqueKey":"company_name","typeLabel":"string"},"email":{"description":"Email address to resolve to a LinkedIn profile","examples":["jean.dupont@acme.com"],"type":"string","uniqueKey":"email","typeLabel":"string"},"firstname":{"description":"Person first name","examples":["Jean"],"type":"string","uniqueKey":"firstname","typeLabel":"string"},"lastname":{"description":"Person last name","examples":["Dupont"],"type":"string","uniqueKey":"lastname","typeLabel":"string"},"linkedin_url":{"description":"LinkedIn profile URL. If provided, used directly to extract the profile.","examples":["https://www.linkedin.com/in/jean-dupont"],"type":"string","uniqueKey":"linkedin_url","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"company_name":"Acme Corp","email":"jean.dupont@acme.com","firstname":"Jean","lastname":"Dupont","linkedin_url":"https://www.linkedin.com/in/jean-dupont"}}},"exampleType":"generated"}},"required":true,"exampleType":"generated"},"responses":{"14f2c0a8-405e-4afc-b525-fb7862faf1d4":{"content":{"application/json":{"schema":{"additionalProperties":false,"properties":{"contact_id":{"description":"Tamtam contact ID","type":"string","isRequired":true,"uniqueKey":"contact_id","typeLabel":"string"},"experiences":{"oneOf":[{"description":"All experiences","items":{"additionalProperties":false,"properties":{"title":{"description":"Job title","type":"string","isRequired":true,"uniqueKey":"experiences.oneOf.0.items.[INDEX].title","typeLabel":"string"},"company_linkedin_id":{"description":"Company LinkedIn numeric ID","type":"string","uniqueKey":"experiences.oneOf.0.items.[INDEX].company_linkedin_id","typeLabel":"string"},"company_name":{"description":"Company name","type":"string","uniqueKey":"experiences.oneOf.0.items.[INDEX].company_name","typeLabel":"string"},"company_slug":{"description":"Company LinkedIn slug","type":"string","uniqueKey":"experiences.oneOf.0.items.[INDEX].company_slug","typeLabel":"string"},"country_code":{"description":"Country code (2-letter ISO)","type":"string","uniqueKey":"experiences.oneOf.0.items.[INDEX].country_code","typeLabel":"string"},"description":{"description":"Experience description","type":"string","uniqueKey":"experiences.oneOf.0.items.[INDEX].description","typeLabel":"string"},"end_date":{"description":"End date (YYYY-MM), null if current","examples":["2024-06"],"type":"string","uniqueKey":"experiences.oneOf.0.items.[INDEX].end_date","typeLabel":"string"},"location":{"description":"Location (free text)","type":"string","uniqueKey":"experiences.oneOf.0.items.[INDEX].location","typeLabel":"string"},"start_date":{"description":"Start date (YYYY-MM)","examples":["2022-01"],"type":"string","uniqueKey":"experiences.oneOf.0.items.[INDEX].start_date","typeLabel":"string"}},"required":["title"],"type":"object","uniqueKey":"experiences.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","isRequired":true,"uniqueKey":"experiences.oneOf.0","typeLabel":"object[]"},{"description":"All experiences","items":{"additionalProperties":false,"properties":{"company_linkedin_id":{"description":"Company LinkedIn numeric ID","type":"string"},"company_name":{"description":"Company name","type":"string"},"company_slug":{"description":"Company LinkedIn slug","type":"string"},"country_code":{"description":"Country code (2-letter ISO)","type":"string"},"description":{"description":"Experience description","type":"string"},"end_date":{"description":"End date (YYYY-MM), null if current","examples":["2024-06"],"type":"string"},"location":{"description":"Location (free text)","type":"string"},"start_date":{"description":"Start date (YYYY-MM)","examples":["2022-01"],"type":"string"},"title":{"description":"Job title","type":"string"}},"required":["title"],"type":"object"},"type":"null","isRequired":true,"uniqueKey":"experiences.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"experiences","typeLabel":"object[] | null"},"firstname":{"description":"First name","type":"string","isRequired":true,"uniqueKey":"firstname","typeLabel":"string"},"initials":{"description":"Up to two letters to show in place of the photo when there is none or it fails to load","examples":["EA"],"type":"string","isRequired":true,"uniqueKey":"initials","typeLabel":"string"},"lastname":{"description":"Last name","type":"string","isRequired":true,"uniqueKey":"lastname","typeLabel":"string"},"linkedin_profile_id":{"description":"Tamtam LinkedIn profile ID","type":"string","isRequired":true,"uniqueKey":"linkedin_profile_id","typeLabel":"string"},"linkedin_url":{"description":"LinkedIn profile URL","type":"string","isRequired":true,"uniqueKey":"linkedin_url","typeLabel":"string"},"city":{"description":"City","type":"string","uniqueKey":"city","typeLabel":"string"},"country_code":{"description":"Country code (2-letter ISO)","type":"string","uniqueKey":"country_code","typeLabel":"string"},"current_experience":{"additionalProperties":false,"properties":{"title":{"description":"Job title","type":"string","isRequired":true,"uniqueKey":"current_experience.title","typeLabel":"string"},"company_linkedin_id":{"description":"Company LinkedIn numeric ID","type":"string","uniqueKey":"current_experience.company_linkedin_id","typeLabel":"string"},"company_name":{"description":"Company name","type":"string","uniqueKey":"current_experience.company_name","typeLabel":"string"},"company_slug":{"description":"Company LinkedIn slug","type":"string","uniqueKey":"current_experience.company_slug","typeLabel":"string"},"country_code":{"description":"Country code (2-letter ISO)","type":"string","uniqueKey":"current_experience.country_code","typeLabel":"string"},"description":{"description":"Experience description","type":"string","uniqueKey":"current_experience.description","typeLabel":"string"},"end_date":{"description":"End date (YYYY-MM), null if current","examples":["2024-06"],"type":"string","uniqueKey":"current_experience.end_date","typeLabel":"string"},"location":{"description":"Location (free text)","type":"string","uniqueKey":"current_experience.location","typeLabel":"string"},"start_date":{"description":"Start date (YYYY-MM)","examples":["2022-01"],"type":"string","uniqueKey":"current_experience.start_date","typeLabel":"string"}},"required":["title"],"type":"object","description":"Current (most recent) experience with no end date","uniqueKey":"current_experience","typeLabel":"object"},"headline":{"description":"LinkedIn headline","type":"string","uniqueKey":"headline","typeLabel":"string"},"match_reason":{"description":"What the score rests on: which strategy found the profile, and whether and how it was verified.","examples":["AI-scored against a web-search result for this person"],"type":"string","uniqueKey":"match_reason","typeLabel":"string"},"match_score":{"description":"How sure we are, 0-100, that this profile is the requested person, when resolved from email or name. Below 50 the profile is our best guess and may well be someone else. Absent when linkedin_url was supplied.","examples":[100],"format":"int64","maximum":100,"minimum":0,"type":"integer","uniqueKey":"match_score","typeLabel":"integer\u003cint64>"},"photo_url":{"description":"Profile photo URL","type":"string","uniqueKey":"photo_url","typeLabel":"string"},"state":{"description":"State or region","type":"string","uniqueKey":"state","typeLabel":"string"},"summary":{"description":"LinkedIn About section","type":"string","uniqueKey":"summary","typeLabel":"string"}},"required":["contact_id","linkedin_profile_id","linkedin_url","firstname","lastname","initials","experiences"],"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"contact_id":"\u003cstring>","experiences":[{"title":"\u003cstring>","company_linkedin_id":"\u003cstring>","company_name":"\u003cstring>","company_slug":"\u003cstring>","country_code":"\u003cstring>","description":"\u003cstring>","end_date":"2024-06","location":"\u003cstring>","start_date":"2022-01"}],"firstname":"\u003cstring>","initials":"EA","lastname":"\u003cstring>","linkedin_profile_id":"\u003cstring>","linkedin_url":"\u003cstring>","city":"\u003cstring>","country_code":"\u003cstring>","current_experience":{"title":"\u003cstring>","company_linkedin_id":"\u003cstring>","company_name":"\u003cstring>","company_slug":"\u003cstring>","country_code":"\u003cstring>","description":"\u003cstring>","end_date":"2024-06","location":"\u003cstring>","start_date":"2022-01"},"headline":"\u003cstring>","match_reason":"AI-scored against a web-search result for this person","match_score":100,"photo_url":"\u003cstring>","state":"\u003cstring>","summary":"\u003cstring>"}}},"exampleType":"generated"}},"description":"OK","exampleType":"generated"},"4824df22-65a8-412f-bcca-4152de28d7ef":{"content":{"application/problem+json":{"schema":{"additionalProperties":false,"properties":{"detail":{"description":"A human-readable explanation specific to this occurrence of the problem.","examples":["Property foo is required but is missing."],"type":"string","uniqueKey":"detail","typeLabel":"string"},"errors":{"oneOf":[{"description":"Optional list of individual error details","items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].location","typeLabel":"string"},"message":{"description":"Error message text","type":"string","uniqueKey":"errors.oneOf.0.items.[INDEX].message","typeLabel":"string"},"value":{"description":"The value at the given location","uniqueKey":"errors.oneOf.0.items.[INDEX].value","typeLabel":"any"}},"type":"object","uniqueKey":"errors.oneOf.0.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"errors.oneOf.0","typeLabel":"object[]"},{"description":"Optional list of individual error details","items":{"additionalProperties":false,"properties":{"location":{"description":"Where the error occurred, e.g. 'body.items[3].tags' or 'path.thing-id'","type":"string"},"message":{"description":"Error message text","type":"string"},"value":{"description":"The value at the given location"}},"type":"object"},"type":"null","uniqueKey":"errors.oneOf.1","typeLabel":"null"}],"uniqueKey":"errors","typeLabel":"object[] | null"},"instance":{"description":"A URI reference that identifies the specific occurrence of the problem.","examples":["https://example.com/error-log/abc123"],"format":"uri","type":"string","uniqueKey":"instance","typeLabel":"string\u003curi>"},"status":{"description":"HTTP status code","examples":[400],"format":"int64","type":"integer","uniqueKey":"status","typeLabel":"integer\u003cint64>"},"title":{"description":"A short, human-readable summary of the problem type. This value should not change between occurrences of the error.","examples":["Bad Request"],"type":"string","uniqueKey":"title","typeLabel":"string"},"type":{"default":"about:blank","description":"A URI reference to human-readable documentation for the error.","examples":["https://example.com/errors/example"],"format":"uri","type":"string","uniqueKey":"type","typeLabel":"string\u003curi>"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"detail":"Property foo is required but is missing.","errors":[{"location":"\u003cstring>","message":"\u003cstring>","value":"\u003cunknown>"}],"instance":"https://example.com/error-log/abc123","status":400,"title":"Bad Request","type":"https://example.com/errors/example"}}},"exampleType":"generated"}},"description":"Error","exampleType":"generated"}},"security":{"b446abc7-e3b7-4a3f-98b9-2a85578ed80c":{"apikeyAuth":{"description":"Account API key passed in the Authorization header","in":"header","name":"Authorization","type":"apiKey","scopes":[],"schemeName":"apikeyAuth"}},"c1789839-843c-4182-b84b-8a653e229aff":{"bearerAuth":{"description":"Bearer JWT obtained via the OAuth 2.1 authorization flow","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"83ce9b4e-1db5-4c96-8b86-10e3c4245028":{"url":"https://api.tamtam.ai/api"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"description":"Account API key passed in the Authorization header","in":"header","name":"Authorization","type":"apiKey","scopes":[],"schemeName":"apikeyAuth"},"schema":{"title":"Authorization","type":"string","description":"Account API key passed in the Authorization header","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"apikeyAuth","name":"Authorization"}],"title":"apikeyAuth"},{"schemes":[{"scheme":{"description":"Bearer JWT obtained via the OAuth 2.1 authorization flow","scheme":"bearer","type":"http","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Bearer JWT obtained via the OAuth 2.1 authorization flow","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"reference/openapi.yaml"},"subdomain":"tamtam","siteName":"TAMTAM","title":"Extract a person's profile - TAMTAM","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-29T15:16:59.860Z","originalFileLocation":"api-reference/people-extract/extract-a-persons-profile.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=\"Resolve a person from the best available input and return their full LinkedIn profile with experiences. Resolution priority: linkedin_url \u0026gt; email \u0026gt; firstname/lastname. All fields are optional, but at least one resolution path must be provided. company_name improves accuracy for email and name-based resolution. Costs 1 credit.\">\u003cmeta data-mint-head name=\"application-name\" content=\"TAMTAM\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/tamtam/dfUdFRrL5AuvFkxq/_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/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/tamtam/dfUdFRrL5AuvFkxq/_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/tamtam/dfUdFRrL5AuvFkxq/_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/tamtam/dfUdFRrL5AuvFkxq/_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/tamtam/dfUdFRrL5AuvFkxq/_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/tamtam/dfUdFRrL5AuvFkxq/_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/tamtam/dfUdFRrL5AuvFkxq/_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/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Extract a person\u0026#x27;s profile - TAMTAM\">\u003cmeta data-mint-head property=\"og:description\" content=\"Resolve a person from the best available input and return their full LinkedIn profile with experiences. Resolution priority: linkedin_url \u0026gt; email \u0026gt; firstname/lastname. All fields are optional, but at least one resolution path must be provided. company_name improves accuracy for email and name-based resolution. Costs 1 credit.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"TAMTAM\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.api.tamtam.ai/api-reference/people-extract/extract-a-persons-profile\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://tamtam.mintlify.app/_mintlify/api/og/v2?division=People+Extract\u0026amp;title=Extract+a+person%27s+profile\u0026amp;description=Resolve+a+person+from+the+best+available+input+and+return+their+full+LinkedIn+profile+with+experiences.%0A%0A**Resolution+priority%3A**+%60linkedin_url%60+%3E+%60email%60+%3E+%60fi\u0026amp;theme=0a3840a452825963dbf5c1f1\u0026amp;signature=bbe9a39c766c23b371895c47e41814b549a364debeb867716a86f9f6e63dedf2\">\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=\"Extract a person\u0026#x27;s profile - TAMTAM\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Resolve a person from the best available input and return their full LinkedIn profile with experiences. Resolution priority: linkedin_url \u0026gt; email \u0026gt; firstname/lastname. All fields are optional, but at least one resolution path must be provided. company_name improves accuracy for email and name-based resolution. Costs 1 credit.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://tamtam.mintlify.app/_mintlify/api/og/v2?division=People+Extract\u0026amp;title=Extract+a+person%27s+profile\u0026amp;description=Resolve+a+person+from+the+best+available+input+and+return+their+full+LinkedIn+profile+with+experiences.%0A%0A**Resolution+priority%3A**+%60linkedin_url%60+%3E+%60email%60+%3E+%60fi\u0026amp;theme=0a3840a452825963dbf5c1f1\u0026amp;signature=bbe9a39c766c23b371895c47e41814b549a364debeb867716a86f9f6e63dedf2\">\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/tamtam/dfUdFRrL5AuvFkxq/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"TAMTAM\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0c31c1\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.api.tamtam.ai/api-reference/people-extract/extract-a-persons-profile\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/people-extract/extract-a-persons-profile.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.api.tamtam.ai/#organization\",\"name\":\"TAMTAM\",\"url\":\"https://docs.api.tamtam.ai\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/tamtam/1lHFBYsUpWvVAToh/assets/logo/light.svg?fit=max\u0026auto=format\u0026n=1lHFBYsUpWvVAToh\u0026q=85\u0026s=5291cd6148923d32a8552bdb99ef3669\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.api.tamtam.ai#website\",\"name\":\"TAMTAM\",\"url\":\"https://docs.api.tamtam.ai\",\"publisher\":{\"@id\":\"https://docs.api.tamtam.ai/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.api.tamtam.ai/api-reference/people-extract/extract-a-persons-profile#webpage\",\"url\":\"https://docs.api.tamtam.ai/api-reference/people-extract/extract-a-persons-profile\",\"name\":\"Extract a person's profile\",\"description\":\"Resolve a person from the best available input and return their full LinkedIn profile with experiences. Resolution priority: linkedin_url > email > firstname/lastname. All fields are optional, but at least one resolution path must be provided. company_name improves accuracy for email and name-based resolution. Costs 1 credit.\",\"dateModified\":\"2026-10-29T15:16:59.860Z\",\"isPartOf\":{\"@id\":\"https://docs.api.tamtam.ai#website\"},\"breadcrumb\":{\"@id\":\"https://docs.api.tamtam.ai/api-reference/people-extract/extract-a-persons-profile#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.api.tamtam.ai/api-reference/people-extract/extract-a-persons-profile#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"People Extract\",\"item\":\"https://docs.api.tamtam.ai/api-reference/people-extract/read-peoples-experiences\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Extract a person's profile\",\"item\":\"https://docs.api.tamtam.ai/api-reference/people-extract/extract-a-persons-profile\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.api.tamtam.ai/api-reference/people-extract/extract-a-persons-profile#apireference\",\"headline\":\"Extract a person's profile\",\"name\":\"Extract a person's profile\",\"description\":\"Resolve a person from the best available input and return their full LinkedIn profile with experiences. Resolution priority: linkedin_url > email > firstname/lastname. All fields are optional, but at least one resolution path must be provided. company_name improves accuracy for email and name-based resolution. Costs 1 credit.\",\"url\":\"https://docs.api.tamtam.ai/api-reference/people-extract/extract-a-persons-profile\",\"mainEntityOfPage\":{\"@id\":\"https://docs.api.tamtam.ai/api-reference/people-extract/extract-a-persons-profile#webpage\"},\"dateModified\":\"2026-10-29T15:16:59.860Z\",\"publisher\":{\"@id\":\"https://docs.api.tamtam.ai/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.api.tamtam.ai#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"TAMTAM\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"TAMTAM","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API reference","groups":[{"group":"Contacts","pages":[{"title":"Get contacts by IDs (deprecated)","deprecated":true,"version":null,"openapi":"/reference/openapi.yaml post /v1/contacts","href":"/api-reference/contacts/get-contacts-by-ids-deprecated"},{"title":"Get contacts","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts","href":"/api-reference/contacts/get-contacts"},{"title":"Get research answers for a contact","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts/{contactID}/research-questions","href":"/api-reference/contacts/get-research-answers-for-a-contact"},{"title":"Ask a research question about a contact","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/contacts/{contactID}/research-questions","href":"/api-reference/contacts/ask-a-research-question-about-a-contact"}]},{"group":"Companies Lists","pages":[{"title":"List companies lists","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies-lists","href":"/api-reference/companies-lists/list-companies-lists"},{"title":"Get a companies list","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies-lists/{listID}","href":"/api-reference/companies-lists/get-a-companies-list"},{"title":"Add companies to a list","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/companies-lists/{listID}","href":"/api-reference/companies-lists/add-companies-to-a-list"}]},{"group":"Companies","pages":[{"title":"List job changes for companies","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/companies/job-changes","href":"/api-reference/companies/list-job-changes-for-companies"},{"title":"Search for a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/companies/search","href":"/api-reference/companies/search-for-a-company"},{"title":"Get job postings for a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies/{linkedin_id}/job-postings","href":"/api-reference/companies/get-job-postings-for-a-company"},{"title":"Get news for a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies/{linkedin_id}/news","href":"/api-reference/companies/get-news-for-a-company"},{"title":"Get research answers for a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies/{linkedin_id}/research-questions","href":"/api-reference/companies/get-research-answers-for-a-company"},{"title":"Ask a research question about a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/companies/{linkedin_id}/research-questions","href":"/api-reference/companies/ask-a-research-question-about-a-company"},{"title":"Get an asked research question","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/companies/{linkedin_id}/research-questions/{questionID}","href":"/api-reference/companies/get-an-asked-research-question"}]},{"group":"Contact Searches","pages":[{"title":"List contact searches","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contact-searches","href":"/api-reference/contact-searches/list-contact-searches"},{"title":"Start a contact search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/contact-searches","href":"/api-reference/contact-searches/start-a-contact-search"},{"title":"Preview a contact search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/contact-searches/preview-count","href":"/api-reference/contact-searches/preview-a-contact-search"},{"title":"Get a contact search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contact-searches/{searchID}","href":"/api-reference/contact-searches/get-a-contact-search"},{"title":"Stop a contact search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/contact-searches/{searchID}/stop","href":"/api-reference/contact-searches/stop-a-contact-search"}]},{"group":"Contacts Lists","pages":[{"title":"List contacts lists","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts-lists","href":"/api-reference/contacts-lists/list-contacts-lists"},{"title":"Get a contacts list","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts-lists/{contactsListID}","href":"/api-reference/contacts-lists/get-a-contacts-list"},{"title":"List the contacts in a contacts list or contact search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts-lists/{contactsListID}/contacts","href":"/api-reference/contacts-lists/list-the-contacts-in-a-contacts-list-or-contact-search"}]},{"group":"Signals","pages":[{"title":"List signals on a contacts list","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/contacts-lists/{listID}/signals","href":"/api-reference/signals/list-signals-on-a-contacts-list"},{"title":"List CRM deal stages","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/crm-deal-stages","href":"/api-reference/signals/list-crm-deal-stages"},{"title":"Create a deal stage lookalike signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/deal-stage-lookalike-signals","href":"/api-reference/signals/create-a-deal-stage-lookalike-signal"},{"title":"Create a job posting signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/job-posting-signals","href":"/api-reference/signals/create-a-job-posting-signal"},{"title":"Start a lead generation run","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/lead-generation-runs","href":"/api-reference/signals/start-a-lead-generation-run"},{"title":"Create a new hire signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/new-hire-signals","href":"/api-reference/signals/create-a-new-hire-signal"},{"title":"Create a news signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/news-content-signals","href":"/api-reference/signals/create-a-news-signal"},{"title":"Create a page follower signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/page-follower-signals","href":"/api-reference/signals/create-a-page-follower-signal"},{"title":"List page follower filter values","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/page-follower-signals/filter-values","href":"/api-reference/signals/list-page-follower-filter-values"},{"title":"Create an ex-customer move signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/past-company-move-signals","href":"/api-reference/signals/create-an-ex-customer-move-signal"},{"title":"List signals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/signals","href":"/api-reference/signals/list-signals"}]},{"group":"Credits","pages":[{"title":"Get remaining credits","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/credits","href":"/api-reference/credits/get-remaining-credits"}]},{"group":"Engagement Watches","pages":[{"title":"List engagement signals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/engagement-signals","href":"/api-reference/engagement-watches/list-engagement-signals"},{"title":"List engagement watches","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/engagement-watches","href":"/api-reference/engagement-watches/list-engagement-watches"},{"title":"Create an engagement watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/engagement-watches","href":"/api-reference/engagement-watches/create-an-engagement-watch"},{"title":"Delete an engagement watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/engagement-watches/{id}","href":"/api-reference/engagement-watches/delete-an-engagement-watch"},{"title":"Update an engagement watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml patch /v2/engagement-watches/{id}","href":"/api-reference/engagement-watches/update-an-engagement-watch"}]},{"group":"ICP Criteria","pages":[{"title":"List ICP criteria","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/icp-criteria","href":"/api-reference/icp-criteria/list-icp-criteria"},{"title":"Create an ICP criteria","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/icp-criteria","href":"/api-reference/icp-criteria/create-an-icp-criteria"},{"title":"Get an ICP criteria","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/icp-criteria/{icpCriteriaID}","href":"/api-reference/icp-criteria/get-an-icp-criteria"},{"title":"Update an ICP criteria","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml put /v2/icp-criteria/{icpCriteriaID}","href":"/api-reference/icp-criteria/update-an-icp-criteria"},{"title":"Delete an ICP criteria","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/icp-criteria/{icpCriteriaID}","href":"/api-reference/icp-criteria/delete-an-icp-criteria"}]},{"group":"ICP Signal Watches","pages":[{"title":"List ICP signal watches","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/icp-signal-watches","href":"/api-reference/icp-signal-watches/list-icp-signal-watches"},{"title":"Get an ICP signal watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/icp-signal-watches/{icpCriteriaID}","href":"/api-reference/icp-signal-watches/get-an-icp-signal-watch"},{"title":"Create or update an ICP signal watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml put /v2/icp-signal-watches/{icpCriteriaID}","href":"/api-reference/icp-signal-watches/create-or-update-an-icp-signal-watch"},{"title":"Delete an ICP signal watch","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/icp-signal-watches/{icpCriteriaID}","href":"/api-reference/icp-signal-watches/delete-an-icp-signal-watch"},{"title":"List ICP signals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/icp-signals","href":"/api-reference/icp-signal-watches/list-icp-signals"}]},{"group":"Industries","pages":[{"title":"Search industries","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/industries/search","href":"/api-reference/industries/search-industries"}]},{"group":"Key Accounts","pages":[{"title":"List Key Accounts","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/key-accounts","href":"/api-reference/key-accounts/list-key-accounts"},{"title":"Add companies to Key Accounts","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/key-accounts","href":"/api-reference/key-accounts/add-companies-to-key-accounts"}]},{"group":"Lead Score","pages":[{"title":"Score job titles at a company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/lead-scores/at-company","href":"/api-reference/lead-score/score-job-titles-at-a-company"},{"title":"Score job titles with no company","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/lead-scores/title-only","href":"/api-reference/lead-score/score-job-titles-with-no-company"}]},{"group":"LinkedIn Content Signals","pages":[{"title":"List content signal events","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/linkedin-content-signal-events","href":"/api-reference/linkedin-content-signals/list-content-signal-events"},{"title":"List LinkedIn content signals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/linkedin-content-signals","href":"/api-reference/linkedin-content-signals/list-linkedin-content-signals"},{"title":"Create a LinkedIn content signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/linkedin-content-signals","href":"/api-reference/linkedin-content-signals/create-a-linkedin-content-signal"},{"title":"Delete a LinkedIn content signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/linkedin-content-signals/{id}","href":"/api-reference/linkedin-content-signals/delete-a-linkedin-content-signal"},{"title":"Update a LinkedIn content signal","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml patch /v2/linkedin-content-signals/{id}","href":"/api-reference/linkedin-content-signals/update-a-linkedin-content-signal"},{"title":"List judged posts","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/linkedin-content-signals/{id}/posts","href":"/api-reference/linkedin-content-signals/list-judged-posts"}]},{"group":"Lookalikes","pages":[{"title":"Search for lookalike companies","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/multi-search-lookalikes","href":"/api-reference/lookalikes/search-for-lookalike-companies"}]},{"group":"People Enrichment","pages":[{"title":"Enrich people with email and phone data","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/enrich","href":"/api-reference/people-enrichment/enrich-people-with-email-and-phone-data"},{"title":"Get enrichment request status and results","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/people/enrich/{RequestID}","href":"/api-reference/people-enrichment/get-enrichment-request-status-and-results"}]},{"group":"People Extract","pages":[{"title":"Read people's experiences","description":"Return the LinkedIn experiences of up to 20 profiles, current position first, at the refresh price rather than the discovery price.\n\nFor a profile Tamtam already holds this is free: experiences refreshed within the last 30 days are answered from what Tamtam holds with no provider call (`source: cached`), older ones are re-read from LinkedIn (`source: refreshed`). Pass `force: true` to re-read regardless.\n\nFor a profile Tamtam does not hold, the row falls back to a full extract, which creates a contact and costs 1 credit exactly as `POST /v2/people/extract` (`source: extracted`). Pass `refresh_only: true` to refuse that fallback; the row then carries `error: profile_unknown` and nothing is spent.\n\nEach row answers on its own: one profile gone from LinkedIn or one failed provider call is an `error` on that row while the rest are answered. The one whole-batch refusal is **402**, checked before anything runs, when the fallback extracts the batch would need cannot be paid for.\n\nFree for a profile Tamtam holds; 1 credit per profile it extracts.","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/experiences","href":"/api-reference/people-extract/read-peoples-experiences"},{"title":"Extract a person's profile","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/extract","href":"/api-reference/people-extract/extract-a-persons-profile"},{"title":"Resolve people to LinkedIn profiles","description":"Turn what a row of your file says about a person — a name, an email, a company — into the LinkedIn profile it most likely is, with a confidence you can threshold, without extracting the profile. Up to 10 people per call, answered in order with your `custom` map echoed.\n\nEach row runs the same waterfall as `POST /v2/people/extract`: Tamtam's own email caches and the account's CRM first, then Sales Navigator, Linkup, and web search with AI verification. The answer says which step found the profile (`source`) and what that step reported about the person — name, headline, company — so a job change can usually be read off the row without an extract.\n\n**Pricing follows the source.** A `cache` or `crm` hit is free. A profile found by `sales_navigator`, `linkup` or `web_search` costs 1 credit, and the row says so with `charged: true`. Nobody found costs nothing. The one whole-batch refusal is **402**, checked before anything runs, when the account could not pay for every row in the batch resolving by search.\n\nA row with nothing to search on (no name, email or company) is answered with `error: insufficient_hint`; a strategy failure with `error: resolution_failed`. Neither stops the other rows.","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/resolve","href":"/api-reference/people-extract/resolve-people-to-linkedin-profiles"}]},{"group":"People Search","pages":[{"title":"Search for people","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/search","href":"/api-reference/people-search/search-for-people"},{"title":"Run a people search to the end in the background","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/search-jobs","href":"/api-reference/people-search/run-a-people-search-to-the-end-in-the-background"},{"title":"Plan a large people search before running it","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/search-jobs/plan","href":"/api-reference/people-search/plan-a-large-people-search-before-running-it"},{"title":"Get a people search job","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/people/search-jobs/{JobID}","href":"/api-reference/people-search/get-a-people-search-job"},{"title":"Read a people search job's results","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/people/search-jobs/{JobID}/results","href":"/api-reference/people-search/read-a-people-search-jobs-results"},{"title":"Run a planned people search","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/search-jobs/{JobID}/run","href":"/api-reference/people-search/run-a-planned-people-search"},{"title":"Stop a people search job","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/people/search-jobs/{JobID}/stop","href":"/api-reference/people-search/stop-a-people-search-job"}]},{"group":"Personas","pages":[{"title":"List personas","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/personas","href":"/api-reference/personas/list-personas"},{"title":"Create a persona","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/personas","href":"/api-reference/personas/create-a-persona"},{"title":"Update a persona","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml patch /v2/personas/{id}","href":"/api-reference/personas/update-a-persona"}]},{"group":"Smart Verticals","pages":[{"title":"List smart verticals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/smart-verticals","href":"/api-reference/smart-verticals/list-smart-verticals"},{"title":"Create a smart vertical","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/smart-verticals","href":"/api-reference/smart-verticals/create-a-smart-vertical"},{"title":"Classify companies into smart verticals","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/smart-verticals/classify","href":"/api-reference/smart-verticals/classify-companies-into-smart-verticals"},{"title":"Reclassify all classified companies","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/smart-verticals/reclassify","href":"/api-reference/smart-verticals/reclassify-all-classified-companies"},{"title":"Update a smart vertical","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml put /v2/smart-verticals/{smartVerticalID}","href":"/api-reference/smart-verticals/update-a-smart-vertical"},{"title":"Delete a smart vertical","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/smart-verticals/{smartVerticalID}","href":"/api-reference/smart-verticals/delete-a-smart-vertical"}]},{"group":"Webhooks","pages":[{"title":"List webhook deliveries","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/webhook-deliveries","href":"/api-reference/webhooks/list-webhook-deliveries"},{"title":"Replay a webhook delivery","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/webhook-deliveries/{deliveryID}/replay","href":"/api-reference/webhooks/replay-a-webhook-delivery"},{"title":"List webhook endpoints","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml get /v2/webhook-endpoints","href":"/api-reference/webhooks/list-webhook-endpoints"},{"title":"Create a webhook endpoint","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml post /v2/webhook-endpoints","href":"/api-reference/webhooks/create-a-webhook-endpoint"},{"title":"Delete a webhook endpoint","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml delete /v2/webhook-endpoints/{endpointID}","href":"/api-reference/webhooks/delete-a-webhook-endpoint"},{"title":"Update a webhook endpoint","deprecated":null,"version":null,"openapi":"/reference/openapi.yaml patch /v2/webhook-endpoints/{endpointID}","href":"/api-reference/webhooks/update-a-webhook-endpoint"}]}]}]},"title":"Extract a person's profile - TAMTAM","buildId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","deploymentId":"dpl_EnxDqhjaNc9a8MVa833TGULPd9uJ","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-26-lDe7V.js","utils-CWQmgYtH.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-4-Aw3rSD.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-C2zjXYA5.js","snippetPresets-DFmpFA7C.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-FJpQavWq.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-D_GvPF7k.js","shallow-Bs2ZB0NO.js","getApiPlaygroundDisplay-DCcqJJk-.js","CodeSnippet-DzDxawVe.js","CodeSnippets-aUr7fU-7.js","Page-CT9uE8Ip.js","getPastedJson-Y1fKsj_I.js","icon-DI4zTsDr.js","MethodPill-C0nDlmSQ.js","DuplicateIcon-NUXbx2nQ.js","createIcon-BdTHrPAi.js","DynamicMarkdown-CtpgKJwj.js","SectionHeading-B3x35tOt.js","axios-vUo_bRtp.js","Markdown-3OmurJMP.js","clsx-DMKzROTp.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-1ms6tsT-.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-Ke9xIMFx.js"]}