Person Discovery API
Person Endpoints
Person Discovery API
Discover related social media profiles from a LinkedIn, GitHub, or Twitter/X username
POST
Person Discovery API
Endpoint
Authentication
string
required
Bearer token with your API key:
Bearer YOUR_API_KEYRequest Parameters
Request Body (JSON)
Provide exactly one of the following fields:string
LinkedIn username or profile URL.Examples:
"williamhgates", "https://www.linkedin.com/in/williamhgates"string
GitHub username or profile URL.Examples:
"torvalds", "https://github.com/torvalds"string
Twitter/X username or profile URL.Examples:
"elonmusk", "https://x.com/elonmusk"string
A profile URL from any supported platform. The platform is auto-detected from the URL.Examples:
"https://github.com/torvalds", "https://linkedin.com/in/williamhgates", "https://x.com/elonmusk"Response
Success Response (200 OK)
array
Array of discovered social profiles. The input profile is always included first with a confidence of 1.0.
string
Platform identifier:
"github", "linkedin", or "twitter".string
Username on the platform (without URL prefix).
string
Full profile URL.
number
Confidence score from 0.0 to 1.0 that the profile belongs to the same person. The input profile always has confidence 1.0. Only discovered profiles scoring >= 0.45 are returned.
string | null
Rich text summary of the profile, including bio, headline, experience, skills, and other relevant data. Useful for downstream enrichment or display. May be
null if profile data is unavailable.Error Responses
- 400 Bad Request - Must provide exactly one identifier (
linkedin,github,twitter, orurl) - 401 Unauthorized - Missing or invalid API key
- 429 Too Many Requests - Rate limit or quota exceeded