Skip to main content
POST
Person Discovery API

Endpoint

Given a username or profile URL for any supported platform, this endpoint discovers the same person’s profiles on the other platforms using index lookups, search, and entity matching.

Authentication

string
required
Bearer token with your API key: Bearer YOUR_API_KEY

Request 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"
You must provide exactly one identifier. Sending zero or more than one will return a 400 error.

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).
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, or url)
  • 401 Unauthorized - Missing or invalid API key
  • 429 Too Many Requests - Rate limit or quota exceeded

Examples


Sample Response