GET/search/person

Person Search

Search people by role, company, location, education, skills and more. Billed per result returned: $0.0708 each, +$0.0236 with enrich_profiles=enrich, +$0.0472 with use_cache=if-recent. page_size defaults to 10 on Orthogonal (max 100; max 10 with enrich or if-recent), so a default search costs at most $0.708. x402/MPP callers prepay for the requested page_size.

Enrich Layer·Dynamic pricing

Dynamic pricing

0.0236 * count(response.results) * (3 + (query.enrich_profiles=="enrich" ? 1 : 0) + (query.use_cache=="if-recent" ? 2 : 0))

Example code

// Using @orth/sdk - The simplest way to call APIs
// Install: npm install @orth/sdk
import Orthogonal from "@orth/sdk";

const orthogonal = new Orthogonal({
  apiKey: process.env.ORTHOGONAL_API_KEY,
});

const output = await orthogonal.run({
  api: "enrich-layer",
  path: "/search/person"
});

console.log(output);

Query parameters

country

string

Filter people located in this country. This parameter accepts a case-insensitive [Alpha-2 ISO3166 country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

first_name

string

Filter people whose first names match the provided search expression.

last_name

string

Filter people whose last names match the provided search expression.

education_field_of_study

string

Filter people with a field of study matching the provided search expression, based on education history.

education_degree_name

string

Filter people who earned a degree matching the provided search expression, based on education history.

education_school_name

string

Filter people who have attended a school whose name matches the provided search expression, based on education history.

education_school_profile_url

string

Filter people who have attended a school with a specific profile URL, based on education history.

current_role_title

string

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.

past_role_title

string

Filter people who have **in the past** worked as a role whose title matches the provided search expression.

current_role_before

string

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`.

current_role_after

string

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`.

current_company_profile_url

string

Filter people who are **currently** working at a company represented by this Company Profile URL. Default value of this parameter is `null`.

past_company_profile_url

string

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`.

current_job_description

string

Filter people with **current** job descriptions matching the provided search expression.

past_job_description

string

Filter people with **past** job descriptions matching the provided search expression.

current_company_name

string

Filter people who are **currently** working at a company whose name matches the provided search expression.

past_company_name

string

Filter people who **have previously** worked at a company whose name matches the provided search expression.

groups

string

Filter people who are members of groups whose names match the provided search expression.

languages

string

Filter people who list a language matching the provided search expression.

region

string

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.

city

string

Filter people located in a city matching the provided search expression.

headline

string

Filter people whose headline fields match the provided search expression.

summary

string

Filter people whose summary fields match the provided search expression.

industries

string

Person's inferred industry. May sometimes exist when `current_company_industry` does not, but `current_company_industry` should be preferred when it exists.

interests

string

Filter people whose interest fields match the provided search expression.

skills

string

Filter people whose skill fields match the provided search expression.

skills_all_in_list

string

Filter people whose skill fields match all the skills in the list. This parameter accepts a comma-separated list of skills and returns profiles that include all the skills in the list. This parameter can't be combined with the `skills` parameter. Please only use one of them.

current_company_country

string

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](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2).

current_company_region

string

Filter people who are currently working at a company based in a region matching the provided search expression.

current_company_city

string

Filter people who are currently working at a company based in a city matching the provided search expression.

current_company_type

string

Filter people who are currently working at a company of the provided type. Possible values: * `EDUCATIONAL`: Educational Institution * `GOVERNMENT_AGENCY`: Government Agency * `NON_PROFIT` : Nonprofit * `PARTNERSHIP` : Partnership * `PRIVATELY_HELD` : Privately Held * `PUBLIC_COMPANY` : Public Company * `SELF_EMPLOYED` : Self-Employed * `SELF_OWNED` : Sole Proprietorship

current_company_follower_count_min

string

Filter people who are currently working at a company with a follower count of **more than** this value.

current_company_follower_count_max

string

Filter people who are currently working at a company with a follower count **less than** this value.

current_company_industry

string

Filter people whose current company's industry matches this search expression. Values come from a fixed list (https://enrichlayer.com/docs/guides/industry-values) and can be inferred, e.g. Apple may match both Computers and Electronics Manufacturing and Software Development. Use current_company_primary_industry to match the primary industry only.

current_company_primary_industry

string

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](/docs/guides/industry-values).

current_company_specialities

string

Filter people who are currently working at a company with a specialty matching the provided search expression. Please note that we use the spelling `specialities` rather than `specialties` in this document.

current_company_employee_count_category

string

Filter people who are currently working at a company in this employee count category. This parameter will take precedence over `current_company_employee_count_min` and `current_company_employee_count_max` parameters. The valid values are: - `custom` (default): uses `current_company_employee_count_min` and `current_company_employee_count_max` parameters - `startup`: 1-10 employees - `small`: 11-50 employees - `medium`: 51-250 employees - `large`: 251-1000 employees - `enterprise`: 1001+ employees

current_company_employee_count_min

string

Filter people who are currently working at a company with **at least** this many employees.

current_company_employee_count_max

string

Filter people who are currently working at a company with **at most** this many employees.

current_company_description

string

Filter people who are currently working at a company with a description matching the provided search expression.

current_company_founded_after_year

string

Filter people who are currently working at a company that was founded **after** this year.

current_company_founded_before_year

string

Filter people who are currently working at a company that was founded **before** this year.

current_company_funding_amount_min

string

Filter people who are currently working at a company that has raised **at least** this much (USD) funding amount.

current_company_funding_amount_max

string

Filter people who are currently working at a company that has raised **at most** this much (USD) funding amount.

current_company_funding_raised_after

string

Filter people who are currently working at a company that has raised funding **after** this date.

current_company_funding_raised_before

string

Filter people who are currently working at a company that has raised funding **before** this date.

current_company_domain_name

string

Filter people who are currently working at a company with a domain name matching the provided search expression.

public_identifier_in_list

string

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.

public_identifier_not_in_list

string

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.

page_size

string

Maximum results to return. Orthogonal default is 10 (Enrich Layer would default to 100). Accepted 1 to 100; limited to 10 with enrich_profiles=enrich or use_cache=if-recent. You are billed per result returned.

follower_count_min

string

Filter people with a follower count of **more than** this value.

follower_count_max

string

Filter people with a follower count **less than** this value.

enrich_profiles

string

skip (default): profile URLs only. enrich: full profile data, +$0.0236 per result; limits page_size to 10.

use_cache

string

if-present (default): no freshness guarantee. if-recent: best effort profiles no older than 29 days, +$0.0472 per result; limits page_size to 10.

next_token

string

The token for fetching the next page of results. Take the value of the `next_token` query parameter from the `next_page` URL of the previous response. When this parameter is provided, the search query is restored from the token. Filter parameters are not applied to the search, but they must still be syntactically valid, otherwise the request fails with a 400; only `page_size`, `enrich_profiles` and `use_cache` are honored.