> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kalent.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Search talents

> Find professional profiles matching job titles, locations, and keywords.

<Warning>
  This is a legacy endpoint. We recommend migrating to [v1 Search
  Talents](/api-reference/search-talents) which supports 17 filter types,
  required/optional modifiers, and ranked results.
</Warning>

<Card title="First time? Set up Authentication" icon="key" href="/authentication">
  Learn how to authenticate your API requests with your API key.
</Card>

Search the Kalent talent database using job titles, cities, keywords, and contract type as query parameters. Returns up to 5 matching profiles per request.

## Query parameters

<ParamField query="jobTitles" type="string[]">
  One or more job titles to search for. Repeat the parameter for multiple values.

  ```
  ?jobTitles=Software Engineer&jobTitles=Product Designer
  ```
</ParamField>

<ParamField query="cities" type="string[]">
  One or more city names. Repeat the parameter for multiple values.

  ```
  ?cities=Paris&cities=Lyon
  ```
</ParamField>

<ParamField query="keywords" type="string[]">
  Free-text keywords to match against profiles. Repeat the parameter for multiple values.

  ```
  ?keywords=React&keywords=TypeScript
  ```
</ParamField>

<ParamField query="contractType" type="string">
  Filter by contract type. Only accepted value: `Freelance`.
</ParamField>

## Example request

```bash theme={null}
curl -G "https://app.kalent.ai/api/v0.1/search/talents" \
  -H "x-api-key: YOUR_API_KEY" \
  --data-urlencode "jobTitles=Software Engineer" \
  --data-urlencode "cities=Paris" \
  --data-urlencode "keywords=React"
```

## Response

<CodeGroup>
  ```json 200 — Success theme={null}
  {
    "success": true,
    "data": {
      "talents": [
        {
          "id": "clx...",
          "firstName": "Marie",
          "lastName": "D.",
          "headline": "Senior Software Engineer",
          "linkedinUrl": "https://linkedin.com/in/marie-d"
        }
      ],
      "estimationCount": 342,
      "searchTransactionId": "clx..."
    }
  }
  ```

  ```json 400 — Invalid parameters theme={null}
  {
    "success": false,
    "error": "Invalid query parameters",
    "details": { ... }
  }
  ```

  ```json 401 — Authentication error theme={null}
  {
    "success": false,
    "error": "Invalid API key"
  }
  ```

  ```json 500 — Server error theme={null}
  {
    "success": false,
    "error": "An error occurred during search talents",
    "debugTrackingCode": "V1StGXR8_Z5jdHi6B-myT"
  }
  ```
</CodeGroup>