# searchProfessionals

**Identifier:** `crustdata_searchProfessionals`

**Provider:** [Crustdata](https://kirha.com/providers/crustdata.md)

Search professionals by current job title, employer, seniority, function, location, past employer, school or skill, returning name, title, employer and LinkedIn profile URL. Use it to find the people holding a role at a company or matching a profile, e.g., data engineers at Qonto.

## Run it with the CLI

```bash
kirha tools run crustdata_searchProfessionals \
  --input '{}'
```

`--input` takes a JSON object that matches the input schema. Pass `--input -` to read it from stdin.

## Call it over HTTP

```bash
curl https://api.kirha.com/tools/v1/execute \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: **********' \
  --data '{
  "tool_name": "crustdata_searchProfessionals",
  "input": {}
}'
```

Replace the stars with an API key from https://app.kirha.com/api-keys.

## Input schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "company": {
      "description": "Current employer name, e.g., Qonto",
      "minLength": 2,
      "type": "string"
    },
    "companyDomain": {
      "description": "Website domain of the current employer, more exact than the name, e.g., qonto.com",
      "minLength": 4,
      "type": "string"
    },
    "country": {
      "description": "Country where the person is based, e.g., France",
      "minLength": 2,
      "type": "string"
    },
    "cursor": {
      "description": "nextCursor of the previous page",
      "minLength": 8,
      "type": "string"
    },
    "functions": {
      "items": {
        "enum": [
          "Engineering",
          "Sales",
          "Marketing",
          "Operations",
          "Finance",
          "Research",
          "Product Management",
          "Customer Success and Support",
          "Human Resources",
          "Legal",
          "Consulting",
          "Arts and Design"
        ],
        "type": "string"
      },
      "minItems": 1,
      "type": "array"
    },
    "limit": {
      "default": 10,
      "maximum": 25,
      "minimum": 1,
      "type": "integer"
    },
    "name": {
      "minLength": 2,
      "type": "string"
    },
    "pastCompany": {
      "minLength": 2,
      "type": "string"
    },
    "recentlyChangedJobs": {
      "type": "boolean"
    },
    "school": {
      "minLength": 2,
      "type": "string"
    },
    "seniorities": {
      "items": {
        "enum": [
          "CXO",
          "Vice President",
          "Director",
          "Experienced Manager",
          "Entry Level Manager",
          "Owner / Partner",
          "Senior",
          "Entry Level",
          "Strategic",
          "In Training"
        ],
        "type": "string"
      },
      "minItems": 1,
      "type": "array"
    },
    "skill": {
      "minLength": 2,
      "type": "string"
    },
    "title": {
      "description": "Words of the current job title, e.g., head of data",
      "minLength": 2,
      "type": "string"
    }
  },
  "type": "object"
}
```

## Output schema

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "additionalProperties": false,
  "properties": {
    "context": {
      "type": "string"
    },
    "nextCursor": {
      "type": "string"
    },
    "people": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "company": {
            "type": "string"
          },
          "function": {
            "type": "string"
          },
          "headline": {
            "type": "string"
          },
          "inRoleSince": {
            "type": "string"
          },
          "linkedinUrl": {
            "type": "string"
          },
          "location": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "seniority": {
            "type": "string"
          },
          "title": {
            "type": "string"
          }
        },
        "type": "object"
      },
      "type": "array"
    },
    "total": {
      "type": "number"
    }
  },
  "required": [
    "context",
    "total",
    "people"
  ],
  "type": "object"
}
```

-----

[All Crustdata tools](https://kirha.com/providers/crustdata.md) · [< Back to tools list](https://kirha.com/tools.md)