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

| Aspect       | Description                                                                                                                                                              |
| ------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **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.

{% hint style="warning" %}
**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.\
\ <a href="https://app.scrapin.io/auth/register" class="button primary">Sign up to access the full API Reference</a>
{% endhint %}