# Person Profile Endpoint

The **Person Profile** endpoint allows you to retrieve a complete and structured person profile from a Social URL. It is the fastest way to enrich a single person record with professional, educational, and contextual company information.

This endpoint is ideal when you already have a social profile link and need to transform it into structured data.

| Aspect       | Description                                                                                                           |
| ------------ | --------------------------------------------------------------------------------------------------------------------- |
| **Purpose**  | Convert a Social profile URL into a structured **person object** with job, education, skills, and context.            |
| **Input**    | A Social profile URL (e.g., `https://www.social.com/janedoe`).                                                        |
| **Output**   | A JSON object containing identity, career history, education, skills, and a linked **company object** when available. |
| **Credits**  | Each successful call consumes **1 credit**.                                                                           |
| **Best for** | Lead enrichment, recruiting snapshots, updating contact records before outreach.                                      |

### Objects structure

The response is divided into two main objects:

#### **Person object**

Includes all information related to an individual’s LinkedIn 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 %}