---
title: "Similar Profiles"
description: "Find profiles similar to a given person based on title, industry, and seniority."
---

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

# Similar Profiles

`GET /api/v1/person/similar`

Returns profiles similar to a given person based on title, industry, location, and seniority.

:::tip
Use this to expand a target list. If you have one ideal prospect, similar profiles can quickly surface more people with the same role and context.
:::

## Query parameters

| Parameter | Type | Required | Description |
|---|---|---|---|
| `id` | string | **Yes** | Kooperativa internal profile ID |
| `page` | integer | No | Page number (default: 1) |
| `per_page` | integer | No | Results per page (default: 10, max: 50) |

:::note
This endpoint requires a Kooperativa internal `id`, not a profile username or URL. Get the `id` from [Enrich Person](/people/enrich-person) first.
:::

## Code examples

```bash title="cURL"
curl "https://kooperativa.io/api/v1/person/similar?id=f9413465-c1b9-4129-ab9f-2234caf971b1" \
  -H "Authorization: Bearer ik_live_..."
```

```js title="JavaScript"
const res = await fetch(
  "https://kooperativa.io/api/v1/person/similar?id=f9413465-c1b9-4129-ab9f-2234caf971b1",
  { headers: { Authorization: `Bearer ${process.env.KOOPERATIVA_API_KEY}` } }
);
const { results, total } = await res.json();
```

## Response

```json
{
  "results": [
{
  "id": "b9847f21-...",
  "full_name": "Sundar Pichai",
  "current_title": "CEO",
  "current_company": "Google",
  "seniority": "c-level"
}
  ],
  "total": 1931,
  "page": 1,
  "per_page": 10
}
```

Source: https://docs.kooperativa.io/people/person-similar/index.mdx