> For the complete documentation index, see [llms.txt](https://developer.parvenu.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.parvenu.io/enrichments/profile-only/individual-lookup.md).

# Individual Lookup

Fetch one LinkedIn profile from a profile URL. Synchronous, returns the profile directly.

<mark style="color:green;">`POST`</mark> `/profile`

{% hint style="info" %}
Costs **0.1 credit** per call (10 profiles for 1 credit). Set `full_profile` to `true` for the complete profile — education, full work history, open-to-work status, skills, certifications — which costs **0.3 credit** per call.
{% endhint %}

{% hint style="warning" %}
The field is `person_linkedin_url`. The older `profile_url` name is no longer accepted and returns a 422.
{% endhint %}

The separate `/full_profile` route has been removed. It took the same inputs, ran the same flow and charged the same 0.3 credits, so `full_profile: true` here is a drop-in replacement.

**Headers**

| Name         | Value              |
| ------------ | ------------------ |
| Content-Type | `application/json` |

**Body**

| Name                  | Type    | Description                                                                           |
| --------------------- | ------- | ------------------------------------------------------------------------------------- |
| `api_key`             | string  | Your API Key.                                                                         |
| `person_linkedin_url` | string  | The LinkedIn profile URL to fetch data from.                                          |
| `full_profile`        | boolean | Optional. Default `false` (0.1 credit). `true` returns the full profile (0.3 credit). |

**Response**

The person record sits directly under `data`. The same field names are used on every route that returns a person, so one piece of client code reads them all.

| Field                  | Type    | Description                                                                                             |
| ---------------------- | ------- | ------------------------------------------------------------------------------------------------------- |
| `person_name`          | string  | Full name.                                                                                              |
| `first_name`           | string  | First name.                                                                                             |
| `last_name`            | string  | Last name.                                                                                              |
| `current_title`        | string  | Current job title.                                                                                      |
| `headline`             | string  | The headline on the profile.                                                                            |
| `person_linkedin_url`  | string  | The profile URL.                                                                                        |
| `organization_name`    | string  | The company the person works at now.                                                                    |
| `company_linkedin_url` | string  | That company's LinkedIn page.                                                                           |
| `city`                 | string  | City.                                                                                                   |
| `state`                | string  | State or region.                                                                                        |
| `country`              | string  | Country name.                                                                                           |
| `country_code`         | string  | Two-letter country code, lower case.                                                                    |
| `about`                | string  | The About section.                                                                                      |
| `open_to_work`         | boolean | Whether the person is open to work. `null` when the profile does not say.                               |
| `follower_count`       | number  | Followers.                                                                                              |
| `connection_count`     | number  | Connections.                                                                                            |
| `work_experience`      | array   | Past and present roles. Filled on a full profile.                                                       |
| `education_history`    | array   | Schools. Filled on a full profile.                                                                      |
| `skills`               | array   | Listed skills.                                                                                          |
| `profile_picture_url`  | string  | Profile photo.                                                                                          |
| `linkedin_id`          | string  | LinkedIn's own identifier for the profile.                                                              |
| `extra`                | object  | Anything the source returned that has no name above. Present only when there is something to put in it. |

See [Response Format](/getting-started/response-format.md) for the fields every endpoint returns.

**Example**

{% tabs %}
{% tab title="Input" %}

```json
{
  "api_key": "your_api_key",
  "person_linkedin_url": "https://www.linkedin.com/in/williamhgates/",
  "full_profile": false
}
```

{% endtab %}

{% tab title="Output — Basic" %}

```json
{
  "status": "success",
  "data": {
    "person_name": "Bill Gates",
    "first_name": null,
    "last_name": null,
    "current_title": "Chair, Gates Foundation and Founder, Breakthrough Energy",
    "headline": null,
    "person_linkedin_url": "https://www.linkedin.com/in/williamhgates",
    "organization_name": "Gates Foundation",
    "company_linkedin_url": null,
    "city": "Seattle",
    "state": "Washington",
    "country": "United States",
    "country_code": "us",
    "about": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft.",
    "open_to_work": null,
    "follower_count": 40527042,
    "connection_count": null,
    "work_experience": null,
    "education_history": null,
    "skills": null,
    "profile_picture_url": null,
    "linkedin_id": "williamhgates",
    "extra": {
      "posts": [
        {
          "title": "\"AIDS-free\" generation is no empty promise",
          "link": "https://www.linkedin.com/pulse/aids-free-generation-empty-promise-bill-gates-hbvue",
          "created_at": "2026-07-12T00:00:00.000Z"
        }
      ]
    }
  },
  "credits_used": 0.1,
  "credits_remaining": 4822.9,
  "success": true
}
```

{% endtab %}

{% tab title="Output — Full profile" %}

```json
{
  "status": "success",
  "data": {
    "person_name": "Bill Gates",
    "first_name": "Bill",
    "last_name": "Gates",
    "current_title": "Chair, Gates Foundation and Founder, Breakthrough Energy",
    "headline": "Chair, Gates Foundation and Founder, Breakthrough Energy",
    "person_linkedin_url": "https://www.linkedin.com/in/williamhgates",
    "organization_name": "Gates Foundation",
    "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation/",
    "city": "Seattle",
    "state": "Washington",
    "country": "United States",
    "country_code": "us",
    "about": "Chair of the Gates Foundation. Founder of Breakthrough Energy. Co-founder of Microsoft.",
    "open_to_work": false,
    "follower_count": 40527040,
    "connection_count": 8,
    "work_experience": [
      {
        "company_name": "Gates Foundation",
        "current_title": "Co-chair",
        "location": null,
        "start_date": "2000",
        "end_date": null,
        "is_current": true,
        "company_linkedin_url": "https://www.linkedin.com/company/gates-foundation/",
        "description": null,
        "employment_type": null
      }
    ],
    "education_history": [
      {
        "school_name": "Harvard University",
        "degree": null,
        "field_of_study": null,
        "start_date": "1973",
        "end_date": "1975",
        "school_linkedin_url": null,
        "extra": { "period": "1973 - 1975" }
      }
    ],
    "skills": [],
    "profile_picture_url": null,
    "linkedin_id": "ACoAAA8BYqEBCGLg_vT_ca6mMEqkpp9nVffJ3hc"
  },
  "credits_used": 0.3,
  "credits_remaining": 4822.7,
  "success": true
}
```

{% endtab %}

{% tab title="Output — Still running" %}

```json
{
  "status": "processing",
  "data": null,
  "credits_used": 0,
  "credits_remaining": 4823,
  "message": "The lookup is still running and is being collected in the background. Call again shortly and the record will be returned.",
  "success": true
}
```

{% endtab %}

{% tab title="Output — Not found" %}

```json
{
  "status": "not_found",
  "data": null,
  "credits_used": 0,
  "credits_remaining": 4823,
  "message": "No record was returned for this input.",
  "success": true
}
```

{% endtab %}

{% tab title="Error" %}

```json
{
  "status": "error",
  "error": {
    "code": "validation_error",
    "message": "person_linkedin_url: Field required"
  },
  "success": false
}
```

{% endtab %}
{% endtabs %}

To enrich every contact in a list in one call instead, use [List Lookup](/enrichments/profile-only/list-lookup.md).
