# Icypeas people search Search the B2B database with include/exclude and range filters; billed per returned result. Needs query. Search the B2B database with include/exclude and range filters; billed per returned result. Keep query and page size unchanged when reusing a pagination token. Priced at $0.019 per Icypeas credit (Basic plan). Charge observed results only. - Tool ID: `icypeas/find-people` - Name in the catalog: Find people - Provider: [Icypeas](/providers/icypeas.md) - Capability: [People search](/tools/b2b-data/people-search.md) - Price: $0.00038 per lead - Authentication: an authorised Agentik workspace is required for execution, including zero-price tools. ## Pricing contract The provider’s price, with no markup. Billed for measured usage. ```json { "model": "per_unit", "amountUsd": 0.00038, "maxUnits": 200, "unitsPath": "leads", "requireUnits": true, "maxUnitsField": "pagination.size" } ``` Pricing source: [https://www.icypeas.com/pricing](https://www.icypeas.com/pricing). Account on the Icypeas Basic monthly plan ($19/1,000 credits, $0.019/credit), confirmed by the owner on 2026-09-30.. Price verification date: 2026-10-08. ## Complete input schema ```json { "type": "object", "properties": { "query": { "type": "object", "properties": { "firstname": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "lastname": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "currentJobTitle": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "pastJobTitle": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "school": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "languages": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "skills": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "location": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "profileLocation": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "workLocation": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "keyword": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "totalYearsOfExperience": { "type": "object", "properties": { ">": { "type": "integer", "minimum": 0 }, "<": { "type": "integer", "minimum": 0 }, ">=": { "type": "integer", "minimum": 0 }, "<=": { "type": "integer", "minimum": 0 } }, "required": [], "additionalProperties": false, "minProperties": 1 }, "timeInCurrentCompany": { "type": "object", "properties": { ">": { "type": "integer", "minimum": 0 }, "<": { "type": "integer", "minimum": 0 }, ">=": { "type": "integer", "minimum": 0 }, "<=": { "type": "integer", "minimum": 0 } }, "required": [], "additionalProperties": false, "minProperties": 1 }, "currentCompanyName": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "currentCompanyId": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "currentCompanyWebsite": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "currentCompanyUrn": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "currentCompany.type": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "currentCompany.industry": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "currentCompany.location": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "currentCompany.keyword": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "currentCompany.headcount": { "type": "object", "properties": { ">": { "type": "integer", "minimum": 0 }, "<": { "type": "integer", "minimum": 0 }, ">=": { "type": "integer", "minimum": 0 }, "<=": { "type": "integer", "minimum": 0 } }, "required": [], "additionalProperties": false, "minProperties": 1 }, "currentCompany.revenue": { "type": "object", "properties": { ">": { "type": "integer", "minimum": 0 }, "<": { "type": "integer", "minimum": 0 }, ">=": { "type": "integer", "minimum": 0 }, "<=": { "type": "integer", "minimum": 0 } }, "required": [], "additionalProperties": false, "minProperties": 1 }, "currentCompany.headcountGrowth": { "type": "object", "properties": { "timespan": { "type": "string", "enum": [ "6months", "12months", "24months" ] }, "min": { "type": "number", "minimum": -100, "maximum": 10000 }, "max": { "type": "number", "minimum": -100, "maximum": 10000 } }, "required": [ "timespan" ], "additionalProperties": false }, "pastCompanyName": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "pastCompanyId": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "pastCompanyWebsite": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "pastCompanyUrn": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "pastCompany.type": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "pastCompany.industry": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "pastCompany.location": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "pastCompany.keyword": { "type": "object", "properties": { "include": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 }, "exclude": { "type": "array", "items": { "type": "string", "maxLength": 2048, "minLength": 1 }, "minItems": 0, "maxItems": 200 } }, "required": [], "additionalProperties": false }, "pastCompany.headcount": { "type": "object", "properties": { ">": { "type": "integer", "minimum": 0 }, "<": { "type": "integer", "minimum": 0 }, ">=": { "type": "integer", "minimum": 0 }, "<=": { "type": "integer", "minimum": 0 } }, "required": [], "additionalProperties": false, "minProperties": 1 }, "pastCompany.revenue": { "type": "object", "properties": { ">": { "type": "integer", "minimum": 0 }, "<": { "type": "integer", "minimum": 0 }, ">=": { "type": "integer", "minimum": 0 }, "<=": { "type": "integer", "minimum": 0 } }, "required": [], "additionalProperties": false, "minProperties": 1 }, "pastCompany.headcountGrowth": { "type": "object", "properties": { "timespan": { "type": "string", "enum": [ "6months", "12months", "24months" ] }, "min": { "type": "number", "minimum": -100, "maximum": 10000 }, "max": { "type": "number", "minimum": -100, "maximum": 10000 } }, "required": [ "timespan" ], "additionalProperties": false } }, "required": [], "additionalProperties": false }, "pagination": { "type": "object", "properties": { "size": { "type": "integer", "minimum": 1, "maximum": 200, "default": 10 }, "token": { "type": "string", "maxLength": 100000 } }, "required": [], "additionalProperties": false, "default": { "size": 10 } } }, "required": [ "query" ], "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": "icypeas/find-people", "input": { "query": { "currentCompanyWebsite": { "include": [ "icypeas.com" ] } }, "pagination": { "size": 1 } } } ``` ## 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: Use and redistribution subject to the Icypeas agreement.. [Provider documentation](https://api-doc.icypeas.com/leads-db/find-people) [REST inspection](https://api.agentik.cc/v1/tools/icypeas/find-people) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md) --- [HTML page](/providers/icypeas/find-people) · [Agent index](/llms.txt)