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

# Profile Discovery

> Find related social media profiles across platforms from any LinkedIn, GitHub, or Twitter/X identity

## Overview

Profile Discovery takes a username from any supported platform — LinkedIn, GitHub, or Twitter/X — and finds the same person's profiles on the other platforms. It combines index lookups, search engine results, and LLM-powered entity matching to return high-confidence matches.

<Info>
  **Input**: A single username or profile URL for LinkedIn, GitHub, or Twitter/X\
  **Output**: Matching profiles across all three platforms, each with confidence score, profile context, and direct link\
  **Confidence threshold**: Only results scoring >= 0.45 are returned
</Info>

***

## How It Works

1. **Profile lookup** - The input username is looked up in our index (and live APIs where available) to get the person's name, headline, and profile context
2. **Cross-platform resolution** - Known linkages are resolved via reverse index lookups, embedded URLs in bios, and direct field mappings (e.g. GitHub's `twitter_username` field)
3. **Candidate search** - For any platforms not yet resolved, Google SERP is queried to find candidate profiles
4. **Entity matching** - An LLM scores each candidate on how likely it belongs to the same person, using profile context from both sides
5. **Filtering** - Results below the 0.45 confidence threshold are dropped, organization/company accounts are excluded, and duplicates are removed (keeping the highest confidence per platform)

***

## Quick Start

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://api.peoplecontext.com/v1/person/discover" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"linkedin": "williamhgates"}'
  ```

  ```python Python theme={null}
  import requests

  response = requests.post(
      "https://api.peoplecontext.com/v1/person/discover",
      headers={"Authorization": "Bearer YOUR_API_KEY"},
      json={"linkedin": "williamhgates"}
  )

  for social in response.json().get("socials", []):
      print(f"{social['platform']}: {social['username']} ({social['confidence']})")
  ```
</CodeGroup>

```json Sample Response theme={null}
{
  "socials": [
    {
      "platform": "linkedin",
      "username": "williamhgates",
      "link": "https://linkedin.com/in/williamhgates",
      "confidence": 1.0,
      "context": "name: Bill Gates\n- headline: Co-Chair, Bill & Melinda Gates Foundation\n..."
    },
    {
      "platform": "github",
      "username": "BillGates",
      "link": "https://github.com/BillGates",
      "confidence": 0.95,
      "context": "name: Bill Gates\n- username: BillGates\n- url: github.com/BillGates\n- company: Bill & Melinda Gates Foundation\n..."
    },
    {
      "platform": "twitter",
      "username": "BillGates",
      "link": "https://x.com/BillGates",
      "confidence": 0.92,
      "context": "name: Bill Gates\n- username: @BillGates\n- bio: Sharing things to help all people live healthy, productive lives...\n..."
    }
  ]
}
```

***

## Starting from Any Platform

You can discover profiles starting from any of the three supported platforms:

<CodeGroup>
  ```bash "From GitHub" theme={null}
  curl -X POST "https://api.peoplecontext.com/v1/person/discover" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"github": "torvalds"}'
  ```

  ```bash "From Twitter/X" theme={null}
  curl -X POST "https://api.peoplecontext.com/v1/person/discover" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"twitter": "elaborateshrug"}'
  ```

  ```bash "From URL" theme={null}
  curl -X POST "https://api.peoplecontext.com/v1/person/discover" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"url": "https://github.com/torvalds"}'
  ```
</CodeGroup>

***

## Use Cases

* **Recruiting** - Find a candidate's GitHub to assess technical skills alongside their LinkedIn
* **Sales intelligence** - Build a fuller picture of prospects across platforms
* **Identity resolution** - Link profiles that belong to the same person across data sources
* **Enrichment** - Use the `context` field to get a rich text summary of each discovered profile

***

## Limitations

* Discovery relies on public search results, so profiles with very common names may produce fewer high-confidence matches
* The `context` field may be `null` if profile data is unavailable for enrichment

For the full API specification, see the [API Reference](/api-reference/person/discover).