Skip to main content
POST
Extract a person's profile

Authorizations

Authorization
string
header
required

Account API key passed in the Authorization header

Body

application/json
company_name
string

Company name (improves matching accuracy for email and name-based resolution)

Example:

"Acme Corp"

email
string

Email address to resolve to a LinkedIn profile

Example:

"jean.dupont@acme.com"

firstname
string

Person first name

Example:

"Jean"

lastname
string

Person last name

Example:

"Dupont"

linkedin_url
string

LinkedIn profile URL. If provided, used directly to extract the profile.

Example:

"https://www.linkedin.com/in/jean-dupont"

Response

OK

contact_id
string
required

Tamtam contact ID

experiences
object[] | null
required

All experiences

firstname
string
required

First name

initials
string
required

Up to two letters to show in place of the photo when there is none or it fails to load

Example:

"EA"

lastname
string
required

Last name

linkedin_profile_id
string
required

Tamtam LinkedIn profile ID

linkedin_url
string
required

LinkedIn profile URL

city
string

City

country_code
string

Country code (2-letter ISO)

current_experience
object

Current (most recent) experience with no end date

headline
string

LinkedIn headline

match_reason
string

What the score rests on: which strategy found the profile, and whether and how it was verified.

Example:

"AI-scored against a web-search result for this person"

match_score
integer<int64>

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.

Required range: 0 <= x <= 100
Example:

100

photo_url
string

Profile photo URL

state
string

State or region

summary
string

LinkedIn About section