> 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/post-enrichment/individual-lookup.md).

# Individual Lookup

Pull one person's recent LinkedIn posts. Synchronous, returns the posts directly.

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

{% hint style="info" %}
Costs **0.10 credit per post** returned, so cost scales with `max_record_fetch`. A profile with no posts is free. Returns the posts directly in the response, no list and no polling.
{% endhint %}

Pass a LinkedIn profile URL. The response contains an array of posts in `data.posts`.

**Headers**

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

**Body**

| Name                  | Type    | Description                                                                                                                   |
| --------------------- | ------- | ----------------------------------------------------------------------------------------------------------------------------- |
| `api_key`             | string  | Your API Key.                                                                                                                 |
| `person_linkedin_url` | string  | LinkedIn profile URL to pull posts for.                                                                                       |
| `max_record_fetch`    | integer | Optional. Maximum posts to return. Defaults to 10.                                                                            |
| `posted_limit`        | string  | Optional. How far back to look, relative to now: `any`, `1h`, `24h`, `week`, `month` (default), `3months`, `6months`, `year`. |

**Response**

The record is under `data`. See [Response Format](/getting-started/response-format.md) for the fields every endpoint returns.

| Field                 | Description                                                    |
| --------------------- | -------------------------------------------------------------- |
| `person_linkedin_url` | The profile the posts belong to.                               |
| `posts`               | Array of posts, newest first. Empty when the profile has none. |

Each post carries `post_url`, `post_text`, `post_type`, `date_posted`, `num_likes`, `num_comments` and `num_shares`. Anything the source returns that has no canonical name is kept under `extra`. The top-level `total` is the number of posts returned. When no posts are found, `status` is `not_found` and `data.posts` is an empty array.

**Example**

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

```json
{
  "api_key": "your_api_key",
  "person_linkedin_url": "https://www.linkedin.com/in/jane-doe-example/",
  "max_record_fetch": 2,
  "posted_limit": "year"
}
```

{% endtab %}

{% tab title="Output" %}

```json
{
  "status": "success",
  "data": {
    "person_linkedin_url": "https://www.linkedin.com/in/jane-doe-example/",
    "posts": [
      {
        "post_url": "https://www.linkedin.com/posts/jane-doe-example_activity-7488220267815612416",
        "post_text": "Excited to share that we just closed our Series B...",
        "post_type": "post",
        "date_posted": "2026-07-29",
        "num_likes": 74,
        "num_comments": 3,
        "num_shares": 1,
        "extra": {
          "id": "7488220267815612416",
          "account_type": "profile",
          "author_name": "Jane Doe"
        }
      }
    ]
  },
  "credits_used": 0.1,
  "credits_remaining": 7624.4,
  "total": 1,
  "message": "Saved 1 post(s), charged 0.1 credits",
  "success": true
}
```

{% endtab %}

{% tab title="Error" %}

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

{% endtab %}
{% endtabs %}

To pull posts for every contact in a list in one call instead, use [List Lookup](/enrichments/post-enrichment/list-lookup.md).