# Lusha

> Find and enrich B2B contacts and companies with Lusha: get verified emails and phone numbers, search Lusha's database by job, industry and size, find lookalikes and buying groups, track job changes, company signals and website visitors, and score accounts.

App · 22 actions. Web page: https://docs.lodol.com/docs/integrations/lusha

## Actions

### Enrich a company

Get a company's full profile by domain, name or Lusha id: description, size, revenue, industry codes, locations, funding and technologies, plus any extra details you choose. Costs credits per company, and per extra detail.

**Inputs**

- Domain (`domain`, text): The company's website domain, such as acme.com. A full address works too.
- Company name (`name`, text): The company's name. A domain finds it more surely.
- Lusha company ID (`company_id`, text): Lusha's id for the company, from an earlier Lusha step.
- Extra details (`extra_details`, list): Breakdowns to add to the profile, each costing extra credits. Leave empty for the standard profile. One or more of: `employeesByDepartment` (Employees by department), `employeesBySeniority` (Employees by seniority), `employeesByLocation` (Employees by location), `competitors`, `intent` (Buyer intent topics), `openJobsTotal` (Open jobs), `openJobsByDepartment` (Open jobs by department), `openJobsByLocation` (Open jobs by location), `openJobsBySeniority` (Open jobs by seniority), `estimatedAnnualItSpend` (Estimated IT spend), and 3 more.

**Outputs**

- `company` (object): The company's full profile
- `credits_charged` (number): Lusha credits this step spent
- `found` (true/false): Whether Lusha found a match

**Example output**

```json
{
  "company": {
    "business_models": [
      "B2B"
    ],
    "city": "Boston",
    "company_type": "Private Company",
    "competitors": [
      {
        "domain": "clearbit.com",
        "id": "2497917",
        "name": "Clearbit"
      }
    ],
    "country": "United States",
    "country_code": "US",
    "description": "Lusha is a sales intelligence platform.",
    "domain": "www.lusha.com",
    "email": "support@lusha.com",
    "employees": 364,
    "employees_by_department": [
      {
        "count": 72,
        "name": "Sales"
      }
    ],
    "employees_by_location": [
      {
        "count": 301,
        "country": "Israel",
        "state": ""
      }
    ],
    "employees_by_seniority": [
      {
        "count": 141,
        "name": "Manager"
      }
    ],
    "employees_max": 500,
    "employees_min": 201,
    "error": "",
    "error_message": "",
    "facebook_url": "https://www.facebook.com/lusha",
    "funding": {
      "currency": "USD",
      "is_public": false,
      "last_round_amount": 205000000,
      "last_round_date": "Nov 10, 2021",
      "last_round_type": "Private Equity Round",
      "rounds": [
        {
          "amount": 205000000,
          "currency": "USD",
          "date": "Nov 10, 2021",
          "type": "Private Equity Round"
        }
      ],
      "rounds_count": 2,
      "total": 245000000
    },
    "id": "16303253",
    "industry": "Technology, Information & Media",
    "intent_topics": [
      {
        "score": 85,
        "topic": "Sales Intelligence",
        "trend": "+24"
      }
    ],
    "it_spend_usd": null,
    "keywords": [],
    "linkedin_followers": 64339,
    "linkedin_url": "https://www.linkedin.com/company/lushadata",
    "logo_url": "https://logo.lusha.co/lusha.jpg",
    "monthly_website_visits": null,
    "naics_codes": [
      {
        "code": "541511",
        "description": "Custom Computer Programming Services"
      }
    ],
    "name": "Lusha",
    "offering": "",
    "open_jobs": {
      "by_department": [
        {
          "count": 21,
          "name": "Engineering & Technical"
        }
      ],
      "by_location": [],
      "by_seniority": [],
      "total": 47
    },
    "other_domains": [
      "lusha.com"
    ],
    "parent": {
      "country": "",
      "domain": "",
      "id": "",
      "name": ""
    },
    "phone": "",
    "revenue_max": null,
    "revenue_min": null,
    "sic_codes": [
      {
        "code": "7371",
        "description": "Custom computer programming services"
      }
    ],
    "specialities": [
      "lead generation",
      "sales intelligence"
    ],
    "state": "Massachusetts",
    "sub_industry": "Software Development",
    "technologies": [
      "amazon",
      "google analytics"
    ],
    "ultimate_parent": {
      "country": "",
      "domain": "",
      "id": "",
      "name": ""
    },
    "x_url": "https://x.com/lusha",
    "year_founded": 2016,
    "zip_code": "02199"
  },
  "credits_charged": 2,
  "found": true
}
```

### Enrich a contact

Find someone by email, LinkedIn profile, Lusha id, or name and company, and get their emails and phone numbers with their job, company and history. Costs a search credit plus credits for each email and phone revealed.

**Inputs**

- Email (`email`, text): Their email address. The surest way to find someone.
- LinkedIn profile (`linkedin_url`, text): The address of their LinkedIn profile.
- First name (`first_name`, text): Their first name. Give it with Last name and Company.
- Last name (`last_name`, text): Their last name. Give it with First name and Company.
- Company (`company`, text): Where they work: the company's name or website domain (acme.com). Give it with First name and Last name.
- Lusha contact ID (`contact_id`, text): Lusha's id for the contact, from an earlier Lusha step.
- Reveal (`reveal`, list): What to unlock. Leave empty for both. Each email or phone revealed costs credits, phones more than emails. One or more of: `emails` (Email addresses), `phones` (Phone numbers).

**Outputs**

- `contact` (object): The contact, with emails and phones
- `credits_charged` (number): Lusha credits this step spent
- `found` (true/false): Whether Lusha found a match

**Example output**

```json
{
  "contact": {
    "city": "Tel Aviv",
    "company_domain": "www.lusha.com",
    "company_id": "16303253",
    "company_industry": "Technology, Information & Media",
    "company_name": "Lusha",
    "country": "Israel",
    "country_code": "IL",
    "departments": [
      "Product"
    ],
    "email": "daniel.t@lusha.com",
    "emails": [
      {
        "confidence": "A+",
        "email": "daniel.t@lusha.com",
        "type": "work"
      }
    ],
    "error": "",
    "error_message": "",
    "first_name": "Daniel",
    "full_name": "Daniel Turgeman",
    "id": "4389064654",
    "is_eu_contact": false,
    "job_title": "Technical Product Manager",
    "last_name": "Turgeman",
    "linkedin_followers": 812,
    "linkedin_url": "https://www.linkedin.com/in/daniel-turgeman",
    "partial_profile": false,
    "phone": "+972 52 000 0000",
    "phones": [
      {
        "do_not_call": false,
        "number": "+972 52 000 0000",
        "type": "mobile"
      }
    ],
    "previous_jobs": [
      {
        "company_domain": "wix.com",
        "company_name": "Wix",
        "job_title": "Product Manager"
      }
    ],
    "seniority": "Manager",
    "skills": [
      "Product Management"
    ],
    "state": "",
    "still_missing": [],
    "tags": [
      "Customer"
    ],
    "updated": "2026-04-23",
    "x_url": ""
  },
  "credits_charged": 2,
  "found": true
}
```

### Find a company

Look a company up by domain, name or Lusha id, and see its size, industry and location and what Lusha holds on it. Costs 1 search credit when found.

**Inputs**

- Domain (`domain`, text): The company's website domain, such as acme.com. A full address works too.
- Company name (`name`, text): The company's name. A domain finds it more surely.
- Lusha company ID (`company_id`, text): Lusha's id for the company, from an earlier Lusha step.

**Outputs**

- `company` (object): The company, if found
- `credits_charged` (number): Lusha credits this step spent
- `found` (true/false): Whether Lusha found a match

**Example output**

```json
{
  "company": {
    "available_data": [
      "description",
      "funding",
      "employeesByDepartment",
      "competitors"
    ],
    "city": "Boston",
    "country": "United States",
    "country_code": "US",
    "domain": "www.lusha.com",
    "employees": 364,
    "employees_max": 500,
    "employees_min": 201,
    "error": "",
    "error_message": "",
    "id": "16303253",
    "industry": "Technology, Information & Media",
    "linkedin_url": "https://www.linkedin.com/company/lushadata",
    "name": "Lusha",
    "signal_types": [],
    "state": "Massachusetts"
  },
  "credits_charged": 1,
  "found": true
}
```

### Find a contact

Look someone up by email, LinkedIn profile, Lusha id, or name and company, and see their job and company and what Lusha can reveal, without spending reveal credits. Costs 1 search credit when found.

**Inputs**

- Email (`email`, text): Their email address. The surest way to find someone.
- LinkedIn profile (`linkedin_url`, text): The address of their LinkedIn profile.
- First name (`first_name`, text): Their first name. Give it with Last name and Company.
- Last name (`last_name`, text): Their last name. Give it with First name and Company.
- Company (`company`, text): Where they work: the company's name or website domain (acme.com). Give it with First name and Last name.
- Lusha contact ID (`contact_id`, text): Lusha's id for the contact, from an earlier Lusha step.

**Outputs**

- `contact` (object): The contact, if found
- `credits_charged` (number): Lusha credits this step spent
- `found` (true/false): Whether Lusha found a match

**Example output**

```json
{
  "contact": {
    "available_data": [
      "firstName",
      "lastName",
      "jobTitle",
      "emails"
    ],
    "can_reveal": [
      {
        "credits": 1,
        "field": "emails"
      }
    ],
    "city": "Tel Aviv",
    "company_domain": "www.lusha.com",
    "company_id": "16303253",
    "company_name": "Lusha",
    "country": "Israel",
    "departments": [
      "Business Development"
    ],
    "error": "",
    "error_message": "",
    "first_name": "Orit",
    "full_name": "Orit Shilvock",
    "id": "4415824633",
    "job_title": "Vice President of Partnerships",
    "last_name": "Shilvock",
    "linkedin_url": "https://www.linkedin.com/in/orit-shilvock-6243bb5",
    "seniority": "Vice President",
    "signal_types": [],
    "state": ""
  },
  "credits_charged": 1,
  "found": true
}
```

### Find similar companies

Give 5 to 100 of your best customers and get new companies of a similar size, industry and profile. Costs credits per company returned.

**Inputs**

- Example companies (`examples`, list, required): 5 to 100 companies to find more like: website domains or LinkedIn company pages, one per line or a list.
- Leave out (`leave_out`, list): Companies never to suggest, such as customers or competitors: domains or LinkedIn company pages.
- How many (`limit`, number): How many to return, 1 to 100. Defaults to 25. Each costs credits. From 1 to 100.
- More from (`more_from`, text): The session_id of an earlier run of this step, to get more results without repeating any.

**Outputs**

- `companies` (list): Similar companies
- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent
- `has_more` (true/false): Whether More from would find more
- `session_id` (text): Pass as More from to get more without repeats

**Example output**

```json
{
  "companies": [
    {
      "available_data": [
        "description",
        "funding",
        "employeesByDepartment",
        "competitors"
      ],
      "city": "Boston",
      "country": "United States",
      "country_code": "US",
      "domain": "www.lusha.com",
      "employees": 364,
      "employees_max": 500,
      "employees_min": 201,
      "error": "",
      "error_message": "",
      "id": "16303253",
      "industry": "Technology, Information & Media",
      "linkedin_url": "https://www.linkedin.com/company/lushadata",
      "name": "Lusha",
      "signal_types": [],
      "state": "Massachusetts"
    }
  ],
  "count": 1,
  "credits_charged": 1,
  "has_more": true,
  "session_id": "1f0c2b4e-8a9d-4c3b-b2a1-0e9f8d7c6b5a"
}
```

### Find similar contacts

Give 5 to 100 of your best contacts and get new people with similar roles, seniority and companies. Costs credits per person returned.

**Inputs**

- Example contacts (`examples`, list, required): 5 to 100 people to find more like: emails, LinkedIn profiles or Lusha contact ids, one per line or a list.
- Leave out (`leave_out`, list): People never to suggest, such as existing customers: emails, LinkedIn profiles or Lusha ids.
- How many (`limit`, number): How many to return, 1 to 100. Defaults to 25. Each costs credits. From 1 to 100.
- More from (`more_from`, text): The session_id of an earlier run of this step, to get more results without repeating any.

**Outputs**

- `contacts` (list): Similar contacts
- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent
- `has_more` (true/false): Whether More from would find more
- `session_id` (text): Pass as More from to get more without repeats

**Example output**

```json
{
  "contacts": [
    {
      "available_data": [
        "firstName",
        "lastName",
        "jobTitle",
        "emails"
      ],
      "can_reveal": [
        {
          "credits": 1,
          "field": "emails"
        }
      ],
      "city": "Tel Aviv",
      "company_domain": "www.lusha.com",
      "company_id": "16303253",
      "company_name": "Lusha",
      "country": "Israel",
      "departments": [
        "Business Development"
      ],
      "error": "",
      "error_message": "",
      "first_name": "Orit",
      "full_name": "Orit Shilvock",
      "id": "4415824633",
      "job_title": "Vice President of Partnerships",
      "last_name": "Shilvock",
      "linkedin_url": "https://www.linkedin.com/in/orit-shilvock-6243bb5",
      "seniority": "Vice President",
      "signal_types": [],
      "state": ""
    }
  ],
  "count": 1,
  "credits_charged": 1,
  "has_more": true,
  "session_id": "1f0c2b4e-8a9d-4c3b-b2a1-0e9f8d7c6b5a"
}
```

### Get buying group

Find the decision makers, potential champions and end users at up to 25 companies. Returns names, jobs and Lusha ids to pass to Reveal contact details. Costs credits per person returned.

**Inputs**

- Companies (`companies`, list, required): Up to 25 companies, by website domain or Lusha company id. One per line, or a list.
- Roles (`roles`, list): Which buyers to return. Leave empty for all three. One or more of: `decision_maker` (Decision makers), `potential_champion` (Potential champions), `end_user` (End users).
- Most per company (`contacts_per_company`, number): At most this many people per company. Lusha's default is 60. From 1 to 100.

**Outputs**

- `contacts` (list): The buyers, labelled with their roles
- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent
- `not_found` (list): Companies Lusha could not find

**Example output**

```json
{
  "contacts": [
    {
      "available_data": [
        "firstName",
        "lastName",
        "jobTitle",
        "emails"
      ],
      "can_reveal": [
        {
          "credits": 1,
          "field": "emails"
        }
      ],
      "city": "Tel Aviv",
      "company_domain": "www.lusha.com",
      "company_id": "16303253",
      "company_name": "Lusha",
      "country": "Israel",
      "departments": [
        "Business Development"
      ],
      "error": "",
      "error_message": "",
      "first_name": "Orit",
      "full_name": "Orit Shilvock",
      "id": "4415824633",
      "job_title": "Vice President of Partnerships",
      "last_name": "Shilvock",
      "linkedin_url": "https://www.linkedin.com/in/orit-shilvock-6243bb5",
      "relevance": 0.92,
      "roles": [
        "decision_maker"
      ],
      "seniority": "Vice President",
      "signal_types": [],
      "state": ""
    }
  ],
  "count": 1,
  "credits_charged": 1,
  "not_found": []
}
```

### Get company signals

See what is happening at up to 100 companies: hiring surges, headcount and traffic changes, IT spend, news, and the topics they are researching. Costs credits per signal found.

**Inputs**

- Companies (`company_ids`, list, required): Lusha company ids, up to 100, from Search for companies, Find a company or another Lusha step. One per line, or a list.
- Signals (`signal_types`, list): What to look for. Leave empty for everything except the four topic research changes, which must be chosen. One or more of: `surgeInHiring` (Hiring surge), `surgeInHiringByDepartment` (Hiring surge in a department), `surgeInHiringByLocation` (Hiring surge in a location), `headcountIncrease1m` (Headcount up over 1 month), `headcountIncrease3m` (Headcount up over 3 months), `headcountIncrease6m` (Headcount up over 6 months), `headcountIncrease12m` (Headcount up over 12 months), `headcountDecrease1m` (Headcount down over 1 month), `headcountDecrease3m` (Headcount down over 3 months), `headcountDecrease6m` (Headcount down over 6 months), and 17 more.
- Since (`since`, date): Only activity on or after this date.
- Most per type (`max_per_type`, number): At most this many of each kind of activity per record, 1 to 100. Each one costs credits, so a limit caps the cost. From 1 to 100.

**Outputs**

- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent
- `signals` (list): What happened, newest first

**Example output**

```json
{
  "count": 1,
  "credits_charged": 1,
  "signals": [
    {
      "company_domain": "uicinc.com",
      "company_id": "15789512",
      "company_name": "UIC Inc",
      "contact_id": "",
      "date": "2026-09-28",
      "details": {
        "category": "Other",
        "changeRatePercent": 8,
        "id": "2139910966",
        "previousScore": 60,
        "score": 65,
        "signalDate": "2026-09-28",
        "topic": "Air Cargo"
      },
      "summary": "Intent on Air Cargo up to 65 from 60",
      "type": "intentScoreIncrease"
    }
  ]
}
```

### Get contact signals

See which of up to 100 contacts were promoted or moved to a new company, and when. Costs credits per signal found.

**Inputs**

- Contacts (`contact_ids`, list, required): Lusha contact ids, up to 100, from Search for contacts, Find a contact or another Lusha step. One per line, or a list.
- Signals (`signal_types`, list): What to look for. Leave empty for both. One or more of: `promotion`, `companyChange` (Changed company).
- Since (`since`, date): Only activity on or after this date.
- Most per type (`max_per_type`, number): At most this many of each kind of activity per record, 1 to 100. Each one costs credits, so a limit caps the cost. From 1 to 100.

**Outputs**

- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent
- `signals` (list): What happened, newest first

**Example output**

```json
{
  "count": 1,
  "credits_charged": 1,
  "signals": [
    {
      "company_domain": "",
      "company_id": "",
      "company_name": "Lusha",
      "contact_id": "115889",
      "date": "2025-02-01",
      "details": {
        "id": "115889",
        "newCompany": "Lusha",
        "previousCompany": "ZoomInfo",
        "signalDate": "2025-02-01"
      },
      "summary": "Moved from ZoomInfo to Lusha",
      "type": "companyChange"
    }
  ]
}
```

### Get credit balance

See how many Lusha credits are left, your plan, your request limits and what each kind of call costs. Free.

**Inputs**: None.

**Outputs**

- `credits_remaining` (number): Credits left
- `credits_total` (number): Credits in this billing period
- `credits_used` (number): Credits used so far
- `plan` (text): Plan, such as professional
- `plan_ends` (text): When the current term ends, empty on Free
- `plan_starts` (text): When the current term started
- `pricing` (list): What each kind of call costs
- `renewal` (text): How the plan renews, such as annual
- `request_limits` (list): Request limits that apply to your plan

**Example output**

```json
{
  "credits_remaining": 8500,
  "credits_total": 10000,
  "credits_used": 1500,
  "plan": "professional",
  "plan_ends": "2027-01-01T00:00:00.000Z",
  "plan_starts": "2026-01-01T00:00:00.000Z",
  "pricing": [
    {
      "action": "api_search",
      "credits": 1,
      "per": 1
    },
    {
      "action": "phone",
      "credits": 5,
      "per": 1
    }
  ],
  "renewal": "annual",
  "request_limits": [
    {
      "limit": 5000,
      "per": "day",
      "remaining": 4880,
      "resets_at": "2026-10-22T00:00:00.000Z",
      "used": 120
    }
  ]
}
```

### Get Data Waterfall results

Collect the emails and phones your Data Waterfall providers found after Reveal contact details finished, using its waterfall job id. Free; jobs expire after a short while.

**Inputs**

- Waterfall job ID (`job_id`, text, required): The waterfall_job_id from Reveal contact details.

**Outputs**

- `contacts` (list): The contacts the job finished, with what it found
- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent
- `reason` (text): Why the job failed, if it did
- `status` (text): processing (still searching), complete, expired or failed
- `still_finding` (list): Contacts still being searched

**Example output**

```json
{
  "contacts": [
    {
      "city": "Tel Aviv",
      "company_domain": "www.lusha.com",
      "company_id": "16303253",
      "company_industry": "Technology, Information & Media",
      "company_name": "Lusha",
      "country": "Israel",
      "country_code": "IL",
      "departments": [
        "Product"
      ],
      "email": "daniel.t@lusha.com",
      "emails": [
        {
          "confidence": "A+",
          "email": "daniel.t@lusha.com",
          "type": "work"
        }
      ],
      "error": "",
      "error_message": "",
      "first_name": "Daniel",
      "full_name": "Daniel Turgeman",
      "id": "4389064654",
      "is_eu_contact": false,
      "job_title": "Technical Product Manager",
      "last_name": "Turgeman",
      "linkedin_followers": 812,
      "linkedin_url": "https://www.linkedin.com/in/daniel-turgeman",
      "partial_profile": false,
      "phone": "+972 52 000 0000",
      "phones": [
        {
          "do_not_call": false,
          "number": "+972 52 000 0000",
          "type": "mobile"
        }
      ],
      "previous_jobs": [
        {
          "company_domain": "wix.com",
          "company_name": "Wix",
          "job_title": "Product Manager"
        }
      ],
      "seniority": "Manager",
      "skills": [
        "Product Management"
      ],
      "state": "",
      "still_missing": [],
      "tags": [
        "Customer"
      ],
      "updated": "2026-04-23",
      "x_url": ""
    }
  ],
  "count": 1,
  "credits_charged": 1,
  "reason": "",
  "status": "complete",
  "still_finding": []
}
```

### Get recommended companies

Get the companies Lusha recommends to you, ranked by how well they fit your Target Profiles and their recent signals. Lusha updates the list daily. Costs credits per company returned.

**Inputs**

- Target Profiles (`target_profiles`, list): Only recommendations matching these Target Profiles. Leave empty for all.
- Results per page (`page_size`, number): How many to return, 10 to 100. Defaults to 25. From 10 to 100.
- Page (`page`, number): Which page of results, starting at 0. Defaults to the first. From 0 to 1000.

**Outputs**

- `companies` (list): Recommended companies, best first
- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent
- `total` (number): How many match in all, across every page

**Example output**

```json
{
  "companies": [
    {
      "available_data": [
        "description",
        "funding",
        "employeesByDepartment",
        "competitors"
      ],
      "city": "Boston",
      "country": "United States",
      "country_code": "US",
      "domain": "www.lusha.com",
      "employees": 364,
      "employees_max": 500,
      "employees_min": 201,
      "error": "",
      "error_message": "",
      "id": "16303253",
      "industry": "Technology, Information & Media",
      "intent_topics": [
        "Sales Intelligence"
      ],
      "linkedin_url": "https://www.linkedin.com/company/lushadata",
      "name": "Lusha",
      "recommendation": {
        "fit_score": 0.9,
        "lead_score": 0.82,
        "signal_score": 0.6,
        "target_profiles": [
          "Mid-market SaaS"
        ]
      },
      "signal_types": [],
      "state": "Massachusetts"
    }
  ],
  "count": 1,
  "credits_charged": 1,
  "total": 80
}
```

### Get recommended contacts

Get the people Lusha recommends to you, ranked by how well they fit your Target Profiles and their recent signals. Lusha updates the list daily. Costs credits per person returned.

**Inputs**

- Target Profiles (`target_profiles`, list): Only recommendations matching these Target Profiles. Leave empty for all.
- Results per page (`page_size`, number): How many to return, 10 to 100. Defaults to 25. From 10 to 100.
- Page (`page`, number): Which page of results, starting at 0. Defaults to the first. From 0 to 1000.

**Outputs**

- `contacts` (list): Recommended people, best first
- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent
- `total` (number): How many match in all, across every page

**Example output**

```json
{
  "contacts": [
    {
      "available_data": [
        "firstName",
        "lastName",
        "jobTitle",
        "emails"
      ],
      "can_reveal": [
        {
          "credits": 1,
          "field": "emails"
        }
      ],
      "city": "Tel Aviv",
      "company_domain": "www.lusha.com",
      "company_id": "16303253",
      "company_name": "Lusha",
      "country": "Israel",
      "departments": [
        "Business Development"
      ],
      "error": "",
      "error_message": "",
      "first_name": "Orit",
      "full_name": "Orit Shilvock",
      "id": "4415824633",
      "job_title": "Vice President of Partnerships",
      "last_name": "Shilvock",
      "linkedin_url": "https://www.linkedin.com/in/orit-shilvock-6243bb5",
      "recommendation": {
        "fit_score": 0.9,
        "lead_score": 0.82,
        "signal_score": 0.6,
        "target_profiles": [
          "Mid-market SaaS"
        ]
      },
      "seniority": "Vice President",
      "signal_types": [],
      "state": ""
    }
  ],
  "count": 1,
  "credits_charged": 1,
  "total": 120
}
```

### Get website visitors

See which companies visited your website, with how engaged they were, how often and when. Needs your site set up for tracking in Lusha. Looks at up to 3 months at a time.

**Inputs**

- Your website (`domains`, list, required): The domain you track in Lusha, such as acme.com. Several work too, one per line.
- From (`from_date`, date): First day to look at. Defaults to 30 days before Until.
- Until (`until_date`, date): Last day to look at. Defaults to today.
- Engagement (`engagement`, list): Only companies this engaged. Leave empty for all. One or more of: `hot`, `warm`, `cold`.
- Order (`sort`, text): Which companies come first. Defaults to the most engaged. One of: `score` (Most engaged first), `recent` (Most recent visit first), `sessions` (Most visits first).
- Results per page (`page_size`, number): How many to return, 1 to 150. Defaults to 50. From 1 to 150.
- Page (`page`, number): Which page of results, starting at 0. From 0 to 1000.

**Outputs**

- `companies` (list): The visiting companies
- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent
- `from_date` (text): First day looked at (YYYY-MM-DD)
- `total` (number): How many match in all, across every page
- `until_date` (text): Last day looked at (YYYY-MM-DD)

**Example output**

```json
{
  "companies": [
    {
      "available_data": [
        "description",
        "funding",
        "employeesByDepartment",
        "competitors"
      ],
      "average_minutes": 3.4,
      "city": "Boston",
      "country": "United States",
      "country_code": "US",
      "days_since_last_visit": 1,
      "days_visited": 6,
      "domain": "www.lusha.com",
      "employees": 364,
      "employees_max": 500,
      "employees_min": 201,
      "engagement": "hot",
      "engagement_score": 87,
      "error": "",
      "error_message": "",
      "high_intent_pageviews": 4,
      "id": "16303253",
      "industry": "Technology, Information & Media",
      "last_visit": "2026-10-20",
      "linkedin_url": "https://www.linkedin.com/company/lushadata",
      "name": "Lusha",
      "sessions": 14,
      "signal_types": [],
      "state": "Massachusetts",
      "unique_visitors": 5,
      "visitor_country": "US"
    }
  ],
  "count": 1,
  "credits_charged": 0,
  "from_date": "2026-09-21",
  "total": 1,
  "until_date": "2026-10-21"
}
```

### List Target Profiles

List the Target Profiles (ICPs) you own or that are shared with your account, with their ids for the scoring steps. Free.

**Inputs**

- Status (`status`, text): Which profiles to list. Defaults to active ones. One of: `active` (Active, the ones that can score (default)), `disabled`, `all`.

**Outputs**

- `count` (number): How many came back
- `profiles` (list): The Target Profiles

**Example output**

```json
{
  "count": 1,
  "profiles": [
    {
      "access": "private",
      "created_at": "2026-09-01T09:00:00Z",
      "id": "6f1c7d1e-5a4b-4c3d-9e8f-0a1b2c3d4e5f",
      "is_owner": true,
      "name": "Mid-market SaaS",
      "status": "active",
      "updated_at": "2026-10-01T09:00:00Z"
    }
  ]
}
```

### Reveal company details

Get the full profiles of up to 100 companies found by an earlier Lusha step, plus any extra details you choose. Costs credits per company, and per extra detail.

**Inputs**

- Companies (`company_ids`, list, required): Lusha company ids, up to 100, from Search for companies, Find a company or another Lusha step. One per line, or a list.
- Extra details (`extra_details`, list): Breakdowns to add to the profile, each costing extra credits. Leave empty for the standard profile. One or more of: `employeesByDepartment` (Employees by department), `employeesBySeniority` (Employees by seniority), `employeesByLocation` (Employees by location), `competitors`, `intent` (Buyer intent topics), `openJobsTotal` (Open jobs), `openJobsByDepartment` (Open jobs by department), `openJobsByLocation` (Open jobs by location), `openJobsBySeniority` (Open jobs by seniority), `estimatedAnnualItSpend` (Estimated IT spend), and 3 more.

**Outputs**

- `companies` (list): The companies' profiles
- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent

**Example output**

```json
{
  "companies": [
    {
      "business_models": [
        "B2B"
      ],
      "city": "Boston",
      "company_type": "Private Company",
      "competitors": [
        {
          "domain": "clearbit.com",
          "id": "2497917",
          "name": "Clearbit"
        }
      ],
      "country": "United States",
      "country_code": "US",
      "description": "Lusha is a sales intelligence platform.",
      "domain": "www.lusha.com",
      "email": "support@lusha.com",
      "employees": 364,
      "employees_by_department": [
        {
          "count": 72,
          "name": "Sales"
        }
      ],
      "employees_by_location": [
        {
          "count": 301,
          "country": "Israel",
          "state": ""
        }
      ],
      "employees_by_seniority": [
        {
          "count": 141,
          "name": "Manager"
        }
      ],
      "employees_max": 500,
      "employees_min": 201,
      "error": "",
      "error_message": "",
      "facebook_url": "https://www.facebook.com/lusha",
      "funding": {
        "currency": "USD",
        "is_public": false,
        "last_round_amount": 205000000,
        "last_round_date": "Nov 10, 2021",
        "last_round_type": "Private Equity Round",
        "rounds": [
          {
            "amount": 205000000,
            "currency": "USD",
            "date": "Nov 10, 2021",
            "type": "Private Equity Round"
          }
        ],
        "rounds_count": 2,
        "total": 245000000
      },
      "id": "16303253",
      "industry": "Technology, Information & Media",
      "intent_topics": [
        {
          "score": 85,
          "topic": "Sales Intelligence",
          "trend": "+24"
        }
      ],
      "it_spend_usd": null,
      "keywords": [],
      "linkedin_followers": 64339,
      "linkedin_url": "https://www.linkedin.com/company/lushadata",
      "logo_url": "https://logo.lusha.co/lusha.jpg",
      "monthly_website_visits": null,
      "naics_codes": [
        {
          "code": "541511",
          "description": "Custom Computer Programming Services"
        }
      ],
      "name": "Lusha",
      "offering": "",
      "open_jobs": {
        "by_department": [
          {
            "count": 21,
            "name": "Engineering & Technical"
          }
        ],
        "by_location": [],
        "by_seniority": [],
        "total": 47
      },
      "other_domains": [
        "lusha.com"
      ],
      "parent": {
        "country": "",
        "domain": "",
        "id": "",
        "name": ""
      },
      "phone": "",
      "revenue_max": null,
      "revenue_min": null,
      "sic_codes": [
        {
          "code": "7371",
          "description": "Custom computer programming services"
        }
      ],
      "specialities": [
        "lead generation",
        "sales intelligence"
      ],
      "state": "Massachusetts",
      "sub_industry": "Software Development",
      "technologies": [
        "amazon",
        "google analytics"
      ],
      "ultimate_parent": {
        "country": "",
        "domain": "",
        "id": "",
        "name": ""
      },
      "x_url": "https://x.com/lusha",
      "year_founded": 2016,
      "zip_code": "02199"
    }
  ],
  "count": 1,
  "credits_charged": 1
}
```

### Reveal contact details

Get the emails and phone numbers of up to 100 contacts found by an earlier Lusha step. Costs credits for each email and phone; details already revealed cost nothing again. If your Data Waterfall providers are slow, it waits up to a minute for them.

**Inputs**

- Contacts (`contact_ids`, list, required): Lusha contact ids, up to 100, from Search for contacts, Find a contact or another Lusha step. One per line, or a list.
- Reveal (`reveal`, list): What to unlock. Leave empty for both. Each email or phone revealed costs credits, phones more than emails. One or more of: `emails` (Email addresses), `phones` (Phone numbers).
- Use Data Waterfall (`use_waterfall`, true/false): Turn off to use Lusha's own data only, even if your account has Data Waterfall providers switched on.

**Outputs**

- `contacts` (list): The contacts, with their emails and phones
- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent
- `still_finding` (list): Contacts whose details are still on their way
- `waterfall_job_id` (text): Set when Data Waterfall providers are still searching: pass it to Get Data Waterfall results later

**Example output**

```json
{
  "contacts": [
    {
      "city": "Tel Aviv",
      "company_domain": "www.lusha.com",
      "company_id": "16303253",
      "company_industry": "Technology, Information & Media",
      "company_name": "Lusha",
      "country": "Israel",
      "country_code": "IL",
      "departments": [
        "Product"
      ],
      "email": "daniel.t@lusha.com",
      "emails": [
        {
          "confidence": "A+",
          "email": "daniel.t@lusha.com",
          "type": "work"
        }
      ],
      "error": "",
      "error_message": "",
      "first_name": "Daniel",
      "full_name": "Daniel Turgeman",
      "id": "4389064654",
      "is_eu_contact": false,
      "job_title": "Technical Product Manager",
      "last_name": "Turgeman",
      "linkedin_followers": 812,
      "linkedin_url": "https://www.linkedin.com/in/daniel-turgeman",
      "partial_profile": false,
      "phone": "+972 52 000 0000",
      "phones": [
        {
          "do_not_call": false,
          "number": "+972 52 000 0000",
          "type": "mobile"
        }
      ],
      "previous_jobs": [
        {
          "company_domain": "wix.com",
          "company_name": "Wix",
          "job_title": "Product Manager"
        }
      ],
      "seniority": "Manager",
      "skills": [
        "Product Management"
      ],
      "state": "",
      "still_missing": [],
      "tags": [
        "Customer"
      ],
      "updated": "2026-04-23",
      "x_url": ""
    }
  ],
  "count": 1,
  "credits_charged": 2,
  "still_finding": [],
  "waterfall_job_id": ""
}
```

### Score company buying activity

Score up to 100 companies from 0 to 1 by how many buying signals they show right now, such as hiring, funding or website traffic, and list them. Up to 1 credit per company scored.

**Inputs**

- Companies (`companies`, list, required): Up to 100 companies: website domains, names or Lusha company ids, one per line or a list.

**Outputs**

- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent
- `scores` (list): One score for each record given

**Example output**

```json
{
  "count": 1,
  "credits_charged": 1,
  "scores": [
    {
      "active_signals": [
        "surgeInHiring",
        "headcountIncrease3m"
      ],
      "best_profile": "",
      "domain": "lusha.com",
      "error": "",
      "error_message": "",
      "id": "16303253",
      "name": "Lusha",
      "profile_scores": [],
      "score": 0.4
    }
  ]
}
```

### Score company fit

Score how well up to 100 companies fit one to three of your Target Profiles, from 0 to 1. Costs 1 credit per company scored.

**Inputs**

- Target Profiles (`target_profiles`, list, required): One to three of your active Target Profiles (ICPs) to score against. You set them up in Lusha's ICP Hub.
- Companies (`companies`, list, required): Up to 100 companies: website domains, names, emails at the company or Lusha company ids, one per line or a list.

**Outputs**

- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent
- `scores` (list): One score for each record given

**Example output**

```json
{
  "count": 1,
  "credits_charged": 1,
  "scores": [
    {
      "active_signals": [],
      "best_profile": "Mid-market SaaS",
      "domain": "lusha.com",
      "error": "",
      "error_message": "",
      "id": "16303253",
      "name": "Lusha",
      "profile_scores": [],
      "score": 0.86
    }
  ]
}
```

### Score contact fit

Score how well up to 100 people fit one to three of your Target Profiles, from 0 to 1. Costs 1 credit per person scored.

**Inputs**

- Target Profiles (`target_profiles`, list, required): One to three of your active Target Profiles (ICPs) to score against. You set them up in Lusha's ICP Hub.
- Contacts (`contacts`, list, required): Up to 100 people: emails, LinkedIn profiles or Lusha contact ids, one per line or a list.

**Outputs**

- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent
- `scores` (list): One score for each record given

**Example output**

```json
{
  "count": 1,
  "credits_charged": 1,
  "scores": [
    {
      "active_signals": [],
      "best_profile": "Mid-market SaaS",
      "domain": "lusha.com",
      "error": "",
      "error_message": "",
      "id": "4389064654",
      "name": "Daniel Turgeman",
      "profile_scores": [],
      "score": 0.86
    }
  ]
}
```

### Search for companies

Find companies in Lusha's database by industry, size, revenue, country, technologies, intent and more. Returns names, domains and Lusha ids to pass to Reveal company details. Costs a search credit per company returned.

**Inputs**

- Keywords (`keywords`, text): Words to look for anywhere in the profile, up to 200 characters.
- Company names (`company_names`, list): Only these companies, by name. One per line, or a list.
- Domains (`domains`, list): Only these companies, by website domain. One per line, or a list.
- Countries (`countries`, list): Only companies with an office in these countries.
- Industries (`industries`, list): Only companies in these industries.
- Company sizes (`company_sizes`, list): Only companies with this many employees.
- Revenue (`revenues`, list): Only companies with this yearly revenue.
- Technologies (`technologies`, list): Only companies using any of these, such as Salesforce or HubSpot. One per line, or a list.
- Researching (`intent_topics`, list): Only companies showing buyer intent on these topics.
- Company types (`company_types`, list): Only these kinds of company. One or more of: `Private Company`, `Public Company`, `Non Profit` (Non-profit), `Government`, `Educational`, `Self Employed` (Self-employed).
- Sells to (`business_models`, list): Only companies that sell to these customers. One or more of: `B2B` (Sells to businesses (B2B)), `B2C` (Sells to consumers (B2C)), `B2G` (Sells to government (B2G)).
- Founded in or after (`founded_after`, number): Only companies founded in this year or later, such as 2015. From 1600 to 2100.
- Founded in or before (`founded_before`, number): Only companies founded in this year or earlier. From 1600 to 2100.
- Recent activity (`recent_activity`, list): Only companies showing this activity lately, such as a hiring surge. Costs extra credits for each match. One or more of: `surgeInHiring` (Hiring surge), `surgeInHiringByDepartment` (Hiring surge in a department), `surgeInHiringByLocation` (Hiring surge in a location), `headcountIncrease1m` (Headcount up over 1 month), `headcountIncrease3m` (Headcount up over 3 months), `headcountIncrease6m` (Headcount up over 6 months), `headcountIncrease12m` (Headcount up over 12 months), `headcountDecrease1m` (Headcount down over 1 month), `headcountDecrease3m` (Headcount down over 3 months), `headcountDecrease6m` (Headcount down over 6 months), and 17 more.
- Activity since (`activity_since`, date): Only count activity on or after this date. Defaults to Lusha's own window.
- Results per page (`page_size`, number): How many to return, 10 to 100. Defaults to 25. From 10 to 100.
- Page (`page`, number): Which page of results, starting at 0. Defaults to the first. From 0 to 1000.

**Outputs**

- `companies` (list): The companies found
- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent
- `page` (number): The page returned, starting at 0
- `total` (number): How many match in all, across every page

**Example output**

```json
{
  "companies": [
    {
      "available_data": [
        "description",
        "funding",
        "employeesByDepartment",
        "competitors"
      ],
      "city": "Boston",
      "country": "United States",
      "country_code": "US",
      "domain": "www.lusha.com",
      "employees": 364,
      "employees_max": 500,
      "employees_min": 201,
      "error": "",
      "error_message": "",
      "id": "16303253",
      "industry": "Technology, Information & Media",
      "linkedin_url": "https://www.linkedin.com/company/lushadata",
      "name": "Lusha",
      "signal_types": [],
      "state": "Massachusetts"
    }
  ],
  "count": 1,
  "credits_charged": 1,
  "page": 0,
  "total": 874
}
```

### Search for contacts

Find new people in Lusha's database by job title, seniority, department, country and company. Returns names, jobs and Lusha ids to pass to Reveal contact details. Costs a search credit per person returned.

**Inputs**

- Job titles (`job_titles`, list): Job titles to match, such as Head of Sales. One per line, or a list.
- Seniority (`seniority`, list): Only people at these levels.
- Departments (`departments`, list): Only people in these departments.
- Countries (`countries`, list): Only these countries.
- Keywords (`keywords`, text): Words to look for anywhere in the profile, up to 200 characters.
- Company names (`company_names`, list): Only these companies, by name. One per line, or a list.
- Company domains (`company_domains`, list): Only people at these companies, by domain. One per line, or a list.
- Industries (`industries`, list): Only companies in these industries.
- Company sizes (`company_sizes`, list): Only companies with this many employees.
- Must have (`has_data`, list): Only people Lusha holds these details for, such as a work email.
- Recent activity (`recent_activity`, list): Only people who were promoted or changed company lately. Costs extra credits for each match. One or more of: `promotion`, `companyChange` (Changed company).
- Activity since (`activity_since`, date): Only count activity on or after this date. Defaults to Lusha's own window.
- Most per company (`max_per_company`, number): At most this many people from any one company, 1 to 20. From 1 to 20.
- Leave out Do Not Call (`exclude_do_not_call`, true/false): Leave out people whose every phone number is on a Do Not Call list. Needs a Lusha plan that includes it.
- Results per page (`page_size`, number): How many to return, 10 to 100. Defaults to 25. From 10 to 100.
- Page (`page`, number): Which page of results, starting at 0. Defaults to the first. From 0 to 1000.

**Outputs**

- `contacts` (list): The contacts found
- `count` (number): How many came back
- `credits_charged` (number): Lusha credits this step spent
- `page` (number): The page returned, starting at 0
- `total` (number): How many match in all, across every page

**Example output**

```json
{
  "contacts": [
    {
      "available_data": [
        "firstName",
        "lastName",
        "jobTitle",
        "emails"
      ],
      "can_reveal": [
        {
          "credits": 1,
          "field": "emails"
        }
      ],
      "city": "Tel Aviv",
      "company_domain": "www.lusha.com",
      "company_id": "16303253",
      "company_name": "Lusha",
      "country": "Israel",
      "departments": [
        "Business Development"
      ],
      "error": "",
      "error_message": "",
      "first_name": "Orit",
      "full_name": "Orit Shilvock",
      "id": "4415824633",
      "job_title": "Vice President of Partnerships",
      "last_name": "Shilvock",
      "linkedin_url": "https://www.linkedin.com/in/orit-shilvock-6243bb5",
      "seniority": "Vice President",
      "signal_types": [],
      "state": ""
    }
  ],
  "count": 1,
  "credits_charged": 1,
  "page": 0,
  "total": 670550
}
```
