TOtopo
contacts

Lookup Contact

Changed on

Look a person up in Topo's lead database.

The LinkedIn URL is the surest match, then the email, then the first and last name with the current employer's name or domain. The profile and current employer are returned without any email or phone number. Nothing is written to the workspace and no credit is spent — use POST /v1/contacts/enrich to find an email and save the contact.

Requires the contacts:read scope on the API key.

post/v1/contacts/lookup

Request

Request body

linkedin_urlstring nullable

LinkedIn profile URL, the surest match.

emailstring nullable

Email.

first_namestring nullable

First name, matched with last_name and the employer.

last_namestring nullable

Last name.

company_namestring nullable

Current employer name.

company_domainstring nullable

Current employer's primary domain.

Response

Successful Response

foundboolean required

Whether Topo's lead database holds a matching profile.

first_namestring nullable

First name.

last_namestring nullable

Last name.

job_titlestring nullable

Job title.

headlinestring nullable

Profile headline.

locationstring nullable

Location.

senioritystring nullable

Seniority.

departmentstring nullable

Department.

years_of_experienceinteger nullable

Years of professional experience.

linkedin_urlstring nullable

LinkedIn profile URL.

profile_picture_urlstring nullable

Profile picture URL.

company_namestring nullable

Current employer name.

company_domainstring nullable

Current employer's primary domain.

company_linkedin_urlstring nullable

Current employer's LinkedIn page URL.

company_industrystring nullable

Current employer's industry.

company_employee_countinteger nullable

Current employer's headcount.

company_countrystring nullable

Current employer's headquarters country.

Changes