Skip to main content
POST
https://api.peoplecontext.com
/
v1
/
person
/
discover
Person Discovery API
curl --request POST \
  --url https://api.peoplecontext.com/v1/person/discover \
  --header 'Authorization: <authorization>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "linkedin": "<string>"
}
'
{
  "socials": [
    {
      "link": "<string>",
      "confidence": 123
    }
  ]
}

​
Endpoint

POST /v1/person/discover
Given a LinkedIn username, this endpoint discovers related profiles on other platforms (GitHub, Twitter/X) using search and entity matching.

​
Authentication

​
Authorization
string
required
Bearer token with your API key: Bearer YOUR_API_KEY

​
Request Parameters

​
Request Body (JSON)

​
linkedin
string
required
LinkedIn username to discover profiles for.Example: "williamhgates"

​
Response

​
Success Response (200 OK)

​
socials
array
Array of discovered social profiles.
​
link
string
URL of the discovered profile.
​
confidence
number
Confidence score from 0.0 to 1.0 that the profile belongs to the same person. Only results with confidence >= 0.7 are returned.

​
Error Responses

  • 400 Bad Request - LinkedIn username is required
  • 401 Unauthorized - Missing or invalid API key
  • 404 Not Found - LinkedIn profile not found in our index

​
Examples

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": [
    {
      "link": "https://github.com/BillGates",
      "confidence": 0.95
    },
    {
      "link": "https://x.com/BillGates",
      "confidence": 0.92
    }
  ]
}