# Icypeas people count

Count matching people without consuming credits. Needs query.

Count matching people without consuming credits.

- Tool ID: `icypeas/count-people`
- Name in the catalog: Count people
- Provider: [Icypeas](/providers/icypeas.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": {
    "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
    }
  },
  "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/count-people",
  "input": {
    "query": {
      "currentCompanyWebsite": {
        "include": [
          "icypeas.com"
        ]
      }
    }
  }
}
```

## 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/count-people) · [OpenAPI](/openapi.json) · [Connection guide](/connect.md)

---

[HTML page](/providers/icypeas/count-people) · [Agent index](/llms.txt)