Skip to main content

​
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.
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

​
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

curl -X POST "https://api.peoplecontext.com/v1/person/discover" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"linkedin": "williamhgates"}'
Sample Response
{
  "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: 
curl -X POST "https://api.peoplecontext.com/v1/person/discover" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"github": "torvalds"}'

​
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.