DataIQ API Reference

This page will help you get up and running with DataIQ GraphQL API. The API consists of these main queries:

  1. Contact Search: find a single person based on identifying information:
    • Person name and current (or past) companies.
    • LinkedIn profile.
    • Work email or personal email.
    • And more, see full list here.
  2. Company Search: find a single company based on name, domain, country.
  3. Advanced Search: find a list of people based on some broad search criterias e.g: job title, seniority, role, company size, location, etc. See ContactFilter and CompanyFilter.
  4. usage: view API credit usage and limit.

Authentication

The DataIQ API uses API keys to authenticate requests. Please contact us to generate an API key.

Authentication to the API is performed via HTTP Basic Auth. Provide your API key as the basic auth username value. You do not need to provide a password.

Authorization: Basic <authkey>
Contact

dev@leadiq.com

API Endpoints
# GraphQL Endpoint:
https://api.leadiq.com/graphql

Queries

flatAdvancedSearch

Description

Advanced search for flat response

Response

Returns a PersonSearchResponse!

Arguments
Name Description
input - FlatSearchInput!

Example

Query
query FlatAdvancedSearch($input: FlatSearchInput!) {
  flatAdvancedSearch(input: $input) {
    totalPeople
    people {
      id
      companyId
      name
      linkedinId
      linkedinUrl
      title
      role
      state
      country
      seniority
      workEmails
      verifiedWorkEmails
      verifiedLikelyWorkEmails
      workPhones
      personalEmails
      personalPhones
      score
      firstName
      middleName
      lastName
      updatedAt
      currentPositionStartDate
      company {
        id
        name
        industry
        description
        linkedinId
        domain
        employeeCount
        city
        country
        state
        score
        companyTechnologies
        companyTechnologyCategories
      }
      picture
    }
  }
}
Variables
{"input": FlatSearchInput}
Response
{
  "data": {
    "flatAdvancedSearch": {
      "totalPeople": 1,
      "people": [Person]
    }
  }
}

groupedAdvancedSearch

Description

Advanced search for grouped response

Response

Returns a CompanySearchResponse!

Arguments
Name Description
input - GroupedSearchInput!

Example

Query
query GroupedAdvancedSearch($input: GroupedSearchInput!) {
  groupedAdvancedSearch(input: $input) {
    totalCompanies
    companies {
      company {
        id
        name
        industry
        description
        linkedinId
        domain
        employeeCount
        city
        country
        state
        score
        companyTechnologies
        companyTechnologyCategories
      }
      people {
        id
        companyId
        name
        linkedinId
        linkedinUrl
        title
        role
        state
        country
        seniority
        workEmails
        verifiedWorkEmails
        verifiedLikelyWorkEmails
        workPhones
        personalEmails
        personalPhones
        score
        firstName
        middleName
        lastName
        updatedAt
        currentPositionStartDate
        company {
          id
          name
          industry
          description
          linkedinId
          domain
          employeeCount
          city
          country
          state
          score
          companyTechnologies
          companyTechnologyCategories
        }
        picture
      }
      totalContactsInCompany
    }
  }
}
Variables
{"input": GroupedSearchInput}
Response
{
  "data": {
    "groupedAdvancedSearch": {
      "totalCompanies": 1,
      "companies": [CompanyWithPeople]
    }
  }
}

searchCompany

Description

Search for companies based on identifying information: name, domain, country, etc

Response

Returns a CompanySearchResult!

Arguments
Name Description
input - SearchCompanyInput!

Example

Query
query SearchCompany($input: SearchCompanyInput!) {
  searchCompany(input: $input) {
    totalResults
    hasMore
    results {
      source
      name
      alternativeNames
      domain
      description
      emailDomains
      type
      phones
      country
      address
      locationInfo {
        formattedAddress
        street1
        street2
        city
        areaLevel1
        country
        postalCode
      }
      logoUrl
      linkedinId
      linkedinUrl
      numberOfEmployees
      industry
      specialities
      fundingInfo {
        fundingRounds
        fundingTotalUsd
        lastFundingOn
        lastFundingType
        lastFundingUsd
      }
      technologies {
        name
        category
        parentCategory
        attributes
      }
      revenue
      revenueRange {
        start
        end
        description
      }
      predictedRevenue {
        start
        end
        description
      }
      sicCode {
        code
        description
      }
      secondarySicCodes {
        code
        description
      }
      naicsCode {
        code
        description
      }
      employeeRange
      crunchbaseUrl
      facebookUrl
      twitterUrl
    }
  }
}
Variables
{"input": SearchCompanyInput}
Response
{
  "data": {
    "searchCompany": {
      "totalResults": 123,
      "hasMore": true,
      "results": [CompanyInfo]
    }
  }
}

searchPeople

Description

Search for people based on identifying information: name, company (past & present), social profiles, email, etc

Response

Returns a SearchResult!

Arguments
Name Description
input - SearchPeopleInput!

Example

Query
query SearchPeople($input: SearchPeopleInput!) {
  searchPeople(input: $input) {
    totalResults
    hasMore
    results {
      _id
      name {
        first
        fullName
        last
        middle
      }
      currentPositions {
        companyId
        title
        dateRange {
          start
          end
        }
        updatedAt
        emails {
          type
          status
          updatedAt
          value
        }
        phones {
          type
          status
          updatedAt
          value
        }
        companyInfo {
          source
          name
          alternativeNames
          domain
          description
          emailDomains
          type
          phones
          country
          address
          locationInfo {
            ...LocationInfoFragment
          }
          logoUrl
          linkedinId
          linkedinUrl
          numberOfEmployees
          industry
          specialities
          fundingInfo {
            ...FundingInfoFragment
          }
          technologies {
            ...TechnologyInfoFragment
          }
          revenue
          revenueRange {
            ...RevenueRangeFragment
          }
          predictedRevenue {
            ...RevenueRangeFragment
          }
          sicCode {
            ...SICCodeFragment
          }
          secondarySicCodes {
            ...SICCodeFragment
          }
          naicsCode {
            ...NAICSCodeFragment
          }
          employeeRange
          crunchbaseUrl
          facebookUrl
          twitterUrl
        }
        seniority
      }
      pastPositions {
        companyId
        title
        dateRange {
          start
          end
        }
        updatedAt
        emails {
          type
          status
          updatedAt
          value
        }
        phones {
          type
          status
          updatedAt
          value
        }
        companyInfo {
          source
          name
          alternativeNames
          domain
          description
          emailDomains
          type
          phones
          country
          address
          locationInfo {
            ...LocationInfoFragment
          }
          logoUrl
          linkedinId
          linkedinUrl
          numberOfEmployees
          industry
          specialities
          fundingInfo {
            ...FundingInfoFragment
          }
          technologies {
            ...TechnologyInfoFragment
          }
          revenue
          revenueRange {
            ...RevenueRangeFragment
          }
          predictedRevenue {
            ...RevenueRangeFragment
          }
          sicCode {
            ...SICCodeFragment
          }
          secondarySicCodes {
            ...SICCodeFragment
          }
          naicsCode {
            ...NAICSCodeFragment
          }
          employeeRange
          crunchbaseUrl
          facebookUrl
          twitterUrl
        }
        seniority
      }
      linkedin {
        linkedinId
        linkedinUrl
        salesUrls
        type
        status
        updatedAt
        guid
      }
      profiles {
        network
        id
        username
        url
        status
        updatedAt
      }
      location {
        fullAddress
        areaLevel1
        city
        country
        type
        status
        updatedAt
      }
      education {
        name
        type
        linkedinUrl
        facebookUrl
        twitterUrl
        linkedinId
        website
        domain
        degrees
        majors
      }
      updatedAt
      personalEmails {
        type
        status
        updatedAt
        value
      }
      personalPhones {
        type
        status
        updatedAt
        value
      }
    }
  }
}
Variables
{"input": SearchPeopleInput}
Response
{
  "data": {
    "searchPeople": {
      "totalResults": 987,
      "hasMore": false,
      "results": [PersonRecord]
    }
  }
}

usage

Description

View API credit usage and limit

Response

Returns a UsageMetaType!

Example

Query
query Usage {
  usage {
    planUsage {
      name
      usageType
      units
      cap
      billingType
    }
    trialUsage {
      name
      usageType
      units
      cap
      billingType
    }
    subscription {
      status
    }
  }
}
Response
{
  "data": {
    "usage": {
      "planUsage": [PlanUsage],
      "trialUsage": [TrialUsage],
      "subscription": SubscriptionInfo
    }
  }
}

Types

AdvancedSearchEmailVerificationStatusType

Values
Enum Value Description

Verified

VerifiedLikely

Example
"Verified"

ApiName

Values
Enum Value Description

Contact

Company

API

PremiumMobilePhone

AdvancedSearch

Example
"Contact"

ApiUsageType

Values
Enum Value Description

Premium

Standard

Example
"Premium"

BillingType

Values
Enum Value Description

FreeCredits

Postpaid

Prepaid

Example
"FreeCredits"

Boolean

Description

The Boolean scalar type represents true or false.

Example
true

Company

Fields
Field Name Description
id - String!
name - String
industry - String
description - String
linkedinId - String
domain - String
employeeCount - Int
city - String
country - String
state - String
score - Float
companyTechnologies - [String!]
companyTechnologyCategories - [String!]
Example
{
  "id": "abc123",
  "name": "abc123",
  "industry": "xyz789",
  "description": "abc123",
  "linkedinId": "abc123",
  "domain": "abc123",
  "employeeCount": 123,
  "city": "xyz789",
  "country": "abc123",
  "state": "abc123",
  "score": 123.45,
  "companyTechnologies": ["abc123"],
  "companyTechnologyCategories": ["abc123"]
}

CompanyDetails

Fields
Input Field Description
companyId - String
name - String
domain - String
emailDomain - String
linkedinId - String
country - String
searchInPastCompanies - Boolean

If set to true, match company against both current and past positions. Defaults to false.

strict - Boolean

If set to true, all input company details must match some existing companies. If the company doesn't exists, maybe due to bad data, the search result will be empty. Defaults to false.

Example
{
  "companyId": "xyz789",
  "name": "abc123",
  "domain": "xyz789",
  "emailDomain": "abc123",
  "linkedinId": "abc123",
  "country": "abc123",
  "searchInPastCompanies": true,
  "strict": true
}

CompanyFilter

Fields
Input Field Description
ids - [String!]
names - [String!]
domains - [String!]
linkedinIds - [String!]
industries - [String!]
sizes - [CompanySizeFilter!]
cities - [String!]
states - [String!]
countries - [String!]
descriptions - [String!]
technologies - [String!]
technologyCategories - [String!]
Example
{
  "ids": ["xyz789"],
  "names": ["abc123"],
  "domains": ["xyz789"],
  "linkedinIds": ["xyz789"],
  "industries": ["xyz789"],
  "sizes": [CompanySizeFilter],
  "cities": ["xyz789"],
  "states": ["xyz789"],
  "countries": ["abc123"],
  "descriptions": ["abc123"],
  "technologies": ["xyz789"],
  "technologyCategories": ["xyz789"]
}

CompanyInfo

Fields
Field Name Description
source - String! Company Id
name - String!
alternativeNames - [String!]
domain - String
description - String
emailDomains - [String!]
type - String
phones - [String!]
country - String
address - String
locationInfo - LocationInfo
logoUrl - String
linkedinId - String
linkedinUrl - String
numberOfEmployees - Int
industry - String
specialities - [String!]
fundingInfo - FundingInfo
technologies - [TechnologyInfo!]
revenue - Long
revenueRange - RevenueRange
predictedRevenue - RevenueRange
sicCode - SICCode
secondarySicCodes - [SICCode!]
naicsCode - NAICSCode
employeeRange - String
crunchbaseUrl - String
facebookUrl - String
twitterUrl - String
Example
{
  "source": "abc123",
  "name": "xyz789",
  "alternativeNames": ["abc123"],
  "domain": "xyz789",
  "description": "xyz789",
  "emailDomains": ["abc123"],
  "type": "xyz789",
  "phones": ["xyz789"],
  "country": "abc123",
  "address": "xyz789",
  "locationInfo": LocationInfo,
  "logoUrl": "xyz789",
  "linkedinId": "xyz789",
  "linkedinUrl": "abc123",
  "numberOfEmployees": 123,
  "industry": "xyz789",
  "specialities": ["abc123"],
  "fundingInfo": FundingInfo,
  "technologies": [TechnologyInfo],
  "revenue": 1,
  "revenueRange": RevenueRange,
  "predictedRevenue": RevenueRange,
  "sicCode": SICCode,
  "secondarySicCodes": [SICCode],
  "naicsCode": NAICSCode,
  "employeeRange": "xyz789",
  "crunchbaseUrl": "abc123",
  "facebookUrl": "xyz789",
  "twitterUrl": "xyz789"
}

CompanySearchResponse

Fields
Field Name Description
totalCompanies - Long!
companies - [CompanyWithPeople!]!
Example
{"totalCompanies": 1, "companies": [CompanyWithPeople]}

CompanySearchResult

Fields
Field Name Description
totalResults - Int!
hasMore - Boolean!
results - [CompanyInfo!]!
Example
{
  "totalResults": 123,
  "hasMore": true,
  "results": [CompanyInfo]
}

CompanySizeFilter

Fields
Input Field Description
min - Int
max - Int
Example
{"min": 123, "max": 123}

CompanySortingOption

Values
Enum Value Description

IdDesc

IdAsc

SizeDesc

NameAsc

SizeAsc

IndustryAsc

NameDesc

IndustryDesc

Example
"IdDesc"

CompanyWithPeople

Fields
Field Name Description
company - Company!
people - [Person!]!
totalContactsInCompany - Long!
Example
{
  "company": Company,
  "people": [Person],
  "totalContactsInCompany": 1
}

ContactFilter

Fields
Input Field Description
ids - [String!]
names - [String!]
titles - [String!]
linkedinIds - [String!]
linkedinUrls - [String!]
seniorities - [Seniority!]
roles - [String!]
states - [String!]
countries - [String!]
containsWorkEmails - [AdvancedSearchEmailVerificationStatusType!]
updatedAt - DateRangeFilter
newHireFrom - Long
newPromotionFrom - Long
Example
{
  "ids": ["xyz789"],
  "names": ["xyz789"],
  "titles": ["abc123"],
  "linkedinIds": ["abc123"],
  "linkedinUrls": ["abc123"],
  "seniorities": ["VP"],
  "roles": ["xyz789"],
  "states": ["abc123"],
  "countries": ["abc123"],
  "containsWorkEmails": ["Verified"],
  "updatedAt": DateRangeFilter,
  "newHireFrom": 1,
  "newPromotionFrom": 1
}

ContactSortingOption

Values
Enum Value Description

RoleAsc

NameDesc

SeniorityAsc

IdAsc

NameAsc

TitleAsc

SeniorityDesc

RoleDesc

TitleDesc

IdDesc

Example
"RoleAsc"

DateRange

Fields
Field Name Description
start - ZonedDateTime
end - ZonedDateTime
Example
{
  "start": "2021-10-02T00:00:00.000Z",
  "end": "2021-10-02T00:00:00.000Z"
}

DateRangeFilter

Fields
Input Field Description
start - Long
end - Long
Example
{"start": 1, "end": 1}

EducationRecord

Fields
Field Name Description
name - String!
type - String
linkedinUrl - String
facebookUrl - String
twitterUrl - String
linkedinId - String
website - String
domain - String
degrees - [String!]!
majors - [String!]!
Example
{
  "name": "xyz789",
  "type": "abc123",
  "linkedinUrl": "xyz789",
  "facebookUrl": "abc123",
  "twitterUrl": "xyz789",
  "linkedinId": "abc123",
  "website": "xyz789",
  "domain": "xyz789",
  "degrees": ["abc123"],
  "majors": ["xyz789"]
}

EmailType

Description

Type of email

Values
Enum Value Description

WorkEmail

PersonalEmail

Example
"WorkEmail"

EmailVerificationStatusType

Description

Status of an email

Values
Enum Value Description

Verified

VerifiedLikely

Unverified

Invalid

Example
"Verified"

EmailVerificationStatusTypeInput

Values
Enum Value Description

Verified

Unverified

VerifiedLikely

Invalid

Example
"Verified"

FlatSearchInput

Fields
Input Field Description
companyFilter - CompanyFilter
contactFilter - ContactFilter
skip - Int
limit - Int
sortContactsBy - [ContactSortingOption!]
Example
{
  "companyFilter": CompanyFilter,
  "contactFilter": ContactFilter,
  "skip": 123,
  "limit": 987,
  "sortContactsBy": ["RoleAsc"]
}

Float

Description

The Float scalar type represents signed double-precision fractional values as specified by IEEE 754.

Example
987.65

FundingInfo

Fields
Field Name Description
fundingRounds - String
fundingTotalUsd - Long
lastFundingOn - ZonedDateTime
lastFundingType - String
lastFundingUsd - Long
Example
{
  "fundingRounds": "2",
  "fundingTotalUsd": 40000000,
  "lastFundingOn": "2021-10-02T00:00:00.000Z",
  "lastFundingType": "Series B",
  "lastFundingUsd": 30000000
}

GenericFieldStatus

Description

A generic field status

Values
Enum Value Description

Valid

Invalid

Example
"Valid"

GenericFieldType

Description

A generic field type

Values
Enum Value Description

NotApplicable

Example
"NotApplicable"

GroupedSearchInput

Description

Input for Advanced Search for grouped response

Fields
Input Field Description
companyFilter - CompanyFilter
contactFilter - ContactFilter
skip - Int
limit - Int
limitPerCompany - Int
sortCompaniesBy - [CompanySortingOption!]
sortContactsBy - [ContactSortingOption!]
Example
{
  "companyFilter": CompanyFilter,
  "contactFilter": ContactFilter,
  "skip": 987,
  "limit": 987,
  "limitPerCompany": 987,
  "sortCompaniesBy": ["IdDesc"],
  "sortContactsBy": ["RoleAsc"]
}

Int

Description

The Int scalar type represents non-fractional signed whole numeric values. Int can represent values between -(2^31) and 2^31 - 1.

Example
123

LinkedinRecord

Fields
Field Name Description
linkedinId - String
linkedinUrl - String
salesUrls - [String!]
type - GenericFieldType!
status - GenericFieldStatus!
updatedAt - ZonedDateTime!
guid - String
Example
{
  "linkedinId": "xyz789",
  "linkedinUrl": "abc123",
  "salesUrls": ["xyz789"],
  "type": "NotApplicable",
  "status": "Valid",
  "updatedAt": "2021-10-02T00:00:00.000Z",
  "guid": "abc123"
}

LocationInfo

Fields
Field Name Description
formattedAddress - String
street1 - String
street2 - String
city - String
areaLevel1 - String
country - String
postalCode - String
Example
{
  "formattedAddress": "abc123",
  "street1": "abc123",
  "street2": "abc123",
  "city": "xyz789",
  "areaLevel1": "abc123",
  "country": "xyz789",
  "postalCode": "abc123"
}

LocationRecord

Fields
Field Name Description
fullAddress - String
areaLevel1 - String
city - String
country - String
type - GenericFieldType!
status - GenericFieldStatus!
updatedAt - ZonedDateTime!
Example
{
  "fullAddress": "abc123",
  "areaLevel1": "xyz789",
  "city": "abc123",
  "country": "xyz789",
  "type": "NotApplicable",
  "status": "Valid",
  "updatedAt": "2021-10-02T00:00:00.000Z"
}

Long

Description

The Long scalar type represents non-fractional signed whole numeric values. Long can represent values between -(2^63) and 2^63 - 1.

Example
1

NAICSCode

Fields
Field Name Description
code - String!
description - String!
Example
{
  "code": "xyz789",
  "description": "xyz789"
}

NameInfo

Fields
Field Name Description
first - String!
fullName - String!
last - String
middle - String
Example
{
  "first": "xyz789",
  "fullName": "abc123",
  "last": "abc123",
  "middle": "xyz789"
}

Person

Fields
Field Name Description
id - String!
companyId - String!
name - String
linkedinId - String
linkedinUrl - String
title - String
role - String
state - String
country - String
seniority - String
workEmails - [String!]
verifiedWorkEmails - [String!]
verifiedLikelyWorkEmails - [String!]
workPhones - [String!]
personalEmails - [String!]
personalPhones - [String!]
score - Float
firstName - String
middleName - String
lastName - String
updatedAt - ZonedDateTime
currentPositionStartDate - ZonedDateTime
company - Company
picture - String
Example
{
  "id": "xyz789",
  "companyId": "xyz789",
  "name": "xyz789",
  "linkedinId": "xyz789",
  "linkedinUrl": "abc123",
  "title": "xyz789",
  "role": "abc123",
  "state": "xyz789",
  "country": "xyz789",
  "seniority": "xyz789",
  "workEmails": ["abc123"],
  "verifiedWorkEmails": ["abc123"],
  "verifiedLikelyWorkEmails": ["xyz789"],
  "workPhones": ["abc123"],
  "personalEmails": ["xyz789"],
  "personalPhones": ["abc123"],
  "score": 987.65,
  "firstName": "xyz789",
  "middleName": "abc123",
  "lastName": "abc123",
  "updatedAt": "2021-10-02T00:00:00.000Z",
  "currentPositionStartDate": "2021-10-02T00:00:00.000Z",
  "company": Company,
  "picture": "xyz789"
}

PersonRecord

Fields
Field Name Description
_id - String!
name - NameInfo!
currentPositions - [PositionRecord!]!
pastPositions - [PositionRecord!]!
linkedin - LinkedinRecord
profiles - [SocialProfile!]!
location - LocationRecord
education - [EducationRecord!]!
updatedAt - ZonedDateTime
personalEmails - [PersonalEmailRecordType!]!
personalPhones - [PersonalPhoneRecordType!]!
Example
{
  "_id": "abc123",
  "name": NameInfo,
  "currentPositions": [PositionRecord],
  "pastPositions": [PositionRecord],
  "linkedin": LinkedinRecord,
  "profiles": [SocialProfile],
  "location": LocationRecord,
  "education": [EducationRecord],
  "updatedAt": "2021-10-02T00:00:00.000Z",
  "personalEmails": [PersonalEmailRecordType],
  "personalPhones": [PersonalPhoneRecordType]
}

PersonSearchResponse

Fields
Field Name Description
totalPeople - Long!
people - [Person!]!
Example
{"totalPeople": 1, "people": [Person]}

PersonalEmailRecordType

Fields
Field Name Description
type - EmailType!
status - EmailVerificationStatusType!
updatedAt - ZonedDateTime!
value - String!
Example
{
  "type": "WorkEmail",
  "status": "Verified",
  "updatedAt": "2021-10-02T00:00:00.000Z",
  "value": "abc123"
}

PersonalPhoneRecordType

Fields
Field Name Description
type - PhoneType!
status - PhoneVerificationStatusType!
updatedAt - ZonedDateTime!
value - String!
Example
{
  "type": "WorkPhone",
  "status": "Verified",
  "updatedAt": "2021-10-02T00:00:00.000Z",
  "value": "xyz789"
}

PhoneType

Description

Type of phone

Values
Enum Value Description

WorkPhone

WorkMobile

WorkHQ

WorkBranch

PersonalPhone

PersonalLandline

PersonalMobile

Fax

Example
"WorkPhone"

PhoneVerificationStatusType

Description

Status of a phone number

Values
Enum Value Description

Verified

Unverified

Invalid

Suppressed

Example
"Verified"

PlanUsage

Fields
Field Name Description
name - ApiName!
usageType - ApiUsageType!
units - Int!
cap - Int
billingType - BillingType!
Example
{
  "name": "Contact",
  "usageType": "Premium",
  "units": 987,
  "cap": 123,
  "billingType": "FreeCredits"
}

PositionRecord

Fields
Field Name Description
companyId - String!
title - String
dateRange - DateRange
updatedAt - ZonedDateTime!
emails - [WorkEmailRecordType!]!
phones - [WorkPhoneRecordType!]!
companyInfo - CompanyInfo
seniority - String
Example
{
  "companyId": "abc123",
  "title": "xyz789",
  "dateRange": DateRange,
  "updatedAt": "2021-10-02T00:00:00.000Z",
  "emails": [WorkEmailRecordType],
  "phones": [WorkPhoneRecordType],
  "companyInfo": CompanyInfo,
  "seniority": "abc123"
}

PremiumDataField

Values
Enum Value Description

MobilePhone

Example
"MobilePhone"

ProfileFilterType

Values
Enum Value Description

HasVerifiedWorkPhone

HasPersonalPhone

HasWorkPhone

HasPersonalEmail

HasVerifiedWorkEmail

HasWorkEmail

Example
"HasVerifiedWorkPhone"

RevenueRange

Fields
Field Name Description
start - Long
end - Long
description - String
Example
{
  "start": 1,
  "end": 1,
  "description": "xyz789"
}

SICCode

Fields
Field Name Description
code - String!
description - String!
Example
{
  "code": "xyz789",
  "description": "xyz789"
}

SearchCompanyInput

Description

Input for searching company

Fields
Input Field Description
source - String
name - String
domain - String
linkedinId - String
country - String
strict - Boolean

If set to true, all input company details must match some existing companies. Defaults to false.

Example
{
  "source": "abc123",
  "name": "abc123",
  "domain": "xyz789",
  "linkedinId": "abc123",
  "country": "abc123",
  "strict": false
}

SearchPeopleInput

Description

Input for searching people

Fields
Input Field Description
skip - Int
limit - Int
id - String
firstName - String
lastName - String
middleName - String
fullName - String
company - CompanyDetails
linkedinId - String
linkedinUrl - String
email - String
hashedEmail - String

Search by SHA256 hashed email

phone - String
workEmailStatusIn - [EmailVerificationStatusTypeInput!]

If set, only return result with email statuses from this list. Default to all statuses.

containsWorkContactInfo - Boolean

If set to true, only return results with work contacts. Default to false.

profileFilter - [ProfileFilterType!]

If set, only return results that satisfy these filters. Default to empty.

premiumDataAddOns - [PremiumDataField!]

If set, use premium credits to find contact information. Default to empty.

includeInvalid - Boolean

If set to true, include Invalid emails in result. Default to false.

Example
{
  "skip": 123,
  "limit": 987,
  "id": "xyz789",
  "firstName": "xyz789",
  "lastName": "xyz789",
  "middleName": "abc123",
  "fullName": "abc123",
  "company": CompanyDetails,
  "linkedinId": "xyz789",
  "linkedinUrl": "xyz789",
  "email": "abc123",
  "hashedEmail": "xyz789",
  "phone": "xyz789",
  "workEmailStatusIn": ["Verified"],
  "containsWorkContactInfo": false,
  "profileFilter": ["HasVerifiedWorkPhone"],
  "premiumDataAddOns": ["MobilePhone"],
  "includeInvalid": false
}

SearchResult

Fields
Field Name Description
totalResults - Int!
hasMore - Boolean!
results - [PersonRecord!]!
Example
{
  "totalResults": 123,
  "hasMore": false,
  "results": [PersonRecord]
}

Seniority

Values
Enum Value Description

VP

Manager

Director

Executive

Other

Example
"VP"

SocialNetworkType

Description

Network name of the social profile.

Values
Enum Value Description

Twitter

Foursquare

Gravatar

Pinterest

Angellist

Facebook

Klout

Example
"Twitter"

SocialProfile

Fields
Field Name Description
network - SocialNetworkType!
id - String
username - String
url - String
status - GenericFieldStatus!
updatedAt - ZonedDateTime!
Example
{
  "network": "Twitter",
  "id": "xyz789",
  "username": "xyz789",
  "url": "xyz789",
  "status": "Valid",
  "updatedAt": "2021-10-02T00:00:00.000Z"
}

String

Description

The String scalar type represents textual data, represented as UTF-8 character sequences. The String type is most often used by GraphQL to represent free-form human-readable text.

Example
"xyz789"

SubscriptionInfo

Fields
Field Name Description
status - String
Example
{"status": "abc123"}

TechnologyInfo

Fields
Field Name Description
name - String!
category - String
parentCategory - String
attributes - [String!]!
Example
{
  "name": "Amazon Web Services (AWS)",
  "category": "Infrastructure as a Service (IaaS)",
  "parentCategory": "Cloud Services",
  "attributes": ["Software as a Service (SaaS)"]
}

TrialUsage

Fields
Field Name Description
name - ApiName!
usageType - ApiUsageType!
units - Int!
cap - Int
billingType - BillingType!
Example
{
  "name": "Contact",
  "usageType": "Premium",
  "units": 987,
  "cap": 987,
  "billingType": "FreeCredits"
}

UsageMetaType

Fields
Field Name Description
planUsage - [PlanUsage!]! Returns the active(non-trial) api usage in the current billing period. The from input argument is deprecated and will be ignored.
Arguments
from - ZonedDateTime
trialUsage - [TrialUsage!]!
subscription - SubscriptionInfo!
Example
{
  "planUsage": [PlanUsage],
  "trialUsage": [TrialUsage],
  "subscription": SubscriptionInfo
}

WorkEmailRecordType

Fields
Field Name Description
type - EmailType!
status - EmailVerificationStatusType!
updatedAt - ZonedDateTime!
value - String!
Example
{
  "type": "WorkEmail",
  "status": "Verified",
  "updatedAt": "2021-10-02T00:00:00.000Z",
  "value": "xyz789"
}

WorkPhoneRecordType

Fields
Field Name Description
type - PhoneType!
status - PhoneVerificationStatusType!
updatedAt - ZonedDateTime!
value - String!
Example
{
  "type": "WorkPhone",
  "status": "Verified",
  "updatedAt": "2021-10-02T00:00:00.000Z",
  "value": "abc123"
}

ZonedDateTime

Description

Zoned date time type

Example
"2021-10-02T00:00:00.000Z"