# Enrich Layer

> Turn a name, an email address, a phone number or a website into a full picture of a person and the company they work at, and search 1.2 billion profiles to find more like them.

App · Contact Management · 15 actions. Web page: https://docs.lodol.com/docs/integrations/enrich-layer

## Actions

### Check credit balance

See how many Enrich Layer credits are left. Put this in front of a long run so a workflow can stop before it runs out halfway. Free, and costs no credits.

**Inputs**: None.

**Outputs**

- `credit_balance` (number): Credits remaining on the account.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "credit_balance": 100000,
  "status": "success"
}
```

### Check if an email is disposable

Check whether an address is a throwaway one, and whether it is from a free provider such as Gmail. Use it to screen signups before they reach your CRM. Free, and costs no credits.

**Inputs**

- Email address (`email`, text, required): The address to check.

**Outputs**

- `is_disposable` (true/false): True when the address is from a throwaway email service.
- `is_free` (true/false): True when the address is from a free provider such as Gmail or Outlook.com. A free address is not necessarily a throwaway one.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "is_disposable": false,
  "is_free": true,
  "status": "success"
}
```

### Count a company's employees

Get a company's headcount without listing anybody, for sizing an account or checking whether it fits your ideal customer profile. Costs 1 credit.

**Inputs**

- Company link (`company_profile_url`, text, required): A link to the company on LinkedIn, such as https://www.linkedin.com/company/microsoft. Only have a name or a website? Run 'Find a company' first and use the link it returns.
- Who to count (`employment_status`, text): Whether to count people still there, people who have left, or both. One of: `current` (Current employees), `past` (Past employees), `all` (Current and past employees). Default: `current`.
- Headcount as of (`as_of_date`, date): Count the company as it was on this date, to measure growth. Leave blank for today. Adds 1 credit.
- Also return the headcount on the profile (`include_listed_headcount`, true/false): Returns the figure the company itself lists, alongside the count of profiles actually found. The two differ a lot for large companies. Adds 1 credit. Default: `false`.

**Outputs**

- `employee_count` (number): How many employee profiles were found for this company.
- `listed_employee_count` (number): The headcount the company lists on its own profile, when it was asked for.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "employee_count": 3,
  "listed_employee_count": 529274,
  "status": "success"
}
```

### Enrich a company

Get everything known about a company from a link to its profile: what it does, its size, industry, headquarters, website and founding year. Costs 1 credit.

**Inputs**

- Company link (`company_profile_url`, text, required): A link to the company on LinkedIn, such as https://www.linkedin.com/company/microsoft. Only have a name or a website? Run 'Find a company' first and use the link it returns.
- Also include (`include`, list): Extra details to fetch alongside the profile. Each one is charged only when there is something to return. One or more of: `categories` (Categories (1 extra credit)), `funding_data` (Funding rounds (1 extra credit)), `exit_data` (Investment exits (1 extra credit)), `acquisitions` (Acquisitions (1 extra credit)), `extra` (Crunchbase rank, contact details, IPO status and investors (1 extra credit)).
- Data freshness (`freshness`, text): How recent the data has to be, and what that costs on top of the 1 credit the call itself takes. One of: `cached` (Whatever is on file (cheapest)), `recent` (Refreshed if over 29 days old (1 extra credit)), `live` (Fetched live now (9 extra credits)). Default: `recent`.

**Outputs**

- `company` (object): The company's profile. The fields named here are the ones workflows usually thread onwards; the full profile is passed through, including locations, similar companies, updates, and anything asked for under 'Also include'.
- `found` (true/false): Whether a match was found. Enrich Layer answers a lookup with an empty record rather than an error when it knows nobody, so branch on this.
- `name` (text): The company's name, for convenience.
- `status` (text): Status of the action execution ("success" on success).
- `website` (text): The company's website, for convenience.

**Example output**

```json
{
  "company": {
    "company_size": [
      10001,
      null
    ],
    "company_type": "PUBLIC_COMPANY",
    "founded_year": 1975,
    "industry": "Software Development",
    "name": "Microsoft",
    "universal_name_id": "microsoft",
    "website": "https://news.microsoft.com/"
  },
  "found": true,
  "name": "Microsoft",
  "status": "success",
  "website": "https://news.microsoft.com/"
}
```

### Enrich a person

Get everything known about a person from a link to their profile: their name, job, employer, location, work history and education. Costs 1 credit.

**Inputs**

- Profile link (`profile_url`, text, required): A link to the person, from LinkedIn, X (Twitter) or Facebook. Paste whichever you have, such as https://www.linkedin.com/in/williamhgates.
- Also include (`include`, list): Extra details to fetch alongside the profile. Each one is charged only when there is something to return. One or more of: `extra` (Gender, birth date, industry and interests (1 extra credit)), `personal_email` (Personal email addresses (1 extra credit per address)), `personal_contact_number` (Personal phone numbers (1 extra credit per number)), `inferred_salary` (Inferred salary range (1 extra credit)), `skills` (Skills (no extra credits)), `github_profile_id` (GitHub profile (1 extra credit)), `facebook_profile_id` (Facebook profile (1 extra credit)), `twitter_profile_id` (X (Twitter) profile (1 extra credit)).
- Data freshness (`freshness`, text): How recent the data has to be, and what that costs on top of the 1 credit the call itself takes. One of: `cached` (Whatever is on file (cheapest)), `recent` (Refreshed if over 29 days old (1 extra credit)), `live` (Fetched live now (9 extra credits)). Default: `recent`.

**Outputs**

- `found` (true/false): Whether a match was found. Enrich Layer answers a lookup with an empty record rather than an error when it knows nobody, so branch on this.
- `full_name` (text): The person's full name, for convenience.
- `occupation` (text): Their current role, for convenience.
- `profile` (object): The person's profile. The fields named here are the ones workflows usually thread onwards; the full profile is passed through, including accomplishments, certifications, groups, and anything asked for under 'Also include'.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "found": true,
  "full_name": "Bill Gates",
  "occupation": "Co-chair at Bill & Melinda Gates Foundation",
  "profile": {
    "city": "Seattle",
    "country_full_name": "United States",
    "first_name": "Bill",
    "follower_count": 35000000,
    "full_name": "Bill Gates",
    "headline": "Co-chair, Bill & Melinda Gates Foundation",
    "last_name": "Gates",
    "occupation": "Co-chair at Bill & Melinda Gates Foundation",
    "public_identifier": "williamhgates",
    "state": "Washington"
  },
  "status": "success"
}
```

### Find a company

Find a company's profile from its name or its website. Use this to turn a lead's email domain into a company link. Costs 2 credits.

**Inputs**

- Company name (`company_name`, text): The company's name. Give this or the website; the website matches more reliably.
- Company website (`company_domain`, text): The company's website or domain, such as microsoft.com.
- Country (`country`, text): Where the company is based, to tell apart companies that share a name. One of: `AF` (Afghanistan), `AX` (Åland Islands), `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua & Barbuda), `AR` (Argentina), and 239 more.
- Include the full profile (`include_profile`, true/false): Return the whole profile rather than just the link to it, saving a follow-up 'Enrich' step. Adds 1 credit, and the profile comes from our records rather than being refreshed. Default: `false`.

**Outputs**

- `company` (object): The company's profile. The fields named here are the ones workflows usually thread onwards; the full profile is passed through, including locations, similar companies, updates, and anything asked for under 'Also include'.
- `company_profile_url` (text): The matched company's profile URL, which the other company actions take. Empty when nothing matched.
- `found` (true/false): Whether a match was found. Enrich Layer answers a lookup with an empty record rather than an error when it knows nobody, so branch on this.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "company": {},
  "company_profile_url": "https://www.linkedin.com/company/microsoft",
  "found": true,
  "status": "success"
}
```

### Find a person by email address

Find whose profile an email address belongs to. Works with both work and personal addresses. Costs 3 credits.

**Inputs**

- Email address (`email`, text, required): The address to look up.
- How hard to look (`lookup_depth`, text): Searching everywhere finds far more, especially for work addresses, and is charged whether or not it finds anybody. One of: `deep` (Search everywhere (best for work addresses)), `superficial` (Search our records only (free when nothing is found)). Default: `deep`.
- Include the full profile (`include_profile`, true/false): Return the whole profile rather than just the link to it, saving a follow-up 'Enrich' step. Adds 1 credit, and the profile comes from our records rather than being refreshed. Default: `false`.

**Outputs**

- `facebook_profile_url` (text): Their Facebook profile, when known.
- `found` (true/false): Whether a match was found. Enrich Layer answers a lookup with an empty record rather than an error when it knows nobody, so branch on this.
- `profile` (object): The person's profile. The fields named here are the ones workflows usually thread onwards; the full profile is passed through, including accomplishments, certifications, groups, and anything asked for under 'Also include'.
- `profile_url` (text): The matched person's LinkedIn profile URL, which 'Enrich a person' takes. Empty when nobody matched.
- `similarity_score` (number): How closely the match resembles what was asked for, from 0 to 1. Empty when there was nothing to compare against.
- `status` (text): Status of the action execution ("success" on success).
- `twitter_profile_url` (text): Their X (Twitter) profile, when known.

**Example output**

```json
{
  "facebook_profile_url": "",
  "found": true,
  "profile": {},
  "profile_url": "https://www.linkedin.com/in/satyanadella",
  "similarity_score": 0.95,
  "status": "success",
  "twitter_profile_url": ""
}
```

### Find a person by name and employer

Find someone's profile from their name and where they work. Use this to turn a row in a spreadsheet or a CRM into a profile link. Costs 2 credits.

**Inputs**

- First name (`first_name`, text, required): The person's first name.
- Last name (`last_name`, text): The person's last name, if you have it.
- Company (`company`, text, required): Where they work, as a name or a website, such as Microsoft or microsoft.com.
- Job title (`title`, text): Their job title, if you have it. Narrows the match when several people share a name at one company.
- Location (`location`, text): A country, state or city they are based in, if you have it.
- Only return confident matches (`confident_matches_only`, true/false): On: a result whose name or employer does not really match is thrown away, so you get nothing rather than the wrong person. The 2 credits are charged either way. Off: you get the closest match however poor, and nothing is charged when there is no match at all. Default: `true`.
- Include the full profile (`include_profile`, true/false): Return the whole profile rather than just the link to it, saving a follow-up 'Enrich' step. Adds 1 credit, and the profile comes from our records rather than being refreshed. Default: `false`.

**Outputs**

- `company_similarity_score` (number): How closely the match resembles what was asked for, from 0 to 1. Empty when there was nothing to compare against.
- `found` (true/false): Whether a match was found. Enrich Layer answers a lookup with an empty record rather than an error when it knows nobody, so branch on this.
- `name_similarity_score` (number): How closely the match resembles what was asked for, from 0 to 1. Empty when there was nothing to compare against.
- `profile` (object): The person's profile. The fields named here are the ones workflows usually thread onwards; the full profile is passed through, including accomplishments, certifications, groups, and anything asked for under 'Also include'.
- `profile_url` (text): The matched person's profile URL, which 'Enrich a person' takes. Empty when nobody matched.
- `status` (text): Status of the action execution ("success" on success).
- `title_similarity_score` (number): How closely the match resembles what was asked for, from 0 to 1. Empty when there was nothing to compare against.

**Example output**

```json
{
  "company_similarity_score": 1.0,
  "found": true,
  "name_similarity_score": 1.0,
  "profile": {},
  "profile_url": "https://www.linkedin.com/in/satyanadella",
  "status": "success",
  "title_similarity_score": 0.9
}
```

### Find a person by phone number

Find whose profiles a phone number belongs to, for putting a name to an inbound call or an unlabelled CRM row. Costs 3 credits.

**Inputs**

- Phone number (`phone_number`, text, required): Include the country code, such as +14155550123. Spaces, brackets and dashes are fine.

**Outputs**

- `facebook_profile_url` (text): Their Facebook profile, when known.
- `found` (true/false): Whether a match was found. Enrich Layer answers a lookup with an empty record rather than an error when it knows nobody, so branch on this.
- `profile_url` (text): The matched person's LinkedIn profile URL, which 'Enrich a person' takes. Empty when nobody matched.
- `status` (text): Status of the action execution ("success" on success).
- `twitter_profile_url` (text): Their X (Twitter) profile, when known.

**Example output**

```json
{
  "facebook_profile_url": "",
  "found": true,
  "profile_url": "https://www.linkedin.com/in/satyanadella",
  "status": "success",
  "twitter_profile_url": ""
}
```

### Find personal email addresses

Find the personal email addresses behind a profile. Costs 1 credit per address returned, and nothing when there are none.

**Inputs**

- Profile link (`profile_url`, text, required): A link to the person, from LinkedIn, X (Twitter) or Facebook. Paste whichever you have, such as https://www.linkedin.com/in/williamhgates.
- Check the addresses work (`email_validation`, text): Whether to verify each address before returning it. Anything rejected comes back separately rather than being dropped. One of: `none` (Do not check (no extra credits)), `fast` (Quick format check (no extra credits)), `precise` (Check it can receive mail (1 extra credit per address)). Default: `none`.
- Most to return (`max_results`, number): Caps how many addresses come back, and so what the call costs. Leave blank for all of them. From 1 to 100.

**Outputs**

- `count` (number): How many email addresses were returned.
- `emails` (list): The personal email addresses found.
- `found` (true/false): Whether a match was found. Enrich Layer answers a lookup with an empty record rather than an error when it knows nobody, so branch on this.
- `invalid_emails` (list): Addresses that failed the check, when one was asked for.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "count": 1,
  "emails": [
    "someone@example.com"
  ],
  "found": true,
  "invalid_emails": [],
  "status": "success"
}
```

### Find personal phone numbers

Find the personal phone numbers behind a profile. Costs 1 credit per number returned, and nothing when there are none.

**Inputs**

- Profile link (`profile_url`, text, required): A link to the person, from LinkedIn, X (Twitter) or Facebook. Paste whichever you have, such as https://www.linkedin.com/in/williamhgates.
- Most to return (`max_results`, number): Caps how many numbers come back, and so what the call costs. Leave blank for all of them. From 1 to 100.

**Outputs**

- `count` (number): How many phone numbers were returned.
- `found` (true/false): Whether a match was found. Enrich Layer answers a lookup with an empty record rather than an error when it knows nobody, so branch on this.
- `phone_numbers` (list): The personal phone numbers found.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "count": 1,
  "found": true,
  "phone_numbers": [
    "+14155550123"
  ],
  "status": "success"
}
```

### Find who holds a role at a company

Find the person who best matches a role at a company, such as the CTO of Apple. Returns the single closest match. Costs 3 credits.

**Inputs**

- Role (`role`, text, required): The role to find, such as CTO, Head of Sales or Chief Marketing Officer.
- Company name (`company_name`, text, required): The company to look inside, such as Apple.
- Include the full profile (`include_profile`, true/false): Return the whole profile rather than just the link to it, saving a follow-up 'Enrich' step. Adds 1 credit, and the profile comes from our records rather than being refreshed. Default: `false`.

**Outputs**

- `found` (true/false): Whether a match was found. Enrich Layer answers a lookup with an empty record rather than an error when it knows nobody, so branch on this.
- `profile` (object): The person's profile. The fields named here are the ones workflows usually thread onwards; the full profile is passed through, including accomplishments, certifications, groups, and anything asked for under 'Also include'.
- `profile_url` (text): The matched person's profile URL, which 'Enrich a person' takes. Empty when nobody matched.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "found": true,
  "profile": {},
  "profile_url": "https://www.linkedin.com/in/satyanadella",
  "status": "success"
}
```

### List a company's employees

List the people who work at a company, optionally narrowed to a job title or a country. Costs 3 credits per employee returned.

**Inputs**

- Company link (`company_profile_url`, text, required): A link to the company on LinkedIn, such as https://www.linkedin.com/company/microsoft. Only have a name or a website? Run 'Find a company' first and use the link it returns.
- Job title contains (`job_title_search`, text): Only return employees whose title matches. Accepts boolean search, so "(VP OR 'Vice President') AND sales" works. Using this raises the base cost of the call to 10 credits.
- Who to include (`employment_status`, text): Whether to list people still there, people who have left, or both. One of: `current` (Current employees), `past` (Past employees), `all` (Current and past employees). Default: `current`.
- Countries (`countries`, list): Only return employees based in these countries. Choose none for all of them. Adds 3 credits per employee returned. One or more of: `AF` (Afghanistan), `AX` (Åland Islands), `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua & Barbuda), `AR` (Argentina), and 239 more.
- Order (`sort_by`, text): Anything other than 'No particular order' adds 50 credits to the call and 10 more per employee returned, so leave it alone unless recency is the point of the list. One of: `none` (No particular order (no extra credits)), `recently-joined` (Most recently joined first), `recently-left` (Most recently left first), `oldest` (Longest-serving first). Default: `none`.
- Include full profiles (`include_profiles`, true/false): Return each result's whole profile rather than just the link to it. Adds 1 credit per result, and caps a page at 10. Default: `false`.
- Employees per page (`page_size`, number): How many to return, from 1 to 9999 (or 10 when full profiles are included). Each employee costs 3 credits, so this is the dial that decides what the call costs. From 1 to 9999. Default: `10`.
- Continue from (`next_page_token`, text): Leave blank for the first page. To get the next one, use the 'Continue from' value this action returned last time.

**Outputs**

- `count` (number): How many employees on this page were returned.
- `employees` (list): The employees on this page.
- `next_page_token` (text): Paste this into 'Continue from' to fetch the next page. Empty when this was the last page.
- `status` (text): Status of the action execution ("success" on success).

**Example output**

```json
{
  "count": 1,
  "employees": [
    {
      "last_updated": "2026-08-01T00:00:00Z",
      "profile": null,
      "profile_url": "https://www.linkedin.com/in/satyanadella"
    }
  ],
  "next_page_token": "",
  "status": "success"
}
```

### Search for companies

Build a list of companies matching what you are looking for: an industry, a size, a place, a founding year, a funding history. Costs 3 credits per company returned.

**Inputs**

- Company name (`name`, text): Words in the company's name. Accepts boolean search, so "(VP OR 'Vice President') AND sales" works.
- Website (`domain`, text): The company's domain, such as microsoft.com.
- Description contains (`description`, text): Words in how the company describes itself. Accepts boolean search, so "(VP OR 'Vice President') AND sales" works.
- Industry (`industry`, text): Such as Software Development or Hospitals and Health Care. The full list is at https://enrichlayer.com/docs/guides/industry-values. Accepts boolean search, so "(VP OR 'Vice President') AND sales" works.
- Type (`company_type`, text): What kind of organisation to return. One of: `EDUCATIONAL` (Educational institution), `GOVERNMENT_AGENCY` (Government agency), `NON_PROFIT` (Nonprofit), `PARTNERSHIP`, `PRIVATELY_HELD` (Privately held), `PUBLIC_COMPANY` (Public company), `SELF_EMPLOYED` (Self-employed), `SELF_OWNED` (Sole proprietorship).
- Size (`company_size`, text): A headcount band. Choosing one here overrides the exact minimum and maximum below. One of: `startup` (1 to 10 employees), `small` (11 to 50 employees), `medium` (51 to 250 employees), `large` (251 to 1,000 employees), `enterprise` (Over 1,000 employees).
- At least this many employees (`employee_count_min`, number): Use instead of 'Size' when you need an exact threshold. From 0 to 10000000.
- At most this many employees (`employee_count_max`, number): Use instead of 'Size' when you need an exact threshold. From 0 to 10000000.
- Country (`country`, text): Only return companies with an office in this country. One of: `AF` (Afghanistan), `AX` (Åland Islands), `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua & Barbuda), `AR` (Argentina), and 239 more.
- State or region (`region`, text): Only return companies with an office in this state, province or region.
- City (`city`, text): Only return companies with an office in this city.
- Founded after year (`founded_after_year`, number): A four-digit year, such as 2015. From 1000 to 9999.
- Founded before year (`founded_before_year`, number): A four-digit year, such as 2020. From 1000 to 9999.
- Raised funding after (`funding_raised_after`, date): Only return companies that raised money after this date. Good for catching newly funded accounts.
- Raised funding before (`funding_raised_before`, date): Only return companies that raised money before this date.
- Include full profiles (`include_profiles`, true/false): Return each result's whole profile rather than just the link to it. Adds 1 credit per result, and caps a page at 10. Default: `false`.
- Results per page (`page_size`, number): How many to return, from 1 to 100 (or 10 when full profiles are included). Each result costs 3 credits, so this is the dial that decides what a search costs. From 1 to 100. Default: `10`.
- Continue from (`next_page_token`, text): Leave blank for the first page. To get the next one, use the 'Continue from' value this action returned last time.

**Outputs**

- `companies` (list): The companies on this page of results.
- `count` (number): How many companies on this page were returned.
- `next_page_token` (text): Paste this into 'Continue from' to fetch the next page. Empty when this was the last page.
- `status` (text): Status of the action execution ("success" on success).
- `total_matches` (number): How many companies matched in total.

**Example output**

```json
{
  "companies": [
    {
      "last_updated": "2026-08-01T00:00:00Z",
      "linkedin_profile_url": "https://www.linkedin.com/company/microsoft",
      "profile": null
    }
  ],
  "count": 1,
  "next_page_token": "",
  "status": "success",
  "total_matches": 1204
}
```

### Search for people

Build a list of people matching what you are looking for: a job title, an employer, an industry, a place, a school. Costs 3 credits per person returned.

**Inputs**

- Current job title (`current_job_title`, text): Job title they hold now, such as Head of Marketing. Accepts boolean search, so "(VP OR 'Vice President') AND sales" works.
- Past job title (`past_job_title`, text): A job title they held before. Accepts boolean search, so "(VP OR 'Vice President') AND sales" works.
- Current employer (`current_company_name`, text): Name of the company they work at now. Accepts boolean search, so "(VP OR 'Vice President') AND sales" works.
- Current employer's website (`current_company_domain`, text): The employer's domain, such as microsoft.com. More exact than the name when several companies share one.
- Current employer's industry (`current_company_industry`, text): Such as Software Development or Hospitals and Health Care. The full list is at https://enrichlayer.com/docs/guides/industry-values. Accepts boolean search, so "(VP OR 'Vice President') AND sales" works.
- Current employer's size (`current_company_size`, text): How big the company they work at is. One of: `startup` (1 to 10 employees), `small` (11 to 50 employees), `medium` (51 to 250 employees), `large` (251 to 1,000 employees), `enterprise` (Over 1,000 employees).
- Current employer's type (`current_company_type`, text): What kind of organisation they work for. One of: `EDUCATIONAL` (Educational institution), `GOVERNMENT_AGENCY` (Government agency), `NON_PROFIT` (Nonprofit), `PARTNERSHIP`, `PRIVATELY_HELD` (Privately held), `PUBLIC_COMPANY` (Public company), `SELF_EMPLOYED` (Self-employed), `SELF_OWNED` (Sole proprietorship).
- Country (`country`, text): Only return people based in this country. One of: `AF` (Afghanistan), `AX` (Åland Islands), `AL` (Albania), `DZ` (Algeria), `AD` (Andorra), `AO` (Angola), `AI` (Anguilla), `AQ` (Antarctica), `AG` (Antigua & Barbuda), `AR` (Argentina), and 239 more.
- State or region (`region`, text): Only return people in this state, province or region, such as California.
- City (`city`, text): Only return people in this city.
- Headline (`headline`, text): Words in the headline under their name. Accepts boolean search, so "(VP OR 'Vice President') AND sales" works.
- Skills (`skills`, text): Skills listed on their profile. Accepts boolean search, so "(VP OR 'Vice President') AND sales" works.
- School attended (`school_name`, text): Name of a school, college or university they went to.
- Field of study (`field_of_study`, text): What they studied, such as Computer Science.
- Started current role after (`started_current_role_after`, date): Only return people who began their current job after this date. Good for catching people who have just moved into a role.
- Started current role before (`started_current_role_before`, date): Only return people who began their current job before this date.
- Include full profiles (`include_profiles`, true/false): Return each result's whole profile rather than just the link to it. Adds 1 credit per result, and caps a page at 10. Default: `false`.
- Results per page (`page_size`, number): How many to return, from 1 to 100 (or 10 when full profiles are included). Each result costs 3 credits, so this is the dial that decides what a search costs. From 1 to 100. Default: `10`.
- Continue from (`next_page_token`, text): Leave blank for the first page. To get the next one, use the 'Continue from' value this action returned last time.

**Outputs**

- `count` (number): How many people on this page were returned.
- `next_page_token` (text): Paste this into 'Continue from' to fetch the next page. Empty when this was the last page.
- `people` (list): The people on this page of results.
- `status` (text): Status of the action execution ("success" on success).
- `total_matches` (number): How many people matched in total.

**Example output**

```json
{
  "count": 1,
  "next_page_token": "",
  "people": [
    {
      "last_updated": "2026-08-01T00:00:00Z",
      "linkedin_profile_url": "https://www.linkedin.com/in/satyanadella",
      "profile": null
    }
  ],
  "status": "success",
  "total_matches": 428
}
```
