# 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 %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://documentation.scrapin.io/api/readme-1.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.