Provided by Lusha
Search People by Title, Seniority, Department and Location Filters (Lusha)
Find people by criteria with Lusha's include and exclude filters: titles, seniority levels, departments, countries and locations on the contact side, plus employer domains, names, size bands and industries on the company side. Each person row is a preview carrying a Lusha contact id, name, title, employer, location, social links and canReveal flags — identities only, with no contact details in them. 10 to 25 people per page. Pass the ids to a Lusha reveal Endpoint when you want the details; an empty page is not charged.
How to run it
Step 1Set up
Once: paste this into your agent's chat. The Skill installs the CLI and logs in by itself. For an agent that cannot use a shell, connect it over MCP instead.
set up https://glasser.ai/SKILL.md
Show me how to use the Lusha endpoint /v3/contacts/prospecting on Glasser.glasser run -p lusha -e '/v3/contacts/prospecting' -i '{"filters":{"companies":{"include":{"domains":["example.com"]}}},"pagination":{"page":0,"size":10}}' --endpoint-version 5Uses endpoint version 5. Inspect the current price before running. Install and log in first on Get Started.
Once per Run:
IDEMPOTENCY_KEY=$(uuidgen)Run it, and copy this same block to send it again:
curl -X POST https://api.glasser.ai/v1/runs \
-H "Authorization: Bearer gl_..." \
-H "Idempotency-Key: $IDEMPOTENCY_KEY" \
-H "Content-Type: application/json" \
-d '{"provider":"lusha","endpoint":"/v3/contacts/prospecting","input":{"filters":{"companies":{"include":{"domains":["example.com"]}}},"pagination":{"page":0,"size":10}},"endpoint_version":5}'Reuse the same Idempotency-Key to send it again: the second send is a read of the first Run. A new key is a new Run and a new Charge. Uses endpoint version 5; inspect the current price before running.
Step 2Try a specific example task
When you need to build an outreach shortlist, you might review available people records for prospects who match your targeting criteria.
Copy this prompt into your agent to find prospects matching your outreach criteria.
Use lusha:/v3/contacts/prospecting on Glasser.
Find people matching my outreach criteria within the records returned by this endpoint.Endpoint structure
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"pagination",
"filters"
],
"properties": {
"filters": {
"type": "object",
"properties": {
"contacts": {
"type": "object",
"properties": {
"exclude": {
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Lusha contact ids from a prior search's results[].id."
},
"names": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Person names."
},
"score": {
"type": "object",
"properties": {
"maxScore": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"minScore": {
"type": "integer",
"maximum": 100,
"minimum": 0
}
},
"additionalProperties": false
},
"awards": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"emails": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"skills": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"signals": {
"type": "object",
"properties": {
"types": {
"type": "array",
"items": {
"enum": [
"allSignals",
"promotion",
"companyChange"
],
"type": "string"
},
"maxItems": 500,
"minItems": 1
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date as YYYY-MM-DD."
}
},
"additionalProperties": false
},
"countries": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Country codes as the contact filter-values Endpoint returns them for filterType countries, e.g. \"US\"."
},
"education": {
"type": "object",
"properties": {
"degrees": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"schools": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"startYearGte": {
"type": "integer"
},
"fieldsOfStudy": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"graduationYearLte": {
"type": "integer"
}
},
"additionalProperties": false
},
"jobTitles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Job titles, e.g. \"VP Sales\"."
},
"locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"state": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"region": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"country": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"continent": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"countryIso2": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"countryGrouping": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1,
"description": "Location objects such as { \"country\": \"United States\" } or { \"countryIso2\": \"US\", \"state\": \"California\" }; exact values come from the Lusha filter-values Endpoint with filterType locations."
},
"searchText": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"departments": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Departments as the contact filter-values Endpoint returns them for filterType departments, e.g. \"Sales\"."
},
"linkedinUrls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Person LinkedIn URLs."
},
"seniorityIds": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 500,
"minItems": 1,
"description": "Seniority ids (integers), not names. Take them from the contact filter-values Endpoint with filterType seniority."
},
"certifications": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"previousEmails": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"previousJobTitle": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"geographicDetails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"country": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"zipcode": {
"type": "string",
"maxLength": 20,
"minLength": 1
},
"distance": {
"type": "integer",
"minimum": 0,
"description": "Radius in miles."
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"existingDataPoints": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Data points the contact must have, e.g. \"work_email\", as the contact filter-values Endpoint returns them for filterType existingDataPoints."
},
"jobChangedAfterDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date as YYYY-MM-DD."
},
"jobTitlesExactMatch": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"normalizedJobTitles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"jobChangedLastViewDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date as YYYY-MM-DD."
},
"existingDataPointsCondition": {
"enum": [
"or",
"and"
],
"type": "string"
}
},
"additionalProperties": false
},
"include": {
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Lusha contact ids from a prior search's results[].id."
},
"names": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Person names."
},
"score": {
"type": "object",
"properties": {
"maxScore": {
"type": "integer",
"maximum": 100,
"minimum": 0
},
"minScore": {
"type": "integer",
"maximum": 100,
"minimum": 0
}
},
"additionalProperties": false
},
"awards": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"emails": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"skills": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"signals": {
"type": "object",
"properties": {
"types": {
"type": "array",
"items": {
"enum": [
"allSignals",
"promotion",
"companyChange"
],
"type": "string"
},
"maxItems": 500,
"minItems": 1
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date as YYYY-MM-DD."
}
},
"additionalProperties": false
},
"countries": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Country codes as the contact filter-values Endpoint returns them for filterType countries, e.g. \"US\"."
},
"education": {
"type": "object",
"properties": {
"degrees": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"schools": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"startYearGte": {
"type": "integer"
},
"fieldsOfStudy": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"graduationYearLte": {
"type": "integer"
}
},
"additionalProperties": false
},
"jobTitles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Job titles, e.g. \"VP Sales\"."
},
"locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"state": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"region": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"country": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"continent": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"countryIso2": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"countryGrouping": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1,
"description": "Location objects such as { \"country\": \"United States\" } or { \"countryIso2\": \"US\", \"state\": \"California\" }; exact values come from the Lusha filter-values Endpoint with filterType locations."
},
"searchText": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"departments": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Departments as the contact filter-values Endpoint returns them for filterType departments, e.g. \"Sales\"."
},
"linkedinUrls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Person LinkedIn URLs."
},
"seniorityIds": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 500,
"minItems": 1,
"description": "Seniority ids (integers), not names. Take them from the contact filter-values Endpoint with filterType seniority."
},
"certifications": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"previousEmails": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"previousJobTitle": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"geographicDetails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"country": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"zipcode": {
"type": "string",
"maxLength": 20,
"minLength": 1
},
"distance": {
"type": "integer",
"minimum": 0,
"description": "Radius in miles."
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"existingDataPoints": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Data points the contact must have, e.g. \"work_email\", as the contact filter-values Endpoint returns them for filterType existingDataPoints."
},
"jobChangedAfterDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date as YYYY-MM-DD."
},
"jobTitlesExactMatch": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"normalizedJobTitles": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"jobChangedLastViewDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date as YYYY-MM-DD."
},
"existingDataPointsCondition": {
"enum": [
"or",
"and"
],
"type": "string"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
"companies": {
"type": "object",
"properties": {
"exclude": {
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Lusha company ids."
},
"names": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Company names."
},
"sizes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"minimum": 0
},
"min": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1,
"description": "Headcount ranges as { min, max } employee counts; the bands Lusha uses come from the company filter-values Endpoint with filterType sizes."
},
"domains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Company domains, e.g. \"lusha.com\"."
},
"funding": {
"type": "object",
"properties": {
"date": {
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date as YYYY-MM-DD."
},
"coverage": {
"enum": [
"last_funding",
"any_round",
"total_funds",
"last_round"
],
"type": "string"
}
},
"additionalProperties": false
},
"isIpo": {
"type": "boolean"
},
"names": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"enum": [
"angel",
"venture",
"private_equity",
"crowdfunding",
"grant",
"debt_financing",
"other"
],
"type": "string"
},
"coverage": {
"enum": [
"last_funding",
"any_round",
"total_funds",
"last_round"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"types": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"max": {
"type": "integer"
},
"min": {
"type": "integer"
},
"coverage": {
"enum": [
"last_funding",
"any_round",
"total_funds",
"last_round"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"rounds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"round": {
"enum": [
"pre_seed",
"seed",
"series_a",
"series_b",
"series_c",
"series_d",
"series_e",
"series_f",
"series_g",
"series_h",
"other"
],
"type": "string"
},
"coverage": {
"enum": [
"last_funding",
"any_round",
"total_funds",
"last_round"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"investors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
}
},
"additionalProperties": false
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Keywords associated with the company."
},
"revenues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"minimum": 0
},
"min": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1,
"description": "Annual revenue ranges in US dollars as { min, max }; the bands Lusha uses come from the company filter-values Endpoint with filterType revenues."
},
"sicCodes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "SIC codes as the company filter-values Endpoint returns them for filterType sics."
},
"locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"state": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"region": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"country": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"continent": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"countryIso2": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"countryGrouping": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1,
"description": "Location objects such as { \"country\": \"United States\" } or { \"countryIso2\": \"US\", \"state\": \"California\" }; exact values come from the Lusha filter-values Endpoint with filterType locations."
},
"naicsCodes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "NAICS codes as the company filter-values Endpoint returns them for filterType naics."
},
"companyType": {
"type": "array",
"items": {
"enum": [
"Government",
"Private Company",
"Public Company",
"Educational",
"Non Profit",
"Self Employed"
],
"type": "string"
},
"maxItems": 500,
"minItems": 1
},
"foundedYear": {
"type": "array",
"items": {
"type": "object",
"properties": {
"max": {
"type": "integer"
},
"min": {
"type": "integer"
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1,
"description": "Founded-year ranges as { min, max }, both inclusive."
},
"intentTopics": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Intent topics as the company filter-values Endpoint returns them for filterType intentTopics."
},
"linkedinUrls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Company LinkedIn URLs."
},
"specialities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"technologies": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Technology names as the company filter-values Endpoint returns them for filterType technologies."
},
"businessModel": {
"type": "array",
"items": {
"enum": [
"B2B",
"B2C",
"B2G"
],
"type": "string"
},
"maxItems": 500,
"minItems": 1
},
"exactKeywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"intentMaxScore": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"intentMinScore": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"industriesLabels": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Industry labels (the main_industry text) from the company filter-values Endpoint with filterType industriesLabels, e.g. \"Software\"."
},
"subIndustriesIds": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 500,
"minItems": 1,
"description": "Lusha sub-industry ids (integers), not labels. Take sub_industries[].id from the rows the company filter-values Endpoint returns for filterType industriesLabels."
},
"exactSpecialities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"geographicDetails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"country": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"zipcode": {
"type": "string",
"maxLength": 20,
"minLength": 1
},
"distance": {
"type": "integer",
"minimum": 0,
"description": "Radius in miles."
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"locationsZipcodes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"zipcode": {
"type": "string",
"maxLength": 20,
"minLength": 1
},
"countryIso2": {
"type": "string",
"maxLength": 2,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"mainIndustriesIds": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 500,
"minItems": 1,
"description": "Lusha main industry ids (integers), not labels. Take main_industry_id from the rows the company filter-values Endpoint returns for filterType industriesLabels."
},
"headquarterZipcodes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"zipcode": {
"type": "string",
"maxLength": 20,
"minLength": 1
},
"countryIso2": {
"type": "string",
"maxLength": 2,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"topicCountThreshold": {
"type": "array",
"items": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"minimum": 0
},
"min": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"intentTopicsOperator": {
"enum": [
"or",
"and",
"any",
"all"
],
"type": "string"
},
"keywordsSearchFields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"previousCompanyNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"intentTopicsCondition": {
"enum": [
"or",
"and"
],
"type": "string"
},
"technologiesCondition": {
"enum": [
"or",
"and"
],
"type": "string"
},
"previousCompanyDomains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
}
},
"additionalProperties": false
},
"include": {
"type": "object",
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Lusha company ids."
},
"names": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Company names."
},
"sizes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"minimum": 0
},
"min": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1,
"description": "Headcount ranges as { min, max } employee counts; the bands Lusha uses come from the company filter-values Endpoint with filterType sizes."
},
"domains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Company domains, e.g. \"lusha.com\"."
},
"funding": {
"type": "object",
"properties": {
"date": {
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "A date as YYYY-MM-DD."
},
"coverage": {
"enum": [
"last_funding",
"any_round",
"total_funds",
"last_round"
],
"type": "string"
}
},
"additionalProperties": false
},
"isIpo": {
"type": "boolean"
},
"names": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"enum": [
"angel",
"venture",
"private_equity",
"crowdfunding",
"grant",
"debt_financing",
"other"
],
"type": "string"
},
"coverage": {
"enum": [
"last_funding",
"any_round",
"total_funds",
"last_round"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"types": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"ranges": {
"type": "array",
"items": {
"type": "object",
"properties": {
"max": {
"type": "integer"
},
"min": {
"type": "integer"
},
"coverage": {
"enum": [
"last_funding",
"any_round",
"total_funds",
"last_round"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"rounds": {
"type": "array",
"items": {
"type": "object",
"properties": {
"round": {
"enum": [
"pre_seed",
"seed",
"series_a",
"series_b",
"series_c",
"series_d",
"series_e",
"series_f",
"series_g",
"series_h",
"other"
],
"type": "string"
},
"coverage": {
"enum": [
"last_funding",
"any_round",
"total_funds",
"last_round"
],
"type": "string"
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"investors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
}
},
"additionalProperties": false
},
"keywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Keywords associated with the company."
},
"revenues": {
"type": "array",
"items": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"minimum": 0
},
"min": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1,
"description": "Annual revenue ranges in US dollars as { min, max }; the bands Lusha uses come from the company filter-values Endpoint with filterType revenues."
},
"sicCodes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "SIC codes as the company filter-values Endpoint returns them for filterType sics."
},
"locations": {
"type": "array",
"items": {
"type": "object",
"properties": {
"city": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"state": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"region": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"country": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"continent": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"countryIso2": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"countryGrouping": {
"type": "string",
"maxLength": 200,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1,
"description": "Location objects such as { \"country\": \"United States\" } or { \"countryIso2\": \"US\", \"state\": \"California\" }; exact values come from the Lusha filter-values Endpoint with filterType locations."
},
"naicsCodes": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "NAICS codes as the company filter-values Endpoint returns them for filterType naics."
},
"companyType": {
"type": "array",
"items": {
"enum": [
"Government",
"Private Company",
"Public Company",
"Educational",
"Non Profit",
"Self Employed"
],
"type": "string"
},
"maxItems": 500,
"minItems": 1
},
"foundedYear": {
"type": "array",
"items": {
"type": "object",
"properties": {
"max": {
"type": "integer"
},
"min": {
"type": "integer"
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1,
"description": "Founded-year ranges as { min, max }, both inclusive."
},
"intentTopics": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Intent topics as the company filter-values Endpoint returns them for filterType intentTopics."
},
"linkedinUrls": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Company LinkedIn URLs."
},
"specialities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"technologies": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Technology names as the company filter-values Endpoint returns them for filterType technologies."
},
"businessModel": {
"type": "array",
"items": {
"enum": [
"B2B",
"B2C",
"B2G"
],
"type": "string"
},
"maxItems": 500,
"minItems": 1
},
"exactKeywords": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"intentMaxScore": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"intentMinScore": {
"type": "integer",
"maximum": 100,
"minimum": 1
},
"industriesLabels": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1,
"description": "Industry labels (the main_industry text) from the company filter-values Endpoint with filterType industriesLabels, e.g. \"Software\"."
},
"subIndustriesIds": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 500,
"minItems": 1,
"description": "Lusha sub-industry ids (integers), not labels. Take sub_industries[].id from the rows the company filter-values Endpoint returns for filterType industriesLabels."
},
"exactSpecialities": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"geographicDetails": {
"type": "array",
"items": {
"type": "object",
"properties": {
"country": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"zipcode": {
"type": "string",
"maxLength": 20,
"minLength": 1
},
"distance": {
"type": "integer",
"minimum": 0,
"description": "Radius in miles."
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"locationsZipcodes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"zipcode": {
"type": "string",
"maxLength": 20,
"minLength": 1
},
"countryIso2": {
"type": "string",
"maxLength": 2,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"mainIndustriesIds": {
"type": "array",
"items": {
"type": "integer"
},
"maxItems": 500,
"minItems": 1,
"description": "Lusha main industry ids (integers), not labels. Take main_industry_id from the rows the company filter-values Endpoint returns for filterType industriesLabels."
},
"headquarterZipcodes": {
"type": "array",
"items": {
"type": "object",
"properties": {
"zipcode": {
"type": "string",
"maxLength": 20,
"minLength": 1
},
"countryIso2": {
"type": "string",
"maxLength": 2,
"minLength": 1
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"topicCountThreshold": {
"type": "array",
"items": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"minimum": 0
},
"min": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"maxItems": 500,
"minItems": 1
},
"intentTopicsOperator": {
"enum": [
"or",
"and",
"any",
"all"
],
"type": "string"
},
"keywordsSearchFields": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"previousCompanyNames": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
},
"intentTopicsCondition": {
"enum": [
"or",
"and"
],
"type": "string"
},
"technologiesCondition": {
"enum": [
"or",
"and"
],
"type": "string"
},
"previousCompanyDomains": {
"type": "array",
"items": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"maxItems": 500,
"minItems": 1
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}
},
"description": "Lusha contact prospecting filters: contacts.include / contacts.exclude on the person (job titles, seniorityIds, departments, countries, locations) and companies.include / companies.exclude on the employer (domains, names, sizes, industries). Use values from the contact and company filter-values Endpoints; seniority and industry ids are integers.",
"additionalProperties": false
},
"pagination": {
"type": "object",
"required": [
"page",
"size"
],
"properties": {
"page": {
"type": "integer",
"maximum": 1000,
"minimum": 0
},
"size": {
"type": "integer",
"maximum": 25,
"minimum": 10
}
},
"additionalProperties": false
}
},
"additionalProperties": false
}{
"filters": {
"companies": {
"include": {
"domains": [
"example.com"
]
}
}
},
"pagination": {
"page": 0,
"size": 10
}
}This Endpoint publishes no output schema. You get the Provider's own response body, unchanged — we do not warrant a shape we cannot guarantee.
How pricing works
| Data returned | Charged only when data is returned. | $0.137225 |
|---|---|---|
| Provider error | The Provider failed to answer. | $0.00 |
| Timed out | The Run exceeded its time limit. | $0.00 |
| Internal failure | An internal error prevented completion. | $0.00 |