info:
description: People Data Labs API
title: api.peopledatalabs.com
version: '5.0'
servers:
- url: https://api.peopledatalabs.com
components:
securitySchemes:
APIKeyHeader:
in: header
name: X-API-Key
type: apiKey
schemas:
Email:
type: object
properties:
address:
type: string
description: The full parsed email
type:
type: string
enum:
- professional
- personal
- null
description: The type of email either current_professional, professional, personal or null
StreetAddress:
type: object
properties:
street_address:
type: string
description: The street address associated with the location object
address_line_2:
type: string
description: The secondary street address associated with the location object
name:
type: string
description: A string that appends location fields together to create a standard location field
locality:
type: string
description: The administrative locality associated with the location object
metro:
type: string
enum:
- abilene, texas
- akron, ohio
- albany, georgia
- albany, new york
- albany, oregon
- albuquerque, new mexico
- alexandria, louisiana
- allentown, pennsylvania
- altoona, pennsylvania
- amarillo, texas
- ames, iowa
- anchorage, alaska
- ann arbor, michigan
- anniston, alabama
- appleton, wisconsin
- asheville, north carolina
- athens, georgia
- atlanta, georgia
- atlantic city, new jersey
- auburn, alabama
- augusta, georgia
- austin, texas
- bakersfield, california
- baltimore, maryland
- bangor, maine
- barnstable town, massachusetts
- baton rouge, louisiana
- battle creek, michigan
- bay city, michigan
- beaumont, texas
- bellingham, washington
- billings, montana
- binghamton, new york
- birmingham, alabama
- bismarck, north dakota
- blacksburg, virginia
- bloomington, illinois
- bloomington, indiana
- boise city, idaho
- boston, massachusetts
- boulder, colorado
- bowling green, kentucky
- bremerton, washington
- bridgeport, connecticut
- brownsville, texas
- buffalo, new york
- burlington, north carolina
- burlington, vermont
- canton, ohio
- cape coral, florida
- cape girardeau, missouri
- carbondale, illinois
- carson city, nevada
- casper, wyoming
- cedar rapids, iowa
- champaign, illinois
- charleston, south carolina
- charleston, west virginia
- charlotte, north carolina
- charlottesville, virginia
- chattanooga, tennessee
- cheyenne, wyoming
- chicago, illinois
- chico, california
- cincinnati, ohio
- clarksville, tennessee
- cleveland, ohio
- cleveland, tennessee
- coeur d'alene, idaho
- college station, texas
- colorado springs, colorado
- columbia, missouri
- columbia, south carolina
- columbus, georgia
- columbus, indiana
- columbus, ohio
- corpus christi, texas
- corvallis, oregon
- crestview, florida
- cumberland, maryland
- dallas, texas
- dalton, georgia
- danville, illinois
- davenport, iowa
- dayton, ohio
- decatur, alabama
- decatur, illinois
- deltona, florida
- denver, colorado
- des moines, iowa
- detroit, michigan
- district of columbia
- dothan, alabama
- dover, delaware
- dubuque, iowa
- duluth, minnesota
- durham, north carolina
- eau claire, wisconsin
- el centro, california
- el paso, texas
- elizabethtown, kentucky
- elkhart, indiana
- elmira, new york
- enid, oklahoma
- erie, pennsylvania
- eugene, oregon
- evansville, indiana
- fairbanks, alaska
- fargo, north dakota
- farmington, new mexico
- fayetteville, arkansas
- fayetteville, north carolina
- flagstaff, arizona
- flint, michigan
- florence, alabama
- florence, south carolina
- fond du lac, wisconsin
- fort collins, colorado
- fort smith, arkansas
- fort wayne, indiana
- fresno, california
- gadsden, alabama
- gainesville, florida
- gainesville, georgia
- goldsboro, north carolina
- grand forks, north dakota
- grand island, nebraska
- grand junction, colorado
- grand rapids, michigan
- grants pass, oregon
- great falls, montana
- greeley, colorado
- green bay, wisconsin
- greensboro, north carolina
- greenville, north carolina
- greenville, south carolina
- gulfport, mississippi
- hagerstown, maryland
- hanford, california
- harrisburg, pennsylvania
- harrisonburg, virginia
- hartford, connecticut
- hattiesburg, mississippi
- hickory, north carolina
- hilton head island, south carolina
- hinesville, georgia
- hot springs, arkansas
- houma, louisiana
- houston, texas
- huntington, west virginia
- huntsville, alabama
- idaho falls, idaho
- indianapolis, indiana
- iowa city, iowa
- ithaca, new york
- jackson, michigan
- jackson, mississippi
- jackson, tennessee
- jacksonville, florida
- jacksonville, north carolina
- janesville, wisconsin
- jefferson city, missouri
- johnson city, tennessee
- johnstown, pennsylvania
- jonesboro, arkansas
- joplin, missouri
- kahului, hawaii
- kalamazoo, michigan
- kankakee, illinois
- kansas city, missouri
- kennewick, washington
- killeen, texas
- kingsport, tennessee
- kingston, new york
- knoxville, tennessee
- kokomo, indiana
- la crosse, wisconsin
- lafayette, indiana
- lafayette, louisiana
- lake charles, louisiana
- lake havasu city, arizona
- lakeland, florida
- lancaster, pennsylvania
- lansing, michigan
- laredo, texas
- las cruces, new mexico
- las vegas, nevada
- lawrence, kansas
- lawton, oklahoma
- lebanon, pennsylvania
- lewiston, idaho
- lewiston, maine
- lexington, kentucky
- lima, ohio
- lincoln, nebraska
- little rock, arkansas
- logan, utah
- longview, texas
- longview, washington
- los angeles, california
- louisville, kentucky
- lubbock, texas
- lynchburg, virginia
- macon, georgia
- madera, california
- madison, wisconsin
- manchester, new hampshire
- manhattan, kansas
- mankato, minnesota
- mansfield, ohio
- mcallen, texas
- medford, oregon
- memphis, tennessee
- merced, california
- miami, florida
- michigan city, indiana
- midland, michigan
- midland, texas
- milwaukee, wisconsin
- minneapolis, minnesota
- missoula, montana
- mobile, alabama
- modesto, california
- monroe, louisiana
- monroe, michigan
- montgomery, alabama
- morgantown, west virginia
- morristown, tennessee
- mount vernon, washington
- muncie, indiana
- muskegon, michigan
- myrtle beach, south carolina
- napa, california
- naples, florida
- nashville, tennessee
- new bern, north carolina
- new haven, connecticut
- new orleans, louisiana
- new york, new york
- north port, florida
- norwich, connecticut
- ocala, florida
- odessa, texas
- ogden, utah
- oklahoma city, oklahoma
- olympia, washington
- omaha, nebraska
- orlando, florida
- oshkosh, wisconsin
- owensboro, kentucky
- oxnard, california
- palm bay, florida
- panama city, florida
- parkersburg, west virginia
- pensacola, florida
- peoria, illinois
- philadelphia, pennsylvania
- phoenix, arizona
- pine bluff, arkansas
- pittsburgh, pennsylvania
- pittsfield, massachusetts
- pocatello, idaho
- port st. lucie, florida
- portland, maine
- portland, oregon
- poughkeepsie, new york
- prescott valley, arizona
- providence, rhode island
- provo, utah
- pueblo, colorado
- punta gorda, florida
- racine, wisconsin
- raleigh, north carolina
- rapid city, south dakota
- reading, pennsylvania
- redding, california
- reno, nevada
- richmond, virginia
- riverside, california
- roanoke, virginia
- rochester, minnesota
- rochester, new york
- rockford, illinois
- rocky mount, north carolina
- rome, georgia
- sacramento, california
- saginaw, michigan
- salem, oregon
- salinas, california
- salisbury, maryland
- salt lake city, utah
- san angelo, texas
- san antonio, texas
- san diego, california
- san francisco, california
- san jose, california
- san luis obispo, california
- santa cruz, california
- santa fe, new mexico
- santa maria, california
- santa rosa, california
- savannah, georgia
- scranton, pennsylvania
- seattle, washington
- sebastian, florida
- sheboygan, wisconsin
- sherman, texas
- shreveport, louisiana
- sierra vista, arizona
- sioux city, iowa
- sioux falls, south dakota
- south bend, indiana
- spartanburg, south carolina
- spokane, washington
- springfield, illinois
- springfield, massachusetts
- springfield, missouri
- springfield, ohio
- st. cloud, minnesota
- st. george, utah
- st. joseph, missouri
- st. louis, missouri
- state college, pennsylvania
- staunton, virginia
- stockton, california
- sumter, south carolina
- syracuse, new york
- tallahassee, florida
- tampa, florida
- terre haute, indiana
- texarkana, texas
- toledo, ohio
- topeka, kansas
- trenton, new jersey
- tucson, arizona
- tulsa, oklahoma
- tuscaloosa, alabama
- twin falls, idaho
- tyler, texas
- urban honolulu, hawaii
- utica, new york
- valdosta, georgia
- vallejo, california
- victoria, texas
- vineland, new jersey
- virginia beach, virginia
- visalia, california
- waco, texas
- walla walla, washington
- warner robins, georgia
- waterloo, iowa
- watertown, new york
- wausau, wisconsin
- weirton, west virginia
- wenatchee, washington
- wheeling, west virginia
- wichita falls, texas
- wichita, kansas
- williamsport, pennsylvania
- wilmington, north carolina
- winchester, virginia
- worcester, massachusetts
- yakima, washington
- york, pennsylvania
- youngstown, ohio
- yuba city, california
- yuma, arizona
description: The metro area associated with the location object
region:
type: string
description: The administrative region associated with the location object
postal_code:
type: string
description: The postal code associated with the location object
country:
type: string
description: The country associated with the location object
geo:
type: string
description: The geolocation associated with the location object in latitude, longitude format
continent:
type: string
enum:
- africa
- antarctica
- asia
- europe
- north america
- oceania
- south america
description: The continent associated with the country in the location object
Title:
type: object
properties:
name:
type: string
description: The inputted title from our data sources with some basic cleaning and mapping in
order to help with merging
levels:
type: array
enum:
- unpaid
- training
- entry
- manager
- senior
- partner
- director
- vp
- owner
- cxo
description: Levels associated with a title
items:
type: string
role:
type: string
enum:
- customer_service
- design
- education
- engineering
- finance
- health
- human_resources
- legal
- marketing
- media
- operations
- public_relations
- real_estate
- sales
- trades
description: A person's job title derived role
sub_role:
type: string
enum:
- accounting
- accounts
- brand_marketing
- broadcasting
- business_development
- compensation
- content_marketing
- customer_success
- data
- dental
- devops
- doctor
- editorial
- education_administration
- electrical
- employee_development
- events
- fitness
- graphic_design
- information_technology
- investment
- journalism
- judicial
- lawyer
- logistics
- mechanical
- media_relations
- network
- nursing
- office_management
- paralegal
- pipeline
- product
- product_design
- product_marketing
- professor
- project_engineering
- project_management
- property_management
- quality_assurance
- realtor
- recruiting
- researcher
- security
- software
- support
- systems
- tax
- teacher
- therapy
- video
- web
- web_design
- wellness
- writing
description: A person's job title derived subrole. Each subrole maps to a role
ExperienceCompanyLocation:
type: object
properties:
street_address:
type: string
description: Company HQ address
address_line_2:
type: string
description: The address line 2 associated with the company HQ
name:
type: string
description: The canonical location name associated with the company HQ
locality:
type: string
description: Company locality
metro:
type: string
enum:
- abilene, texas
- akron, ohio
- albany, georgia
- albany, new york
- albany, oregon
- albuquerque, new mexico
- alexandria, louisiana
- allentown, pennsylvania
- altoona, pennsylvania
- amarillo, texas
- ames, iowa
- anchorage, alaska
- ann arbor, michigan
- anniston, alabama
- appleton, wisconsin
- asheville, north carolina
- athens, georgia
- atlanta, georgia
- atlantic city, new jersey
- auburn, alabama
- augusta, georgia
- austin, texas
- bakersfield, california
- baltimore, maryland
- bangor, maine
- barnstable town, massachusetts
- baton rouge, louisiana
- battle creek, michigan
- bay city, michigan
- beaumont, texas
- bellingham, washington
- billings, montana
- binghamton, new york
- birmingham, alabama
- bismarck, north dakota
- blacksburg, virginia
- bloomington, illinois
- bloomington, indiana
- boise city, idaho
- boston, massachusetts
- boulder, colorado
- bowling green, kentucky
- bremerton, washington
- bridgeport, connecticut
- brownsville, texas
- buffalo, new york
- burlington, north carolina
- burlington, vermont
- canton, ohio
- cape coral, florida
- cape girardeau, missouri
- carbondale, illinois
- carson city, nevada
- casper, wyoming
- cedar rapids, iowa
- champaign, illinois
- charleston, south carolina
- charleston, west virginia
- charlotte, north carolina
- charlottesville, virginia
- chattanooga, tennessee
- cheyenne, wyoming
- chicago, illinois
- chico, california
- cincinnati, ohio
- clarksville, tennessee
- cleveland, ohio
- cleveland, tennessee
- coeur d'alene, idaho
- college station, texas
- colorado springs, colorado
- columbia, missouri
- columbia, south carolina
- columbus, georgia
- columbus, indiana
- columbus, ohio
- corpus christi, texas
- corvallis, oregon
- crestview, florida
- cumberland, maryland
- dallas, texas
- dalton, georgia
- danville, illinois
- davenport, iowa
- dayton, ohio
- decatur, alabama
- decatur, illinois
- deltona, florida
- denver, colorado
- des moines, iowa
- detroit, michigan
- district of columbia
- dothan, alabama
- dover, delaware
- dubuque, iowa
- duluth, minnesota
- durham, north carolina
- eau claire, wisconsin
- el centro, california
- el paso, texas
- elizabethtown, kentucky
- elkhart, indiana
- elmira, new york
- enid, oklahoma
- erie, pennsylvania
- eugene, oregon
- evansville, indiana
- fairbanks, alaska
- fargo, north dakota
- farmington, new mexico
- fayetteville, arkansas
- fayetteville, north carolina
- flagstaff, arizona
- flint, michigan
- florence, alabama
- florence, south carolina
- fond du lac, wisconsin
- fort collins, colorado
- fort smith, arkansas
- fort wayne, indiana
- fresno, california
- gadsden, alabama
- gainesville, florida
- gainesville, georgia
- goldsboro, north carolina
- grand forks, north dakota
- grand island, nebraska
- grand junction, colorado
- grand rapids, michigan
- grants pass, oregon
- great falls, montana
- greeley, colorado
- green bay, wisconsin
- greensboro, north carolina
- greenville, north carolina
- greenville, south carolina
- gulfport, mississippi
- hagerstown, maryland
- hanford, california
- harrisburg, pennsylvania
- harrisonburg, virginia
- hartford, connecticut
- hattiesburg, mississippi
- hickory, north carolina
- hilton head island, south carolina
- hinesville, georgia
- hot springs, arkansas
- houma, louisiana
- houston, texas
- huntington, west virginia
- huntsville, alabama
- idaho falls, idaho
- indianapolis, indiana
- iowa city, iowa
- ithaca, new york
- jackson, michigan
- jackson, mississippi
- jackson, tennessee
- jacksonville, florida
- jacksonville, north carolina
- janesville, wisconsin
- jefferson city, missouri
- johnson city, tennessee
- johnstown, pennsylvania
- jonesboro, arkansas
- joplin, missouri
- kahului, hawaii
- kalamazoo, michigan
- kankakee, illinois
- kansas city, missouri
- kennewick, washington
- killeen, texas
- kingsport, tennessee
- kingston, new york
- knoxville, tennessee
- kokomo, indiana
- la crosse, wisconsin
- lafayette, indiana
- lafayette, louisiana
- lake charles, louisiana
- lake havasu city, arizona
- lakeland, florida
- lancaster, pennsylvania
- lansing, michigan
- laredo, texas
- las cruces, new mexico
- las vegas, nevada
- lawrence, kansas
- lawton, oklahoma
- lebanon, pennsylvania
- lewiston, idaho
- lewiston, maine
- lexington, kentucky
- lima, ohio
- lincoln, nebraska
- little rock, arkansas
- logan, utah
- longview, texas
- longview, washington
- los angeles, california
- louisville, kentucky
- lubbock, texas
- lynchburg, virginia
- macon, georgia
- madera, california
- madison, wisconsin
- manchester, new hampshire
- manhattan, kansas
- mankato, minnesota
- mansfield, ohio
- mcallen, texas
- medford, oregon
- memphis, tennessee
- merced, california
- miami, florida
- michigan city, indiana
- midland, michigan
- midland, texas
- milwaukee, wisconsin
- minneapolis, minnesota
- missoula, montana
- mobile, alabama
- modesto, california
- monroe, louisiana
- monroe, michigan
- montgomery, alabama
- morgantown, west virginia
- morristown, tennessee
- mount vernon, washington
- muncie, indiana
- muskegon, michigan
- myrtle beach, south carolina
- napa, california
- naples, florida
- nashville, tennessee
- new bern, north carolina
- new haven, connecticut
- new orleans, louisiana
- new york, new york
- north port, florida
- norwich, connecticut
- ocala, florida
- odessa, texas
- ogden, utah
- oklahoma city, oklahoma
- olympia, washington
- omaha, nebraska
- orlando, florida
- oshkosh, wisconsin
- owensboro, kentucky
- oxnard, california
- palm bay, florida
- panama city, florida
- parkersburg, west virginia
- pensacola, florida
- peoria, illinois
- philadelphia, pennsylvania
- phoenix, arizona
- pine bluff, arkansas
- pittsburgh, pennsylvania
- pittsfield, massachusetts
- pocatello, idaho
- port st. lucie, florida
- portland, maine
- portland, oregon
- poughkeepsie, new york
- prescott valley, arizona
- providence, rhode island
- provo, utah
- pueblo, colorado
- punta gorda, florida
- racine, wisconsin
- raleigh, north carolina
- rapid city, south dakota
- reading, pennsylvania
- redding, california
- reno, nevada
- richmond, virginia
- riverside, california
- roanoke, virginia
- rochester, minnesota
- rochester, new york
- rockford, illinois
- rocky mount, north carolina
- rome, georgia
- sacramento, california
- saginaw, michigan
- salem, oregon
- salinas, california
- salisbury, maryland
- salt lake city, utah
- san angelo, texas
- san antonio, texas
- san diego, california
- san francisco, california
- san jose, california
- san luis obispo, california
- santa cruz, california
- santa fe, new mexico
- santa maria, california
- santa rosa, california
- savannah, georgia
- scranton, pennsylvania
- seattle, washington
- sebastian, florida
- sheboygan, wisconsin
- sherman, texas
- shreveport, louisiana
- sierra vista, arizona
- sioux city, iowa
- sioux falls, south dakota
- south bend, indiana
- spartanburg, south carolina
- spokane, washington
- springfield, illinois
- springfield, massachusetts
- springfield, missouri
- springfield, ohio
- st. cloud, minnesota
- st. george, utah
- st. joseph, missouri
- st. louis, missouri
- state college, pennsylvania
- staunton, virginia
- stockton, california
- sumter, south carolina
- syracuse, new york
- tallahassee, florida
- tampa, florida
- terre haute, indiana
- texarkana, texas
- toledo, ohio
- topeka, kansas
- trenton, new jersey
- tucson, arizona
- tulsa, oklahoma
- tuscaloosa, alabama
- twin falls, idaho
- tyler, texas
- urban honolulu, hawaii
- utica, new york
- valdosta, georgia
- vallejo, california
- victoria, texas
- vineland, new jersey
- virginia beach, virginia
- visalia, california
- waco, texas
- walla walla, washington
- warner robins, georgia
- waterloo, iowa
- watertown, new york
- wausau, wisconsin
- weirton, west virginia
- wenatchee, washington
- wheeling, west virginia
- wichita falls, texas
- wichita, kansas
- williamsport, pennsylvania
- wilmington, north carolina
- winchester, virginia
- worcester, massachusetts
- yakima, washington
- york, pennsylvania
- youngstown, ohio
- yuba city, california
- yuma, arizona
description: Company metro area
region:
type: string
description: Company region
country:
type: string
enum:
- afghanistan
- albania
- algeria
- american samoa
- andorra
- angola
- anguilla
- antarctica
- antigua and barbuda
- argentina
- armenia
- aruba
- australia
- austria
- azerbaijan
- bahamas
- bahrain
- bangladesh
- barbados
- belarus
- belgium
- belize
- benin
- bermuda
- bhutan
- bolivia
- bosnia and herzegovina
- botswana
- bouvet island
- brazil
- british indian ocean territory
- british virgin islands
- brunei
- bulgaria
- burkina faso
- burundi
- cambodia
- cameroon
- canada
- cape verde
- caribbean netherlands
- cayman islands
- central african republic
- chad
- chile
- china
- christmas island
- cocos (keeling) islands
- colombia
- comoros
- cook islands
- costa rica
- croatia
- cuba
- curaçao
- cyprus
- czechia
- democratic republic of the congo
- denmark
- djibouti
- dominica
- dominican republic
- ecuador
- egypt
- el salvador
- equatorial guinea
- eritrea
- estonia
- ethiopia
- falkland islands
- faroe islands
- fiji
- finland
- france
- french guiana
- french polynesia
- french southern territories
- gabon
- gambia
- georgia
- germany
- ghana
- gibraltar
- greece
- greenland
- grenada
- guadeloupe
- guam
- guatemala
- guernsey
- guinea
- guinea-bissau
- guyana
- haiti
- heard island and mcdonald islands
- honduras
- hong kong
- hungary
- iceland
- india
- indonesia
- iran
- iraq
- ireland
- isle of man
- israel
- italy
- ivory coast
- jamaica
- japan
- jersey
- jordan
- kazakhstan
- kenya
- kiribati
- kosovo
- kuwait
- kyrgyzstan
- laos
- latvia
- lebanon
- lesotho
- liberia
- libya
- liechtenstein
- lithuania
- luxembourg
- macau
- macedonia
- madagascar
- malawi
- malaysia
- maldives
- mali
- malta
- marshall islands
- martinique
- mauritania
- mauritius
- mayotte
- mexico
- micronesia
- moldova
- monaco
- mongolia
- montenegro
- montserrat
- morocco
- mozambique
- myanmar
- namibia
- nauru
- nepal
- netherlands
- netherlands antilles
- new caledonia
- new zealand
- nicaragua
- niger
- nigeria
- niue
- norfolk island
- north korea
- northern mariana islands
- norway
- oman
- pakistan
- palau
- palestine
- panama
- papua new guinea
- paraguay
- peru
- philippines
- pitcairn
- poland
- portugal
- puerto rico
# --- truncated at 32 KB (273 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/peopledatalabs/refs/heads/main/openapi/peopledatalabs-openapi.yml