Lusha

App · 22 actions

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.

Actions

ActionWhat it does
Enrich a companyGet 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.
Enrich a contactFind someone by email, LinkedIn profile, Lusha id, or name and company, and get their emails and phone numbers with their job, company and history.
Find a companyLook a company up by domain, name or Lusha id, and see its size, industry and location and what Lusha holds on it.
Find a contactLook 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.
Find similar companiesGive 5 to 100 of your best customers and get new companies of a similar size, industry and profile.
Find similar contactsGive 5 to 100 of your best contacts and get new people with similar roles, seniority and companies.
Get buying groupFind the decision makers, potential champions and end users at up to 25 companies.
Get company signalsSee what is happening at up to 100 companies: hiring surges, headcount and traffic changes, IT spend, news, and the topics they are researching.
Get contact signalsSee which of up to 100 contacts were promoted or moved to a new company, and when.
Get credit balanceSee how many Lusha credits are left, your plan, your request limits and what each kind of call costs.
Get Data Waterfall resultsCollect the emails and phones your Data Waterfall providers found after Reveal contact details finished, using its waterfall job id.
Get recommended companiesGet the companies Lusha recommends to you, ranked by how well they fit your Target Profiles and their recent signals.
Get recommended contactsGet the people Lusha recommends to you, ranked by how well they fit your Target Profiles and their recent signals.
Get website visitorsSee which companies visited your website, with how engaged they were, how often and when.
List Target ProfilesList the Target Profiles (ICPs) you own or that are shared with your account, with their ids for the scoring steps.
Reveal company detailsGet the full profiles of up to 100 companies found by an earlier Lusha step, plus any extra details you choose.
Reveal contact detailsGet the emails and phone numbers of up to 100 contacts found by an earlier Lusha step.
Score company buying activityScore 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.
Score company fitScore how well up to 100 companies fit one to three of your Target Profiles, from 0 to 1.
Score contact fitScore how well up to 100 people fit one to three of your Target Profiles, from 0 to 1.
Search for companiesFind companies in Lusha's database by industry, size, revenue, country, technologies, intent and more.
Search for contactsFind new people in Lusha's database by job title, seniority, department, country and company.

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

Domaindomaintext
The company's website domain, such as acme.com. A full address works too.
Company namenametext
The company's name. A domain finds it more surely.
Lusha company IDcompany_idtext
Lusha's id for the company, from an earlier Lusha step.
Extra detailsextra_detailslist
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

companyobject
The company's full profile
credits_chargednumber
Lusha credits this step spent
foundtrue/false
Whether Lusha found a match
Example output
{
  "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

Emailemailtext
Their email address. The surest way to find someone.
LinkedIn profilelinkedin_urltext
The address of their LinkedIn profile.
First namefirst_nametext
Their first name. Give it with Last name and Company.
Last namelast_nametext
Their last name. Give it with First name and Company.
Companycompanytext
Where they work: the company's name or website domain (acme.com). Give it with First name and Last name.
Lusha contact IDcontact_idtext
Lusha's id for the contact, from an earlier Lusha step.
Revealreveallist
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

contactobject
The contact, with emails and phones
credits_chargednumber
Lusha credits this step spent
foundtrue/false
Whether Lusha found a match
Example output
{
  "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

Domaindomaintext
The company's website domain, such as acme.com. A full address works too.
Company namenametext
The company's name. A domain finds it more surely.
Lusha company IDcompany_idtext
Lusha's id for the company, from an earlier Lusha step.

Outputs

companyobject
The company, if found
credits_chargednumber
Lusha credits this step spent
foundtrue/false
Whether Lusha found a match
Example output
{
  "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

Emailemailtext
Their email address. The surest way to find someone.
LinkedIn profilelinkedin_urltext
The address of their LinkedIn profile.
First namefirst_nametext
Their first name. Give it with Last name and Company.
Last namelast_nametext
Their last name. Give it with First name and Company.
Companycompanytext
Where they work: the company's name or website domain (acme.com). Give it with First name and Last name.
Lusha contact IDcontact_idtext
Lusha's id for the contact, from an earlier Lusha step.

Outputs

contactobject
The contact, if found
credits_chargednumber
Lusha credits this step spent
foundtrue/false
Whether Lusha found a match
Example output
{
  "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 companiesexampleslistRequired
5 to 100 companies to find more like: website domains or LinkedIn company pages, one per line or a list.
Leave outleave_outlist
Companies never to suggest, such as customers or competitors: domains or LinkedIn company pages.
How manylimitnumber
How many to return, 1 to 100. Defaults to 25. Each costs credits.From 1 to 100.
More frommore_fromtext
The session_id of an earlier run of this step, to get more results without repeating any.

Outputs

companieslist
Similar companies
countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
has_moretrue/false
Whether More from would find more
session_idtext
Pass as More from to get more without repeats
Example output
{
  "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 contactsexampleslistRequired
5 to 100 people to find more like: emails, LinkedIn profiles or Lusha contact ids, one per line or a list.
Leave outleave_outlist
People never to suggest, such as existing customers: emails, LinkedIn profiles or Lusha ids.
How manylimitnumber
How many to return, 1 to 100. Defaults to 25. Each costs credits.From 1 to 100.
More frommore_fromtext
The session_id of an earlier run of this step, to get more results without repeating any.

Outputs

contactslist
Similar contacts
countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
has_moretrue/false
Whether More from would find more
session_idtext
Pass as More from to get more without repeats
Example output
{
  "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

CompaniescompanieslistRequired
Up to 25 companies, by website domain or Lusha company id. One per line, or a list.
Rolesroleslist
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 companycontacts_per_companynumber
At most this many people per company. Lusha's default is 60.From 1 to 100.

Outputs

contactslist
The buyers, labelled with their roles
countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
not_foundlist
Companies Lusha could not find
Example output
{
  "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

Companiescompany_idslistRequired
Lusha company ids, up to 100, from Search for companies, Find a company or another Lusha step. One per line, or a list.
Signalssignal_typeslist
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.
Sincesincedate
Only activity on or after this date.
Most per typemax_per_typenumber
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

countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
signalslist
What happened, newest first
Example output
{
  "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

Contactscontact_idslistRequired
Lusha contact ids, up to 100, from Search for contacts, Find a contact or another Lusha step. One per line, or a list.
Signalssignal_typeslist
What to look for. Leave empty for both.One or more of: promotion, companyChange (Changed company).
Sincesincedate
Only activity on or after this date.
Most per typemax_per_typenumber
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

countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
signalslist
What happened, newest first
Example output
{
  "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_remainingnumber
Credits left
credits_totalnumber
Credits in this billing period
credits_usednumber
Credits used so far
plantext
Plan, such as professional
plan_endstext
When the current term ends, empty on Free
plan_startstext
When the current term started
pricinglist
What each kind of call costs
renewaltext
How the plan renews, such as annual
request_limitslist
Request limits that apply to your plan
Example output
{
  "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 IDjob_idtextRequired
The waterfall_job_id from Reveal contact details.

Outputs

contactslist
The contacts the job finished, with what it found
countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
reasontext
Why the job failed, if it did
statustext
processing (still searching), complete, expired or failed
still_findinglist
Contacts still being searched
Example output
{
  "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 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 Profilestarget_profileslist
Only recommendations matching these Target Profiles. Leave empty for all.
Results per pagepage_sizenumber
How many to return, 10 to 100. Defaults to 25.From 10 to 100.
Pagepagenumber
Which page of results, starting at 0. Defaults to the first.From 0 to 1000.

Outputs

companieslist
Recommended companies, best first
countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
totalnumber
How many match in all, across every page
Example output
{
  "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 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 Profilestarget_profileslist
Only recommendations matching these Target Profiles. Leave empty for all.
Results per pagepage_sizenumber
How many to return, 10 to 100. Defaults to 25.From 10 to 100.
Pagepagenumber
Which page of results, starting at 0. Defaults to the first.From 0 to 1000.

Outputs

contactslist
Recommended people, best first
countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
totalnumber
How many match in all, across every page
Example output
{
  "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 websitedomainslistRequired
The domain you track in Lusha, such as acme.com. Several work too, one per line.
Fromfrom_datedate
First day to look at. Defaults to 30 days before Until.
Untiluntil_datedate
Last day to look at. Defaults to today.
Engagementengagementlist
Only companies this engaged. Leave empty for all.One or more of: hot, warm, cold.
Ordersorttext
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 pagepage_sizenumber
How many to return, 1 to 150. Defaults to 50.From 1 to 150.
Pagepagenumber
Which page of results, starting at 0.From 0 to 1000.

Outputs

companieslist
The visiting companies
countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
from_datetext
First day looked at (YYYY-MM-DD)
totalnumber
How many match in all, across every page
until_datetext
Last day looked at (YYYY-MM-DD)
Example output
{
  "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

Statusstatustext
Which profiles to list. Defaults to active ones.One of: active (Active, the ones that can score (default)), disabled, all.

Outputs

countnumber
How many came back
profileslist
The Target Profiles
Example output
{
  "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

Companiescompany_idslistRequired
Lusha company ids, up to 100, from Search for companies, Find a company or another Lusha step. One per line, or a list.
Extra detailsextra_detailslist
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

companieslist
The companies' profiles
countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
Example output
{
  "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

Contactscontact_idslistRequired
Lusha contact ids, up to 100, from Search for contacts, Find a contact or another Lusha step. One per line, or a list.
Revealreveallist
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 Waterfalluse_waterfalltrue/false
Turn off to use Lusha's own data only, even if your account has Data Waterfall providers switched on.

Outputs

contactslist
The contacts, with their emails and phones
countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
still_findinglist
Contacts whose details are still on their way
waterfall_job_idtext
Set when Data Waterfall providers are still searching: pass it to Get Data Waterfall results later
Example output
{
  "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

CompaniescompanieslistRequired
Up to 100 companies: website domains, names or Lusha company ids, one per line or a list.

Outputs

countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
scoreslist
One score for each record given
Example output
{
  "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 Profilestarget_profileslistRequired
One to three of your active Target Profiles (ICPs) to score against. You set them up in Lusha's ICP Hub.
CompaniescompanieslistRequired
Up to 100 companies: website domains, names, emails at the company or Lusha company ids, one per line or a list.

Outputs

countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
scoreslist
One score for each record given
Example output
{
  "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 Profilestarget_profileslistRequired
One to three of your active Target Profiles (ICPs) to score against. You set them up in Lusha's ICP Hub.
ContactscontactslistRequired
Up to 100 people: emails, LinkedIn profiles or Lusha contact ids, one per line or a list.

Outputs

countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
scoreslist
One score for each record given
Example output
{
  "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

Keywordskeywordstext
Words to look for anywhere in the profile, up to 200 characters.
Company namescompany_nameslist
Only these companies, by name. One per line, or a list.
Domainsdomainslist
Only these companies, by website domain. One per line, or a list.
Countriescountrieslist
Only companies with an office in these countries.
Industriesindustrieslist
Only companies in these industries.
Company sizescompany_sizeslist
Only companies with this many employees.
Revenuerevenueslist
Only companies with this yearly revenue.
Technologiestechnologieslist
Only companies using any of these, such as Salesforce or HubSpot. One per line, or a list.
Researchingintent_topicslist
Only companies showing buyer intent on these topics.
Company typescompany_typeslist
Only these kinds of company.One or more of: Private Company, Public Company, Non Profit (Non-profit), Government, Educational, Self Employed (Self-employed).
Sells tobusiness_modelslist
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 afterfounded_afternumber
Only companies founded in this year or later, such as 2015.From 1600 to 2100.
Founded in or beforefounded_beforenumber
Only companies founded in this year or earlier.From 1600 to 2100.
Recent activityrecent_activitylist
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 sinceactivity_sincedate
Only count activity on or after this date. Defaults to Lusha's own window.
Results per pagepage_sizenumber
How many to return, 10 to 100. Defaults to 25.From 10 to 100.
Pagepagenumber
Which page of results, starting at 0. Defaults to the first.From 0 to 1000.

Outputs

companieslist
The companies found
countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
pagenumber
The page returned, starting at 0
totalnumber
How many match in all, across every page
Example output
{
  "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 titlesjob_titleslist
Job titles to match, such as Head of Sales. One per line, or a list.
Senioritysenioritylist
Only people at these levels.
Departmentsdepartmentslist
Only people in these departments.
Countriescountrieslist
Only these countries.
Keywordskeywordstext
Words to look for anywhere in the profile, up to 200 characters.
Company namescompany_nameslist
Only these companies, by name. One per line, or a list.
Company domainscompany_domainslist
Only people at these companies, by domain. One per line, or a list.
Industriesindustrieslist
Only companies in these industries.
Company sizescompany_sizeslist
Only companies with this many employees.
Must havehas_datalist
Only people Lusha holds these details for, such as a work email.
Recent activityrecent_activitylist
Only people who were promoted or changed company lately. Costs extra credits for each match.One or more of: promotion, companyChange (Changed company).
Activity sinceactivity_sincedate
Only count activity on or after this date. Defaults to Lusha's own window.
Most per companymax_per_companynumber
At most this many people from any one company, 1 to 20.From 1 to 20.
Leave out Do Not Callexclude_do_not_calltrue/false
Leave out people whose every phone number is on a Do Not Call list. Needs a Lusha plan that includes it.
Results per pagepage_sizenumber
How many to return, 10 to 100. Defaults to 25.From 10 to 100.
Pagepagenumber
Which page of results, starting at 0. Defaults to the first.From 0 to 1000.

Outputs

contactslist
The contacts found
countnumber
How many came back
credits_chargednumber
Lusha credits this step spent
pagenumber
The page returned, starting at 0
totalnumber
How many match in all, across every page
Example output
{
  "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
}

On this page