# Leadsforge people search Takes company business models, company domains, company employee number range and more, all optional. Search leads. Accepts the full person filter set. Beyond the documented fields the body also accepts exclusion filters to skip contacts you already own: excludeEmails ([]string), excludeDomains ([]string), excludeLinkedInURLs ([]string). Use companyDomains.include to target specific companies (e.g. domains returned by /lookalikes/preview or /lookalikes/search). Free-text fields (jobTitles, leadLocations, companyLocations, technologies, keywords, companyNames) accept any value (casing and partial terms are matched), so there is no value list to fetch. Controlled fields must use exact values from their discovery endpoints under /search/filters (industries, seniorities, departments, companyTypes, fundingTypes, revenueRanges). No provider credits charged for this read/preview operation. - Tool ID: `leadsforge/search-people` - Name in the catalog: Search - Provider: [Leadsforge](/providers/leadsforge.md) - Capability: [People search](/tools/b2b-data/people-search.md) - Price: no charge per call - Authentication: an authorised Agentik workspace is required for execution, including zero-price tools. ## Pricing contract No charge per call. A workspace is still needed so your agent can call it. ```json { "model": "per_call", "amountUsd": 0 } ``` ## Complete input schema ```json { "type": "object", "properties": { "companyBusinessModels": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 } }, "additionalProperties": false }, "companyDomains": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 } }, "additionalProperties": false }, "companyEmployeeNumberRange": { "type": "object", "properties": { "max": { "type": "integer" }, "min": { "type": "integer" } }, "additionalProperties": false }, "companyFoundedYearRange": { "type": "object", "properties": { "max": { "type": "integer" }, "min": { "type": "integer" } }, "additionalProperties": false }, "companyFundingRounds": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 } }, "additionalProperties": false }, "companyIDs": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 } }, "additionalProperties": false }, "companyIndustries": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 } }, "additionalProperties": false }, "companyKeywords": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "matchAll": { "type": "boolean" } }, "additionalProperties": false }, "companyLocations": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 } }, "additionalProperties": false }, "companyNames": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 } }, "additionalProperties": false }, "companyNiches": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 } }, "additionalProperties": false }, "companyRequired": { "type": "boolean" }, "companyRevenueRanges": { "type": "array", "items": { "type": "string", "enum": [ "very_small", "small_lower", "small_upper", "lower_mid_sized", "mid_sized_lower", "mid_sized_upper", "large_lower", "large_upper", "enterprise_lower", "enterprise_upper", "global_giants_lower", "global_giants_upper", "super_enterprises" ], "maxLength": 2048 }, "maxItems": 500 }, "companyTechnologies": { "type": "object", "properties": { "all": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "any": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 } }, "additionalProperties": false }, "companyTypes": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 } }, "additionalProperties": false }, "companyYearsInBusinessRange": { "type": "object", "properties": { "max": { "type": "integer" }, "min": { "type": "integer" } }, "additionalProperties": false }, "leadDepartments": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 } }, "additionalProperties": false }, "leadIDs": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 } }, "additionalProperties": false }, "leadJobTitles": { "type": "object", "properties": { "exactMatch": { "type": "boolean" }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 } }, "additionalProperties": false }, "leadLanguages": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "primaryOnly": { "type": "boolean" } }, "additionalProperties": false }, "leadLocations": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 } }, "additionalProperties": false }, "leadSeniorities": { "type": "object", "properties": { "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 }, "include": { "type": "array", "items": { "type": "string", "maxLength": 2048 }, "maxItems": 500 } }, "additionalProperties": false }, "leadTenure": { "type": "object", "properties": { "max": { "type": "integer" }, "min": { "type": "integer" } }, "additionalProperties": false }, "limit": { "type": "integer", "maximum": 2000, "minimum": 1, "default": 25 }, "maxContactsPerCompany": { "type": "integer", "maximum": 100, "minimum": 0 }, "cursor": { "type": "string", "description": "Cursor", "maxLength": 2048 }, "excludeEmails": { "type": "array", "maxItems": 500, "items": { "type": "string", "minLength": 1, "maxLength": 2048 } }, "excludeDomains": { "type": "array", "maxItems": 500, "items": { "type": "string", "minLength": 1, "maxLength": 2048 } }, "excludeLinkedInURLs": { "type": "array", "maxItems": 500, "items": { "type": "string", "minLength": 1, "maxLength": 2048 } } }, "additionalProperties": false } ``` ## Published example This is the provider tool’s published example. Replace example values with the user’s requested inputs, respecting the schema; do not execute an example merely to test a connection. ```json { "tool_id": "leadsforge/search-people", "input": { "companyDomains": { "include": [ "salesforge.ai" ] }, "limit": 2 } } ``` ## Execute and retrieve Inspect again before execution, explain the price and obtain the required authority. Use MCP run_tool or POST /v1/run with this tool ID, valid input and an idempotency key. Save the returned run ID and follow the actual state. If Agentik answers that the tool is temporarily unavailable, do not retry it blindly; use discovery to propose an alternative. A partial or uncertain result can still have consumed provider resources. Consult [billing](/docs/billing.md), [idempotency](/docs/idempotency.md) and [asynchronous results](/docs/async.md). Licence: Provider data use is subject to the Leadsforge agreement; redistribution terms must cover Agentik.. [Provider documentation](https://api.leadsforge.ai/public/swagger/index.html) [REST inspection](https://api.agentik.cc/v1/tools/leadsforge/search-people) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md) --- [HTML page](/providers/leadsforge/search-people) · [Agent index](/llms.txt)