Skip to main content
GET
List personas

Authorizations

Authorization
string
header
required

Account API key passed in the Authorization header

Response

object[] | null

OK

canonical_job_titles_excludes
object[] | null
required

Canonical job titles the persona rejects, resolved to their labels

canonical_job_titles_includes
object[] | null
required

Canonical job titles the persona matches, resolved to their labels

countries
string[] | null
required

Country codes the persona is scoped to

Example:
country_excludes
string[] | null
required

Country codes the persona excludes

Example:
criteria_only
boolean
required

True when the persona exists only to drive scoring criteria. Such a persona defines no people search and is rejected by People search's persona_id.

Example:

false

id
string
required

Persona UUID

Example:

"b3c6f5e2-1234-4abc-9def-0123456789ab"

job_titles_excludes
string[] | null
required

Free-text job titles the persona rejects

Example:
job_titles_includes
string[] | null
required

Free-text job titles the persona matches

Example:
name
string
required

Persona name

Example:

"Head of Sales — France"

seniority_excludes
string[] | null
required

Seniority bands the persona rejects, judged the same way. A person whose title falls into one of these is dropped even when it also matches seniority_includes. A title carrying no seniority signal is kept, so this never removes the unclassified.

Example:
seniority_includes
string[] | null
required

Seniority bands the persona keeps, judged by Tamtam from the job title. Applied to fetched results, never sent to a search provider.

Example:
tier_level
integer<int64>
required

Priority tier the account assigned to this persona. Lower is more important.

Example:

1

usages
string[] | null
required

What the account uses this persona for. Effective values: 'prospecting', 'closing_deals'.

Example:
profile_keywords
string

Keyword expression the persona narrows its searches by, matched against the whole LinkedIn profile (headline, About, every role and its description, skills). Null when the persona has none. Applied by People search whenever this persona is used, so a search scoped to this persona returns only people whose profile text matches.

Example:

"\"supply chain\" AND SAP"

profile_languages
string[] | null

Languages the person's LinkedIn profile is written in (ISO 639-1: en, fr, de, es, it, nl, pt), ORed. Empty when the persona has no language filter. Applied by People search whenever this persona is used.

Example: