Lusha

Businessby Lusha

Launched May 27, 2026 on ChatGPTLaunched Apr 14, 2026 on Claude

Connect Lusha to Claude to access verified B2B contact and company data without leaving your chat. Lusha is a sales intelligence platform with 300M+ verified contacts, direct emails, phone numbers, and mobile numbers, plus actionable buyer signals used across sales, marketing, and RevOps workflows. Backed by GDPR, CCPA, SOC 2 Type II, and ISO 27701 compliance. Perfect for building prospect lists, researching accounts before a call, qualifying inbound leads, and natural language prospecting inside Claude.

17ChatGPT Tools

17Claude Tools

LushaDeveloper

BusinessCategory

Use Cases

productivity

Available Tools

Lusha Account Credit Usage

account_usage

Full Description

Lusha: returns account credit balance, rate-limit status, plan info, and per-action credit pricing.

Use when: checking Lusha credit balance, rate-limit headroom, plan, or per-action credit cost before invoking credit-consuming tools. Do not use when: looking up available prospecting filter values (use prospecting_company_filters or prospecting_contact_filters).

Returns: Lusha credit balance, rate-limit status (minute/hourly/daily), current plan, and an action pricing map keyed by reveal/search/lookalike/signal actions. Credits: does not consume credits.

Parameters (0 required, 1 optional)

Optional

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

Lusha Companies Search

companies_search

Full Description

Lusha: looks up known companies in the Lusha database by name, domain, or FQDN (batch of 1-25).

Use when: fetching specific known companies by name or domain. Do not use when: searching for companies by criteria like industry or size (prospecting_company_search covers that case).

Optional 'enrich' (default true) bundles reveal fields; pass false for preview-only — follow up with prospecting_company_enrich. Returns: Lusha company profiles with available firmographic data. Credits: consumes Lusha credits per successful lookup; adds reveal credits when enrich is true (default).

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (1 required, 2 optional)

Required

companiesarray

Optional

enrichboolean

Auto-enrich the results. When true (default) the response includes firmographics, technologies and intent in one call and consumes reveal credits. When false only the search preview is returned (no premium fields, no reveal credits); follow up with prospecting_company_enrich on the returned ids when reveals are needed.

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

Lusha Contacts Search

contacts_search

Full Description

Lusha: looks up a single known business contact by name, company, LinkedIn URL, or email.

Use when: fetching contact details for a specific known person. Do not use when: searching for multiple contacts by criteria (prospecting_contact_search covers that case).

Optional 'enrich' (default true) includes reveal data (emails, phones); pass false for preview-only — follow up with prospecting_contact_enrich. Returns: Lusha contact profile with available business data. Credits: consumes 1 Lusha credit per successful lookup; adds reveal credits when enrich is true (default).

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (0 required, 7 optional)

Optional

company_namestring

Company name the contact works at. Required when looking up by name (first_name + last_name + company_name).

emailstring

Contact's email address. Standalone lookup path.

enrichboolean

Auto-enrich the result. When true (default) the response includes emails and phones in one call and consumes reveal credits. When false only the search preview is returned (no emails/phones, no reveal credits); follow up with prospecting_contact_enrich on the returned id when reveals are needed.

first_namestring

Contact's first name. Use with last_name + company_name as one of the supported lookup paths.

last_namestring

Contact's last name. Use with first_name + company_name as one of the supported lookup paths.

linkedin_urlstring

Contact's LinkedIn profile URL. Standalone lookup path.

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

Lusha Look-a-like Companies

lookalike_companies

Full Description

Lusha: discovers companies similar to seed companies; returns paginated lookalike candidates.

Use when: expanding a target account list with companies matching known good-fit profiles. Requires 5-100 seeds. Do not use when: looking up specific known companies (companies_search) or filtering by criteria (prospecting_company_search).

Returns: lookalike companies (employees, industry, location), dedupeSessionId, meta.hasMore, and credit charge. Re-use dedupeSessionId for non-duplicate follow-up calls; sessions expire after 30 days. Credits: consumes Lusha credits per request.

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (1 required, 4 optional)

Required

seedsobject

Seed companies to find lookalikes for. Total unique identifiers across both arrays must be 5-100.

Optional

dedupeSessionIdstring

Opaque pagination/dedupe token (UUID). Omit on first call to start a new run; the response includes a dedupeSessionId to pass back on subsequent calls for the same seeds. Sessions expire after 30 days of inactivity.

excludeobject

Optional companies to exclude from results (e.g., existing customers). Total identifiers max 500. Distinct from dedupeSessionId, which excludes companies already returned by prior pagination calls.

limitinteger

Number of results per call (1-100). Defaults to 25 when omitted.

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

Lusha Look-a-like Contacts

lookalike_contacts

Full Description

Lusha: discovers contacts similar to seed contacts; returns paginated lookalike candidates.

Use when: expanding a prospect list with contacts matching known good-fit profiles. Requires 5-100 seeds. Do not use when: looking up specific known contacts (contacts_search) or filtering by structured criteria (prospecting_contact_search).

Returns: lookalike contacts plus dedupeSessionId for pagination, meta.hasMore, and credit charge. Re-use the returned dedupeSessionId for non-duplicate follow-up calls; sessions expire after 30 days. Credits: consumes Lusha credits per request.

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (1 required, 4 optional)

Required

seedsobject

Seed contacts to find lookalikes for. Total unique identifiers across all arrays must be 5-100.

Optional

dedupeSessionIdstring

excludeobject

Optional contacts to exclude from results (e.g., existing customers). Total identifiers max 500. Distinct from dedupeSessionId, which excludes contacts already returned by prior pagination calls.

limitinteger

Number of results per call (1-50). Defaults to 25 when omitted.

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

Lusha Prospecting Company Enrich

prospecting_company_enrich

Full Description

Lusha prospecting: reveals full firmographic details for one or more Lusha company IDs.

Use when: fetching full firmographic data for a known set of Lusha company IDs (from any prior search). Do not use when: no Lusha company IDs available (companies_search or prospecting_company_search return IDs first).

Optional 'reveal' narrows premium fields: employeesByDepartment, employeesByLocation, employeesBySeniority, competitors (chargeable); intent (free); default all. Cost: account_usage pricing. Returns: enriched Lusha company profiles. Credits: consumes Lusha credits per enriched company.

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (2 required, 2 optional)

Required

idsarray

Lusha company IDs to enrich (from prospecting_company_search or companies_search results). Each id is a numeric string. Capped at 25 per request — split larger batches to fit the 25k-token response budget.

requestIdstring

Lusha search requestId (UUID) from the prior prospecting_company_search response.

Optional

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

revealarray

Lusha company premium data points to reveal (pick one or more). Chargeable fields: 'employeesByDepartment' (headcount per department), 'employeesByLocation' (headcount per country/state), 'employeesBySeniority' (headcount per seniority level), 'competitors' (top competitor companies). Free field: 'intent' (recent intent signals; premium-gated but no charge). When omitted, V3 defaults to all chargeable fields plus intent. Per-field credit cost is published in account_usage `pricing` under key 'revealCompany'.

Lusha Company Filters

prospecting_company_filters

Full Description

Lusha: resolves valid filter values accepted by prospecting_company_search.

Use when: resolving valid filter values before calling prospecting_company_search. Do not use when: looking up specific known companies (companies_search covers that case).

Query-required filter types: names, locations, technologies (the "q" parameter is required and narrows results). No-query filter types: sizes, revenues, industries_labels, intent_topics, sics, naics ("q" is ignored; full canonical list is returned). Resolves one filter type per call. Credits: does not consume credits.

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (1 required, 2 optional)

Required

typestring

Type of Lusha company filter to resolve. Large result types (naics, sics) return all available values; pass 'q' to narrow names, locations, and technologies.

Options:namessizesrevenueslocationssicsnaicsindustries_labelsintent_topicstechnologies

Optional

qstring

Narrowing query. Required for: names, locations, technologies. Ignored for other types.

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

Lusha Prospecting Company Search

prospecting_company_search

Full Description

Lusha prospecting: finds companies by filters. Requires at least one company-side filter.

Use when: finding multiple companies by criteria. Do not use when: known company (companies_search); signals for known IDs (signals_companies_get). Prerequisite: valid values for sizes/revenues/sics/naics/industries/locations/technologies are returned by prospecting_company_filters.

'searchText' is a relevance hint, not an exact filter. Returns: paginated Lusha companies. prospecting_company_enrich returns full firmographic details for selected IDs. Credits: may consume Lusha credits per request.

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (0 required, 17 optional)

Optional

domainsarray

Lusha prospecting: company domains to include (e.g., 'lusha.com').

excludeobject

Optional filters that exclude matching companies. Mirrors the include-side filters. Signals are not supported on the exclude side.

intentTopicsarray

Lusha prospecting: intent topics. Use values from prospecting_company_filters (type='intent_topics').

locationsarray

Lusha prospecting: company locations. Use values from prospecting_company_filters (type='locations').

mainIndustriesIdsarray

Lusha prospecting: main industry IDs. Use values from prospecting_company_filters (type='industries_labels').

naicsCodesarray

Lusha prospecting: NAICS codes. Use values from prospecting_company_filters (type='naics').

namesarray

Lusha prospecting: company names to include. Use values from prospecting_company_filters (type='names').

pageinteger

Page number for pagination (0-based).

page_sizeinteger

Items per page (min 10, max 50, default 20).

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

revenuesarray

Lusha prospecting: revenue ranges (annual USD). Use values from prospecting_company_filters (type='revenues').

searchTextstring

Lusha prospecting: free-text relevance hint across company data. Layered on top of structured filters; not an exact match - broad or unrelated text can still return a large company population. Prefer structured filters (industries, sizes, locations, technologies) for precision.

sicsCodesarray

Lusha prospecting: SIC codes. Use values from prospecting_company_filters (type='sics').

signalsobject

Premium filter: narrow results to companies with recent signal activity. Charges Lusha credits per signal type that returns results, in addition to base prospecting credits.

sizesFilterOptionarray

Lusha prospecting: company size ranges (employee count). Valid min/max ranges are returned by prospecting_company_filters (type='sizes'); custom ranges are not supported.

subIndustriesIdsarray

Lusha prospecting: sub industry IDs. Use values from prospecting_company_filters (type='industries_labels').

technologiesarray

Lusha prospecting: technologies. Use values from prospecting_company_filters (type='technologies').

Lusha Prospecting Contact Enrich

prospecting_contact_enrich

Full Description

Lusha prospecting: reveals emails and phones for one or more Lusha contact IDs.

Use when: fetching emails/phones for a known set of Lusha contact IDs (from any prior search). Do not use when: no Lusha contact IDs available (contacts_search or prospecting_contact_search return IDs first).

Optional 'reveal' narrows the data points returned (emails, phones); defaults to both. Per-field cost: see account_usage pricing (revealEmail, revealPhone). Returns: enriched Lusha contact profiles with emails and phones. Credits: consumes Lusha credits per enriched contact.

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (2 required, 2 optional)

Required

idsarray

Lusha contact IDs to enrich (from prospecting_contact_search or contacts_search results). Each id is a numeric string. Capped at 50 per request — split larger batches to fit the 25k-token response budget.

requestIdstring

Lusha search requestId (UUID) from the prior prospecting_contact_search response.

Optional

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

revealarray

Lusha contact data points to reveal (pick one or more). Allowed values: 'emails' (work + personal email addresses), 'phones' (direct + mobile phone numbers). When omitted, V3 defaults to both. Per-field credit cost is published in account_usage `pricing` under keys 'revealEmail' and 'revealPhone'.

Lusha Contact Filters

prospecting_contact_filters

Full Description

Lusha: resolves valid filter values accepted by prospecting_contact_search.

Use when: resolving valid filter values before calling prospecting_contact_search. Do not use when: looking up specific known contacts (contacts_search covers that case).

No-query filter types: departments, seniority, all_countries, existing_data_points. Requires "locationSearchText": locations. Resolves one filter type per call. Credits: does not consume credits.

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (1 required, 2 optional)

Required

typestring

Type of Lusha contact filter to resolve.

Options:departmentsseniorityall_countrieslocationsexisting_data_points

Optional

locationSearchTextstring

Narrowing text for location-based searches. Required when type='locations'.

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

Lusha Prospecting Contact Search

prospecting_contact_search

Full Description

Lusha prospecting: finds business contacts by filters. Requires at least one contact-side or company-side filter.

Use when: finding multiple contacts by criteria. Do not use when: known contact (contacts_search); signals for known IDs (signals_contacts_get). Prerequisite: valid values for departments/seniority/countries/locations are returned by prospecting_contact_filters.

'searchText' is a relevance hint, not an exact filter. Returns: paginated Lusha contacts. prospecting_contact_enrich returns emails and phones for selected IDs. Credits: may consume Lusha credits per request.

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (0 required, 24 optional)

Optional

companyDomainsarray

Lusha prospecting: filter by company domains (e.g., 'lusha.com').

companyLocationsarray

Lusha prospecting: filter by company locations. Use values from prospecting_company_filters (type='locations').

companyNamesarray

Lusha prospecting: filter by company names.

countriesarray

Lusha prospecting: ISO-2 country codes. Use values from prospecting_contact_filters (type='all_countries').

departmentsarray

Lusha prospecting: department names. Use values from prospecting_contact_filters (type='departments').

excludeobject

Optional filters that exclude matching contacts/companies. Mirrors the include-side filters; any contact/company matching any exclude filter is dropped. Signals are not supported on the exclude side.

existing_data_pointsarray

Lusha prospecting: required data types on contacts. Use values from prospecting_contact_filters (type='existing_data_points').

intentTopicsarray

Lusha prospecting: filter by company intent topics. Use values from prospecting_company_filters (type='intent_topics').

jobTitlesarray

Lusha prospecting: contact job titles (free-form strings, e.g., 'VP of Sales').

locationsarray

Lusha prospecting: contact locations. Use values from prospecting_contact_filters (type='locations').

mainIndustriesIdsarray

Lusha prospecting: main industry IDs. Use values from prospecting_company_filters (type='industries_labels').

naicsCodesarray

Lusha prospecting: NAICS codes. Use values from prospecting_company_filters (type='naics').

namesarray

Lusha prospecting: contact names to include.

pageinteger

Page number for pagination (0-based) - use with page_size.

page_sizeinteger

Items per page (min 10, max 50, default 20) - use with page.

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

revenuesarray

Lusha prospecting: company revenue ranges (annual USD). Use values from prospecting_company_filters (type='revenues').

searchTextstring

Lusha prospecting: free-text relevance hint across contact data. Layered on top of structured filters; not an exact match - broad or unrelated text can still return a large contact population. Prefer structured filters (jobTitles, seniority, departments, countries) for precision.

seniorityarray

Lusha prospecting: seniority level IDs. Use values from prospecting_contact_filters (type='seniority').

sicsCodesarray

Lusha prospecting: SIC codes. Use values from prospecting_company_filters (type='sics').

signalsobject

Premium filter: narrow results to contacts with recent signal activity. Charges Lusha credits per signal type that returns results, in addition to base prospecting credits.

sizesFilterOptionarray

Lusha prospecting: company size ranges (employee count). Valid min/max ranges are returned by prospecting_company_filters (type='sizes').

subIndustriesIdsarray

Lusha prospecting: sub industry IDs. Use values from prospecting_company_filters (type='industries_labels').

technologiesarray

Lusha prospecting: filter by company technologies. Use values from prospecting_company_filters (type='technologies').

Lusha Company Signals by IDs

signals_companies_get

Full Description

Lusha signals: returns recent activity signals (hiring, headcount, IT spend, news) for known Lusha company IDs (batch of 1-25).

Use when: Lusha company IDs are known (e.g., from prospecting_company_search). Do not use when: only domain/name are available (signals_companies_search covers that case).

Signal types and 'filters.include' values: signals_company_filters. Defaults: 6 months, 10 per type. Returns: results[] (one per company ID) with signal events, date window, and billing.creditsCharged. Credits: consumes Lusha credits per signal returned.

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (1 required, 6 optional)

Required

companyIdsarray

Lusha company IDs (1-25 per request). Capped at 25 to fit the 25k-token response budget once signal events are merged; split larger lists into multiple calls.

Optional

filtersobject

Optional filters narrowing news/hiring company signal results. Pair with 'riskNews', 'commercialActivityNews', etc. (newsEventTypes) and 'surgeInHiringByDepartment' / 'surgeInHiringByLocation' (hiringByDepartments / hiringByLocations).

maxResultsPerSignalinteger

Maximum number of signal instances per signal type per company (1-100). Defaults to 10 when omitted.

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

signalsarray

Deprecated: use 'signalTypes'. Kept for backward compatibility; will be removed in a future release.

signalTypesarray

Company signal type identifiers (e.g., 'surgeInHiring', 'headcountIncrease3m', 'riskNews'); 'allSignals' selects every supported type. Source of truth: signals_company_filters - resolve valid values from there before calling. Invalid values return a 400 from the Lusha API.

startDatestring

Start date for signal retrieval (YYYY-MM-DD). Must be a valid calendar date and not in the future. Defaults to last 6 months when omitted.

Lusha Company Signals Search

signals_companies_search

Full Description

Lusha signals: resolves companies by domain or name and returns recent activity signals (hiring, headcount, IT spend, news). Batch of 1-25.

Use when: only company identifiers (domain or name) are available. Do not use when: Lusha company IDs are known (signals_companies_get covers that case).

Each entry: caller 'id' plus name or domain. Defaults: 6 months, 10 per type. Optional 'filters.include' narrows news/hiring signals. Returns: results[] per caller id with signal events (or NOT_FOUND), date window, billing.creditsCharged. Credits: consumes Lusha credits per signal returned.

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (1 required, 6 optional)

Required

companiesarray

Companies to identify and enrich with signals (1-25 per request). Capped at 25 to fit the 25k-token response budget once signal events are merged.

Optional

filtersobject

maxResultsPerSignalinteger

Maximum number of signal instances per signal type per company (1-100). Defaults to 10 when omitted.

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

signalsarray

Deprecated: use 'signalTypes'. Kept for backward compatibility; will be removed in a future release.

signalTypesarray

startDatestring

Start date for signal retrieval (YYYY-MM-DD). Must be a valid calendar date and not in the future. Defaults to last 6 months when omitted.

Lusha Company Signal Filters

signals_company_filters

Full Description

Lusha signals: discovers company signal types and the filter directory, or returns values for a single filter when filterType is set.

Use when: discovering company signal types and filters, or enumerating values for a filter type. Do not use when: looking up contact signal types (signals_contact_filters covers that case).

Omit filterType for the directory; set it for values. 'hiringByLocations' requires 'query'. Returns: Directory: { signalTypes, availableFilters: [{ filterType, requiresQuery }] }. Values: { filterType, values }. Credits: does not consume credits.

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (0 required, 3 optional)

Optional

filterTypestring

Optional. Omit to discover signal types and the directory of available filter types. Set to fetch values for a single filter (e.g., 'newsEventTypes', 'hiringByDepartments', 'hiringByLocations').

Options:newsEventTypeshiringByDepartmentshiringByLocations

querystring

Search text. Required when filterType is 'hiringByLocations' (locations are not enumerable). Not supported for other filterTypes or when filterType is omitted.

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

Lusha Contact Signal Filters

signals_contact_filters

Full Description

Lusha signals: returns the available contact signal types accepted by signals_contacts_get and signals_contacts_search.

Use when: discovering which contact signal types are currently supported before requesting contact signals. Do not use when: fetching signals data for a contact (signals_contacts_get and signals_contacts_search return signals).

Returns: list of supported contact signal type identifiers (e.g., promotion, companyChange, allSignals). Credits: does not consume credits.

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (0 required, 1 optional)

Optional

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

Lusha Contact Signals by IDs

signals_contacts_get

Full Description

Lusha signals: returns recent activity signals (promotions, company changes) for known Lusha contact IDs (batch of 1-25).

Use when: Lusha contact IDs are known (e.g., from prospecting_contact_search or contacts_search). Do not use when: only LinkedIn URL/email/name+company are available (signals_contacts_search covers that case).

Signal type values: see signals_contact_filters. Defaults when omitted: last 6 months, 10 per type per contact. Returns: results[] (one per contact ID) with signal events, date window, and billing.creditsCharged. Credits: consumes Lusha credits per signal returned.

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (1 required, 5 optional)

Required

contactIdsarray

Lusha contact IDs (1-25 per request). Capped at 25 to fit the 25k-token response budget once signal events are merged; split larger lists into multiple calls.

Optional

maxResultsPerSignalinteger

Maximum number of signal instances per signal type per contact (1-100). Defaults to 10 when omitted.

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

signalsarray

Deprecated: use 'signalTypes'. Kept for backward compatibility; will be removed in a future release.

signalTypesarray

Contact signal type identifiers (e.g., 'allSignals', 'promotion', 'companyChange'). Source of truth: signals_contact_filters - resolve valid values from there before calling. Invalid values return a 400 from the Lusha API.

startDatestring

Start date for signal retrieval (YYYY-MM-DD). Must be a valid calendar date and not in the future. Defaults to last 6 months when omitted.

Lusha Contact Signals Search

signals_contacts_search

Full Description

Lusha signals: resolves contacts by LinkedIn URL, email, or name+company and returns recent activity signals (promotions, company changes). Batch of 1-25.

Use when: only contact identifiers (LinkedIn URL, email, or name+company) are available. Do not use when: Lusha contact IDs are known (signals_contacts_get covers that case).

Each entry: caller 'id' plus social_link, email, or full_name+company. Defaults: 6 months, 10 per type. Returns: results[] per caller id with signal events (or NOT_FOUND), date window, billing.creditsCharged. Credits: consumes Lusha credits per signal returned.

Rate limits apply per Lusha plan (per-minute/hourly/daily); exceeding returns HTTP 429. The account_usage tool returns current limits and remaining headroom.

Parameters (1 required, 5 optional)

Required

contactsarray

Contacts to identify and enrich with signals (1-25 per request). Capped at 25 to fit the 25k-token response budget once signal events are merged.

Optional

maxResultsPerSignalinteger

Maximum number of signal instances per signal type per contact (1-100). Defaults to 10 when omitted.

reason_for_invocationstring

Brief explanation of why you chose this tool for the current task. Optional audit field; max 500 characters (longer values are truncated). Plain text only.

signalsarray

Deprecated: use 'signalTypes'. Kept for backward compatibility; will be removed in a future release.

signalTypesarray

startDatestring

Start date for signal retrieval (YYYY-MM-DD). Must be a valid calendar date and not in the future. Defaults to last 6 months when omitted.

Links

Website Privacy Policy Terms of Service