Data dictionary

These are the attributes returned by the Contact Research, Company Research, My Contact Data, and My Company Data APIs. Any field can be null when Seamless has no value for it. Search results return a lighter subset, listed on each search product page.

Deprecated aliases such as title, company, and companyStaffCountRange are still returned for backward compatibility but are not listed here. Use the names below.

Contact attributes

Person

Field	Type	Description
`firstName`	string	Contact’s first name.
`middleName`	string	Contact’s middle name, if available.
`lastName`	string	Contact’s last name.
`fullName`	string	Contact’s full display name (first + middle + last).
`nameOriginal`	string	Contact’s name as originally sourced, before any normalization.
`jobTitle`	string	Contact’s current job title.
`department`	string	Department the contact works in.
`seniority`	string	Seniority level: C-Level, VP, Director, Manager, Senior, Mid-Level, Entry Level, or Other.
`image`	string	URL to the contact’s profile photo, if available.

Email

Field	Type	Description
`email`	string	Primary email address selected for this contact.
`personalEmail`	string	Personal (non-work) email address, if available.
`emailDomain`	string	Domain portion of the contact’s email address.
`email1` - `email3`	string	Up to three email addresses found for the contact.
`email1Selected`	boolean	Whether `email1` was selected as the primary email.
`email1TotalAI` - `email3TotalAI`	string	Confidence score (percentage) for each email.
`email1EmailAI` - `email3EmailAI`	string	Validation status for each email: valid, invalid, or risky.

Phone

Field	Type	Description
`contactPhone1`, `contactPhone2`	string	Direct phone numbers for the contact.
`contactPhone1TotalAI`	string	Confidence score (percentage) for the primary contact phone.
`contactPhone1DataType`, `contactPhone2DataType`	string	Phone type, such as mobile or main.
`companyPhone1` - `companyPhone3`	string	Phone numbers for the contact’s company.
`companyPhone1TotalAI` - `companyPhone3TotalAI`	string	Confidence score (percentage) for each company phone.
`companyPhone1DataType` - `companyPhone3DataType`	string	Phone type for each company phone.

Field	Type	Description
`lIProfileUrl`	string	Contact’s LinkedIn public profile URL.
`lISalesNavUrl`	string	Contact’s LinkedIn Sales Navigator profile URL.
`lIRecruiterUrl`	string	Contact’s LinkedIn Recruiter profile URL.

Location

Field	Type	Description
`contactLocation`	object	Contact location: `city`, `state`, `stateAbbr`, `postCode`, `county`, `country`, `countryAlpha2`, `countryAlpha3`, `countryNumeric`, `fullString`, `timezone`, `timezoneAbbr`, `timezoneRawOffset`.
`companyLocation`	object	Company headquarters address: `street1`-`street3`, `city`, `state`, `stateAbbr`, `postCode`, `county`, `country`, ISO country codes, `fullString`.
`city`, `state`, `country`	string	Flat copies of the contact’s location.
`companyCity`, `companyState`, `companyCountry`	string	Flat copies of the company headquarters location.
`timezone`, `timezoneAbbr`	string	The contact’s local timezone.
`localTime`	string	The contact’s local time when the response was generated (ISO 8601 with UTC offset).

Tenure and job changes

Field	Type	Description
`startedAtCurrentCompany`	string	Date the contact started at their current company (YYYY-MM-DD).
`titleStartedAt`	string	Date the contact started their current title (YYYY-MM-DD).
`timeAtRole`	string	Human-readable tenure in the current role, for example “1 Yr 2 Mo”.
`timeAtCompany`	string	Human-readable tenure at the current company.
`formerCompany`, `formerTitle`	string	Most recent previous employer and title.
`formerStartedAt`, `formerEndedAt`	string	Start and end dates of the previous role (YYYY-MM-DD).
`jobHistory`	array	Prior roles, most recent first: `companyName`, `title`, `startedAt`, `endedAt`.
`jobChangeAlert`	string	Type of job change detected in the job change date range.

Company

Field	Type	Description
`companyName`	string	Current company name of the contact.
`companyOriginal`	string	Company name as originally sourced, before normalization.
`companyDescription`	string	Description of the contact’s company.
`companyFounded`	string	Year the company was founded.
`companyIndustry`	string	Industry classification of the company.
`sicCode`, `naicsCode`	string	SIC and NAICS industry codes.
`companyStaffCount`	integer	Approximate number of employees.
`companySize`	string	Employee count range, same values as the `companySize` search filter.
`companyAnnualRevenue`	string	Estimated annual revenue in USD.
`companyRevenue`	string	Revenue range, same values as the `companyRevenue` search filter.
`companyDomain`, `website`	string	Primary website domain of the company.
`companyLIProfileUrl`	string	LinkedIn company page URL.
`companyLinkedInId`	string	LinkedIn numeric identifier for the company.

Signals

Field	Type	Description
`companyType`	string	`Public` or `Private`.
`stockTicker`	string	Stock ticker, if publicly traded.
`newsAndEvents`	array	Recent company news: `title`, `url`, `date`, `type` (for example Acquisition).
`companyFundingTotal`	string	Latest total funding amount.
`companyLatestFundingDate`	string	Date of the latest funding round (YYYY-MM-DD).
`companyLatestFundingClassifications`	array	Classifications of the latest round, for example Series A.

Record metadata

Field	Type	Description
`contactId`	string	Unique identifier for the contact record in your org.
`username`	string	Email of the Seamless.AI user who researched the contact.
`createdAt`, `updatedAt`	string	When the record was created and last updated.
`apiResearchId`	string	The `requestId` from `/contacts/research`, to match results to requests.

Research links

Ready-made URLs for further research on the contact and company: advertisingIntelligence, alexaScore, companyNews, employeeReviews, googleFinance, googleResearch, jobPostings, localSportsTeams, localWeather, paidSearchIntelligence, paidSearchKeywordsIntelligence, searchMarketingIntelligence, secFilings, seoResearch, similarWebsites, socialMediaMentions, socialMediaPosts, socialPosts, websiteAudit, websiteAudit2, websiteGrader, webTechnologies, whois, wikipedia, yahooFinance.

Company attributes

Firmographics

Field	Type	Description
`companyName`	string	Canonical company name.
`domain`	string	Primary website domain.
`description`	string	Company profile description.
`foundedOn`	string	Founding date, when available.
`industries`	string	Comma-separated industry labels.
`sicCode`, `naicsCode`	string	SIC and NAICS industry codes.
`staffCount`	string	Estimated number of employees.
`companySize`	string	Employee count range.
`annualRevenue`	string	Estimated annual revenue.
`companyRevenue`	string	Revenue range.
`topTechnologies`	string	Comma-separated list of top detected technologies.

Phone

Field	Type	Description
`phones`	string	Comma-separated company phone numbers.
`phoneTypes`	string	Comma-separated phone types, in the same order as `phones`.
`phonesAiScores`	string	Comma-separated confidence scores, in the same order as `phones`.

Field	Type	Description
`linkedInProfileUrl`	string	LinkedIn company profile URL.
`linkedInId`	string	LinkedIn company identifier.
`location`	object	Headquarters address.

Signals

Field	Type	Description
`companyType`	string	`Public` or `Private`.
`stockTicker`	string	Stock ticker, if publicly traded.
`newsAndEvents`	array	Recent company news: `title`, `url`, `date`, `type`.
`fundingTotal`	string	Latest total funding amount.
`latestFundingDate`	string	Date of the latest funding round (YYYY-MM-DD).
`latestFundingClassifications`	array	Classifications of the latest round, for example Series A.

Record metadata

Field	Type	Description
`apiResearchId`	string	The `requestId` from `/companies/research`.
`username`	string	The org user the record belongs to.
`createdAt`, `updatedAt`	string	When the record was created and last updated.
`researchedAt`	string	When the company was most recently researched.

Research links

advertisingIntelligenceUrl, alexaScoreUrl, employeeReviewsUrl, googleFinanceUrl, googleResearchUrl, intelUrl, jobPostingsUrl, localSportsTeamsUrl, localWeatherUrl, newsUrl, paidSearchIntelligenceUrl, paidSearchKeywordsIntelligenceUrl, searchMarketingIntelligenceUrl, secFilingsUrl, seoResearchUrl, similarWebsitesUrl, socialMediaMentionsUrl, socialMediaPostsUrl, socialPostsUrl, tweetsUrl, webTechnologiesUrl, websiteAuditUrl, websiteAudit2Url, websiteGraderUrl, whoisUrl, wikipediaUrl, yahooFinanceUrl.

Catalog

Identity resolution

Search

Contact Search filters

Company Search filters

Research

My data

Platform

Coming soon

Contact attributes

Person

Email

Phone

Location

Tenure and job changes

Company

Signals

Record metadata

Research links

Company attributes

Firmographics

Phone

Signals

Record metadata

Research links

​Contact attributes

​Person

​Email

​Phone

​Social

​Location

​Tenure and job changes

​Company

​Signals

​Record metadata

​Research links

​Company attributes

​Firmographics

​Phone

​Social and location

​Signals

​Record metadata

​Research links

Contact attributes

Person

Email

Phone

Social

Location

Tenure and job changes

Company

Signals

Record metadata

Research links

Company attributes

Firmographics

Phone

Social and location

Signals

Record metadata

Research links