Skip to main content
POST
/
v2
/
people
/
extract
Extract a person's profile
curl --request POST \
  --url https://api.tamtam.ai/api/v2/people/extract \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "company_name": "<string>",
  "email": "<string>",
  "firstname": "<string>",
  "lastname": "<string>",
  "linkedin_url": "<string>"
}
'
{
  "contact_id": "<string>",
  "experiences": [
    {
      "title": "<string>",
      "company_linkedin_id": "<string>",
      "company_name": "<string>",
      "company_slug": "<string>",
      "country_code": "<string>",
      "description": "<string>",
      "end_date": "<string>",
      "location": "<string>",
      "start_date": "<string>"
    }
  ],
  "firstname": "<string>",
  "lastname": "<string>",
  "linkedin_profile_id": "<string>",
  "linkedin_url": "<string>",
  "city": "<string>",
  "country_code": "<string>",
  "current_experience": {
    "title": "<string>",
    "company_linkedin_id": "<string>",
    "company_name": "<string>",
    "company_slug": "<string>",
    "country_code": "<string>",
    "description": "<string>",
    "end_date": "<string>",
    "location": "<string>",
    "start_date": "<string>"
  },
  "headline": "<string>",
  "photo_url": "<string>",
  "state": "<string>",
  "summary": "<string>"
}

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

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

photo_url
string

Profile photo URL

state
string

State or region

summary
string

LinkedIn About section