Person Match Endpoint
The Person Match endpoint allows you to retrieve a complete and structured person profile starting from partial information such as name, company, domain, or email. It is designed for cases where you don’t already have a Social URL but need to identify and enrich the correct profile automatically.
This endpoint is ideal when you have limited datapoints and want to match them to the right person profile on social networks.
Purpose
Identify and enrich the correct person using partial data (name, company, domain, email) — no Social URL required.
Input
Any combination of: first/last name, company name, company domain, email (work or personal), and optionally location for disambiguation.
Output
A structured person object and a linked company object when available. Responses may include basic match metadata (e.g., resolved Social URL, match status).
Credits
Typically 1 credit per successful match (adjust to your billing rules).
Best for
CRM enrichment without URLs, deduplication, contact resolution, recruiting lookups, and data quality workflows.
Objects Structure
The response is divided into two main objects:
Person object
Includes all information related to an individual’s profile, such as:
Identity: First name, last name, headline, Social URL, profile photo.
Location: City, region/state, country.
Professional signals: Current title and company, follower count, premium/badge info.
Career history: List of past roles and companies with dates.
Education: Schools, degrees, fields of study, and dates.
Skills & languages: Declared skills and spoken languages.
Certifications: Certificates and issuing organizations, when available.
Company object
Provides structured context about the person’s current company:
Company name, Social URL, domain, and industry.
Employee count and size range.
Headquarters location.
Founded year.
Website, tagline, and description.
Important Notice
This documentation is only a preview of our API. It provides a high-level overview of what the API can do and which types of data objects you can expect. The official API Reference — including full technical specifications, JSON schemas, sample results, error codes, and authentication details — is only available after signing up to our platform.
Last updated
Was this helpful?