Person Search Endpoint
Cost3 credits / Profile URLSearch for people who meet a set of criteria within our exhaustive dataset of people profiles.
This API endpoint can return at most 10,000,000 results per search.
Each search expression for a parameter is limited to a maximum of 255 characters. Search expressions follow the Boolean Search Syntax.
Authorization
BearerAuth clientIn: header
Scope: client
Query Parameters
Filter people located in this country. This parameter accepts a case-insensitive Alpha-2 ISO3166 country code.
Filter people whose first names match the provided search expression.
Filter people whose last names match the provided search expression.
Filter people with a field of study matching the provided search expression, based on education history.
Filter people who earned a degree matching the provided search expression, based on education history.
Filter people who have attended a school whose name matches the provided search expression, based on education history.
Filter people who have attended a school with a specific profile URL, based on education history.
Filter people who are currently working as a role whose title matches the provided search expression. You'll be looking for profiles that show a person's current job. However, keep in mind that some of these profiles may not be up-to-date, which means you might sometimes see a person's old job instead of their current job.
Filter people who have in the past worked as a role whose title matches the provided search expression.
Filter people who started their current role before this date. You'll be looking for profiles that show a person's current job. However, keep in mind that some of these profiles may not be up-to-date, which means you might sometimes see a person's old job instead of their current job. This parameter takes a ISO8601 date. Default value of this parameter is null.
Filter people who started their current role after this date. You'll be looking for profiles that show a person's current job. However, keep in mind that some of these profiles may not be up-to-date, which means you might sometimes see a person's old job instead of their current job. This parameter takes a ISO8601 date. Default value of this parameter is null.
Filter people who are currently working at a company represented by this Company Profile URL. Default value of this parameter is null.
Filter people who have in the past worked at the company represented by this Company Profile URL. This parameter takes a Company Profile URL. Default value of this parameter is null.
Filter people with current job descriptions matching the provided search expression.
Filter people with past job descriptions matching the provided search expression.
Filter people who are currently working at a company whose name matches the provided search expression.
Filter people who have previously worked at a company whose name matches the provided search expression.
Filter people who are members of groups whose names match the provided search expression.
Filter people who list a language matching the provided search expression.
Filter people located in a region matching the provided search expression. A “region” in this context means “state,” “province,” or similar political division, depending on what country you’re querying.
Filter people located in a city matching the provided search expression.
Filter people whose headline fields match the provided search expression.
Filter people whose summary fields match the provided search expression.
Person's inferred industry. May sometimes exist when current_company_industry does not, but current_company_industry should be preferred when it exists.
Filter people whose interest fields match the provided search expression.
Filter people whose skill fields match the provided search expression.
Filter people who are currently working at a company with an office based in this country. This parameter accepts a case-insensitive Alpha-2 ISO3166 country code.
Filter people who are currently working at a company based in a region matching the provided search expression.
Filter people who are currently working at a company based in a city matching the provided search expression.
Filter people who are currently working at a company of the provided type.
Possible values:
EDUCATIONAL: Educational InstitutionGOVERNMENT_AGENCY: Government AgencyNON_PROFIT: NonprofitPARTNERSHIP: PartnershipPRIVATELY_HELD: Privately HeldPUBLIC_COMPANY: Public CompanySELF_EMPLOYED: Self-EmployedSELF_OWNED: Sole Proprietorship
Filter people who are currently working at a company with a follower count of more than this value.
Filter people who are currently working at a company with a follower count less than this value.
Filter people who are currently working at a company belonging to an industry that matches the provided search expression. The industry attribute, found in a Company profile, describes the primary industry in which the company operates. The value of this attribute is an enumerator. See the full list of possible values for this attribute. We also infer a company's industry from various attributes. For example, the primary industry for https://www.linkedin.com/company/apple may be Computers and Electronics Manufacturing, but we may also classify it under Software Development. If you want to filter by the primary industry only, please refer to the current_company_primary_industry parameter.
Filter people who are currently working at a company belonging to an industry that matches the provided search expression. The industry attribute, found in a Company profile, describes the primary industry in which the company operates. The value of this attribute is an enumerator. See the full list of possible values for this attribute.
Filter people who are currently working at a company with at least this many employees.
Filter people who are currently working at a company with at most this many employees.
Filter people who are currently working at a company with a description matching the provided search expression.
Filter people who are currently working at a company that was founded after this year.
Filter people who are currently working at a company that was founded before this year.
Filter people who are currently working at a company that has raised at least this much (USD) funding amount.
Filter people who are currently working at a company that has raised at most this much (USD) funding amount.
Filter people who are currently working at a company that has raised funding after this date.
Filter people who are currently working at a company that has raised funding before this date.
Filter people who are currently working at a company with a domain name matching the provided search expression.
A list of public identifiers (the identifying portion of the person’s profile URL). The target person’s identifier must be a member of this list.
A list of public identifiers (the identifying portion of the person’s profile URL). The target person’s identifier must not be a member of this list.
Tune the maximum results returned per API call. The default value of this parameter is 100. Accepted values for this parameter is an integer ranging from 1 to 100. When enrich_profiles=enrich, this parameter accepts value ranging from 1 to 10.
Filter people with a follower count of more than this value.
Filter people with a follower count less than this value.
Get the person's complete profile data rather than just the URLs to their profiles.
Each request respond with a streaming response of profiles.
The valid values are:
skip(default): lists person's profile url onlyenrich: include person's profile data in the list
Calling this API endpoint with this parameter would add 1 credit per enriched result returned. A profile returned without enrichment will not incur any per-profile charges.
Define the freshness guarantee on the results returned. This parameter accepts the following values: if-present (default value) - Returns result as it is without any freshness guarantee if-recent - Will make a best effort to return results of profiles no older than 29 days. Costs 1 extra credit per result on top of the base cost of the endpoint for users on the Growth or larger subscription. For all other users, it will cost 2 extra credits per result on top of the base cost of the endpoint. Note: If usecache=if-recent, pagesize is limited to a value of 10 or smaller.
Response Body
application/json
curl -X GET "https://enrichlayer.com/api/v2/search/person?country=US&first_name=Bill+OR+Mark&last_name=Gates+or+Zuckerberg&education_field_of_study=computer+science&education_degree_name=MBA&education_school_name=%22Harvard+University%22&education_school_profile_url=https%3A%2F%2Fwww.linkedin.com%2Fschool%2Fmit%2F¤t_role_title=CEO+%7C%7C+Founder&past_role_title=founder¤t_role_before=2019-12-30¤t_role_after=2019-12-30¤t_company_profile_url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fapple&past_company_profile_url=https%3A%2F%2Fwww.linkedin.com%2Fcompany%2Fapple¤t_job_description=education&past_job_description=education¤t_company_name=Stripe+OR+Apple&past_company_name=Stripe+OR+Apple&groups=haskell&languages=Mandarin+OR+Chinese®ion=California+or+Washington&city=Seattle+OR+%22Palo+Alto%22&headline=founder&summary=founder&industries=technology+and+software&interests=technology&skills=accounting¤t_company_country=US¤t_company_region=Texas¤t_company_city=Seattle+OR+%22Los+Angeles%22¤t_company_type=NON_PROFIT¤t_company_follower_count_min=100000¤t_company_follower_count_max=1000¤t_company_industry=higher+AND+education¤t_company_primary_industry=technology¤t_company_employee_count_min=1000¤t_company_employee_count_max=1000¤t_company_description=medical+device¤t_company_founded_after_year=1999¤t_company_founded_before_year=1999¤t_company_funding_amount_min=1000000¤t_company_funding_amount_max=1000000¤t_company_funding_raised_after=2019-12-30¤t_company_funding_raised_before=2019-12-30¤t_company_domain_name=pfizer.com&public_identifier_in_list=williamhgates%2Csatyanadella&public_identifier_not_in_list=mark-zuckerberg-618bba58%2Cjeff-bezos-879307323&page_size=10&follower_count_min=1000&follower_count_max=1000&enrich_profiles=enrich&use_cache=if-present"{
"results": [
{
"linkedin_profile_url": "https://www.linkedin.com/in/satyanadella",
"profile": {
"public_identifier": "satyanadella",
"profile_pic_url": "https://assets.enrichlayer.com/pp/profilepic/7d369850c9fe8c35e78a6a50c75334f5",
"background_cover_image_url": "https://assets.enrichlayer.com/pp/profilepic/fe878f911fecd238e169a23b12103b0e",
"first_name": "Satya",
"last_name": "Nadella",
"full_name": "Satya Nadella",
"follower_count": 11888127,
"occupation": "Chairman and CEO at Microsoft",
"headline": "Chairman and CEO at Microsoft",
"summary": "As chairman and CEO of Microsoft, I define my mission and that of my company as empowering every person and every organization on the planet to achieve more.",
"country": "US",
"country_full_name": "United States of America",
"city": "Redmond",
"state": "Washington",
"experiences": [
{
"starts_at": {
"day": 1,
"month": 2,
"year": 2014
},
"ends_at": null,
"company": "Microsoft",
"company_linkedin_profile_url": "https://www.linkedin.com/company/microsoft",
"company_facebook_profile_url": null,
"title": "Chairman and CEO",
"description": null,
"location": "Greater Seattle Area",
"logo_url": "https://assets.enrichlayer.com/ll/D560BAQH32RJQCl3dDQ/company-logo_100_100/B56ZYQ0mrGGoAU-/0/1744038948046/microsoft_logo?e=2147483647&v=beta&t=rr_7_bFRKp6umQxIHErPOZHtR8dMPIYeTjlKFdotJBY"
},
{
"starts_at": {
"day": 1,
"month": 1,
"year": 2018
},
"ends_at": null,
"company": "University of Chicago",
"company_linkedin_profile_url": "https://www.linkedin.com/company/uchicago",
"company_facebook_profile_url": null,
"title": "Member Board Of Trustees",
"description": null,
"location": null,
"logo_url": "https://assets.enrichlayer.com/pp/profilepic/f40c5f31ef246aeb1000ffb4e40f2991"
},
{
"starts_at": {
"day": 1,
"month": 1,
"year": 2017
},
"ends_at": {
"day": 31,
"month": 12,
"year": 2024
},
"company": "Starbucks",
"company_linkedin_profile_url": "https://www.linkedin.com/company/starbucks",
"company_facebook_profile_url": null,
"title": "Board Member",
"description": null,
"location": null,
"logo_url": "https://assets.enrichlayer.com/ll/C4D0BAQEQxk9y2rk7Hw/company-logo_100_100/company-logo_100_100/0/1631316692276?e=2147483647&v=beta&t=itdoVXP3gnqtQ7Grar4B3YoPyw-Ors9bKMZlZpb0QcY"
}
],
"education": [
{
"starts_at": {
"day": 1,
"month": 1,
"year": 1994
},
"ends_at": {
"day": 31,
"month": 12,
"year": 1996
},
"field_of_study": null,
"degree_name": null,
"school": "The University of Chicago Booth School of Business",
"school_linkedin_profile_url": "https://www.linkedin.com/company/universityofchicagoboothschoolofbusiness",
"school_facebook_profile_url": null,
"description": null,
"logo_url": "https://assets.enrichlayer.com/pp/profilepic/88fa467a62fbfc5325394253f14e8700",
"grade": null,
"activities_and_societies": null
},
{
"starts_at": {
"day": null,
"month": null,
"year": null
},
"ends_at": null,
"field_of_study": "Electrical Engineering",
"degree_name": "Bachelor’s Degree",
"school": "Manipal Institute of Technology, Manipal",
"school_linkedin_profile_url": "https://www.linkedin.com/company/manipal-institute-of-technology",
"school_facebook_profile_url": null,
"description": null,
"logo_url": "https://assets.enrichlayer.com/pp/profilepic/2aef6f72c73e3b40dbd56163897bdc04",
"grade": null,
"activities_and_societies": null
},
{
"starts_at": {
"day": null,
"month": null,
"year": null
},
"ends_at": null,
"field_of_study": "Computer Science",
"degree_name": "Master’s Degree",
"school": "University of Wisconsin-Milwaukee",
"school_linkedin_profile_url": "https://www.linkedin.com/company/uwmilwaukee",
"school_facebook_profile_url": null,
"description": null,
"logo_url": "https://assets.enrichlayer.com/pp/profilepic/7916094135030c5846f34230e03dbaa2",
"grade": null,
"activities_and_societies": null
}
],
"accomplishment_organisations": [],
"accomplishment_publications": [],
"accomplishment_honors_awards": [],
"accomplishment_patents": [],
"accomplishment_courses": [],
"accomplishment_projects": [],
"accomplishment_test_scores": [],
"volunteer_work": [],
"certifications": [],
"connections": 500,
"people_also_viewed": [
{
"link": "https://www.linkedin.com/in/kevinolearytv",
"name": "Kevin O'Leary",
"summary": "Chairman, O’Leary Ventures and Beanstox",
"location": "West Palm Beach"
},
{
"link": "https://www.linkedin.com/in/aaronmartinfc",
"name": "Aaron Martin",
"summary": "Vice President Healthcare at Amazon",
"location": "Seattle"
},
{
"link": "https://www.linkedin.com/in/guthriescott",
"name": "Scott Guthrie",
"summary": "Executive Vice President at Microsoft",
"location": "Bellevue"
},
{
"link": "https://www.linkedin.com/in/toufisaliba",
"name": "Toufi Saliba",
"summary": "Author TODA/IP . | . CEO HyperCycle.AI . | . Chair - International Protocols for AI Security IEEE",
"location": "San Francisco"
},
{
"link": "https://www.linkedin.com/in/rajeshgopinathan",
"name": "Rajesh Gopinathan",
"summary": null,
"location": "Mumbai"
}
],
"recommendations": [],
"activities": [
{
"title": "Microsoft has been positioned as a Leader for the fourteenth consecutive year in the Gartner 2021 Magic Quadrant for Analytics and Business…",
"link": null,
"activity_status": null
},
{
"title": "On March 17, we’re trying something we’ve never done before: Microsoft will host #Include2021, a free, global, digital event focused on diversity &…",
"link": null,
"activity_status": null
},
{
"title": "I talked to Bill Gates about his important new book, which provides a framework to reduce our world’s greenhouse gas emissions to zero, including…",
"link": null,
"activity_status": null
}
],
"similarly_named_profiles": [],
"articles": [],
"groups": [],
"meta": {
"thin_profile": false,
"last_updated": "2025-03-15T08:22:00Z"
}
},
"last_updated": "2023-10-26T11:34:30Z"
}
],
"next_page": null,
"total_result_count": 1
}Company Search Endpoint GET
Search for companies that meet a set of criteria within our exhaustive dataset of company profiles. This API endpoint can return at most 10,000,000 results per search. Each search expression for a parameter is limited to a maximum of 255 characters. Search expressions follow the Boolean Search Syntax.
Cost3 credits / Company URL
Disposable Email Address Check Endpoint GET
Check whether an email address belongs to a disposable email service.
Cost0 credit / successful request