Datafiniti API

The Datafiniti Developer Hub

Welcome to the Datafiniti Developer Hub. Here you'll find comprehensive guides and documentation to help you start using the Datafiniti API as quickly as possible. Let's get some data!

Get Started    

People Data Schema

The people data schema below lists all available fields in a property record. Note that actual people records may not have every field present.

Field Name
Example Value (in JSON)
Description

address

"address": "1125 Lancaster Avenue"

The current work address of this person.
Field type: text

birthDate

"birthDate": "1977-10-02"

The full date of birth of the person in YYYY-MM-DD format.
Field type: date

birthYear

"birthYear": "1977"

The birth year of the person in YYYY format.
Field type: integer

businessCategories

"businessCategories": [
  "Advertising Agencies"
]

A list of category keywords used for the business.
Field type: text

businessName

"businessName": "International Direct Response Inc"

The current business where this person works.
Field type: text

city

"city": "Berwyn"

The current city where this person works.
Field type: text

country

"country": "US"

The current country where this person works.
Field type: text

dateAdded

"dateAdded": "2017-01-08T19:12:13Z"

The date this person was first added to the people database.
Field type: date

dateUpdated

"dateUpdated": "2017-01-08T19:12:13Z"

The most recent date this person was updated or seen by our system.
Field type: date

domains

"domains": [
  "datafiniti.co"
]

A list of each unique domain found in the sourceURLs field.
Field type: domain

emails

"emails": [
  "[email protected]"
]

A list of emails associated with this person.
Field type: text

firstName

"firstName": "Doug"

The person's first name.
Field type: text

gender

"gender": "male"

The person's gender.
Field type: text

interests

"interests": [
  "disaster and humanitarian relief",
  "politics",
  "human rights",
  "psychology",
  "reddit",
  "cooking",
  "starcraft ii",
  "startups",
  "online dating",
  "saas",
  "painting",
  "heroes of newerth",
  "ventures for good"
]

The personal interests of the person.
Field type: text

jobFunction

"jobFunction": "Marketing"

The person's current job function. Job function values can be found here.
Field type: text

jobLevel

"jobLevel": "C-Team"

The person's current job level.
Job level values can be found here.
Field type: text

jobSkills

"jobSkills": [
  "enterprise software",
  "start ups",
  "monetization",
  "social networking",
  "usability",
  "product management",
  "photoshop",
  "user experience",
  "web applications",
  "agile methodologies",
  "scrum",
  "video games"
]

The person's job-related skills.
Field type: text

jobTitle

"jobTitle": "President of New Business Development"

The person's current job title.
Field type: text

keys

"keys": [
  "dougidronlinenet"
]

A list of internal Datafiniti identifiers for this property. The keys field is used to merge raw data from individual sources into the master Datafiniti record. Learn more about how this works.
Field type: keyword

lastName

"lastName": "Guyer"

The person's last name.
Field type: text

linkedinURL

"linkedinURL": "https://linkedin.com/in/some-person-7525231"

LinkedIn URL for this person. LinkedIn
Field type: keyword

numEmployeesMin

"numEmployeesMin": 20

The minimum number of employees at the business where this person currently works.
Field type: integer

numEmployeesMax

"numEmployeesMax": 99

The maximum number of employees at the business where this person currently works.
Field type: integer

phones

"phones": [
  "6109930500"
]

A list of phone numbers where this person can be reached.
Field type: keyword

postalCode

"postalCode": "19312-1243"

The current postal/zip code where this person works.
Field type: keyword

personalEmails

"personalEmails": [  
  "[email protected]"
]

The personal email addresses of the person.
Field type: text

primaryEmail

"primaryEmail": "[email protected]"

The person's current professional email address.
Field type: text

professionalEmails

"professionalEmails"[ 
  "[email protected]",
  "[email protected]"
]

The person's professional email addresses.
Field type: text

province

"province": "PA"

The current province/state where this person works.
Field type: text

sourceURLs

"sourceURLs": [
  "https://datafiniti.co"
]

A list of URLs used to generate data for this business location. If https://datafiniti.co is used, then the data was sourced from our data partners.
Field type: keyword

Updated about a month ago

People Data Schema


Suggested Edits are limited on API Reference Pages

You can only suggest edits to Markdown body content, but not to the API spec.