> ## Documentation Index
> Fetch the complete documentation index at: https://deepline.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Unipile: List User Posts

> List the posts written by a LinkedIn user or company. Includes SDK V2 guidance, input constraints, response fields, and Deepline credit cost.

List the posts written by a LinkedIn user or company.

> [!NOTE]
>
> Tool ID: `unipile_list_user_posts`

## Run this action

Use the TypeScript SDK for one call. Use `ctx.tools.execute(...)` inside a Play for durable calls, scheduled calls, or CSV processing.

```ts theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
import { Deepline } from 'deepline';

const deepline = await Deepline.connect();
const result = await deepline.tools.execute(
  'unipile_list_user_posts',
  {
    "account_id": "123456789",
    "identifier": "example_123"
  },
);

console.log(result.toolResponse.raw);
```

### CLI

```bash theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
deepline tools execute unipile_list_user_posts --input '{
  "account_id": "123456789",
  "identifier": "example_123"
}' --json
```

## Example response

The static output schema lacks the details for a reliable example. Use `deepline describe unipile_list_user_posts --json` for the complete live contract.

## Input reference

Returns a list of posts written by a user or a company.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `payload.cursor` | `string` | No | — | A cursor for pagination purposes. To get the next page of entries, you need to make a new request and fulfill this field with the cursor received in the preceding request. This process should be repeated until all entries have been retrieved. Minimum length: 1. |
| `payload.limit` | `integer` | No | — | A limit for the number of items returned in the response. The value can be set between 1 and 100. Minimum: 1. Maximum: 100. |
| `payload.is_company` | `boolean` | No | — | `Linkedin only` Set it to **"true"** if the posts are from a company. |
| `payload.account_id` | `string` | Yes | — | The id of the account to perform the request from. |
| `payload.identifier` | `string` | Yes | — | The entity's provider internal id. `Linkedin`: starts with ACo/ADo for users, while for companies it's a series of numbers. `Instagram`: use the provider\_id or the username of the user. |

<details>
  <summary>Show raw input schema</summary>

  ### Input JSON Schema

  ```json theme={"languages":{"custom":["/languages/deepline-prompt.json"]}}
  {
    "type": "object",
    "description": "Returns a list of posts written by a user or a company.",
    "properties": {
      "cursor": {
        "type": "string",
        "description": "A cursor for pagination purposes. To get the next page of entries, you need to make a new request and fulfill this field with the cursor received in the preceding request. This process should be repeated until all entries have been retrieved.",
        "minLength": 1
      },
      "limit": {
        "type": "integer",
        "description": "A limit for the number of items returned in the response. The value can be set between 1 and 100.",
        "minimum": 1,
        "maximum": 100
      },
      "is_company": {
        "type": "boolean",
        "description": "`Linkedin only` Set it to **\"true\"** if the posts are from a company."
      },
      "account_id": {
        "type": "string",
        "description": "The id of the account to perform the request from."
      },
      "identifier": {
        "type": "string",
        "description": "The entity's provider internal id. `Linkedin`: starts with ACo/ADo for users, while for companies it's a series of numbers. `Instagram`: use the provider_id or the username of the user."
      }
    },
    "required": [
      "account_id",
      "identifier"
    ],
    "additionalProperties": false
  }
  ```
</details>

## Output reference

Standard tool result payload.

| Name | Type | Required | Default | Details |
| - | - | - | - | - |
| `result.data` | `object` | Yes | — | Provider response payload. |
| `result.data.object` | `"PostList"` | Yes | — | Allowed: `PostList`. |
| `result.data.items` | `array` | Yes | — | — |
| `result.data.items[].provider` | `"LINKEDIN"` | Yes | — | — |
| `result.data.items[].id` | `string` | Yes | — | A unique identifier. |
| `result.data.items[].social_id` | `string` | Yes | — | A unique identifier to be used to add a comment or a reaction to the post. |
| `result.data.items[].share_url` | `string` | Yes | — | — |
| `result.data.items[].title` | `string` | No | — | — |
| `result.data.items[].text` | `string` | Yes | — | — |
| `result.data.items[].date` | `string` | Yes | — | — |
| `result.data.items[].parsed_datetime` | `string` | Yes | — | — |
| `result.data.items[].reaction_counter` | `number` | Yes | — | — |
| `result.data.items[].comment_counter` | `number` | Yes | — | — |
| `result.data.items[].repost_counter` | `number` | Yes | — | — |
| `result.data.items[].impressions_counter` | `number` | Yes | — | — |
| `result.data.items[].user_reacted` | `"LIKE" \| "PRAISE" \| "APPRECIATION" \| "EMPATHY" \| "INTEREST" \| "ENTERTAINMENT"` | No | — | — |
| `result.data.items[].author` | `object` | Yes | — | — |
| `result.data.items[].author.public_identifier` | `string \| null` | Yes | — | — |
| `result.data.items[].author.id` | `string \| null` | Yes | — | — |
| `result.data.items[].author.name` | `string \| null` | Yes | — | — |
| `result.data.items[].author.is_company` | `boolean` | Yes | — | — |
| `result.data.items[].author.headline` | `string` | No | — | — |
| `result.data.items[].author.profile_picture_url` | `string` | No | — | — |
| `result.data.items[].written_by` | `object` | No | — | — |
| `result.data.items[].written_by.id` | `string` | Yes | — | — |
| `result.data.items[].written_by.public_identifier` | `string` | Yes | — | — |
| `result.data.items[].written_by.name` | `string` | Yes | — | — |
| `result.data.items[].permissions` | `object` | Yes | — | — |
| `result.data.items[].permissions.can_react` | `boolean` | Yes | — | — |
| `result.data.items[].permissions.can_share` | `boolean` | Yes | — | — |
| `result.data.items[].permissions.can_post_comments` | `boolean` | Yes | — | — |
| `result.data.items[].is_repost` | `boolean` | Yes | — | — |
| `result.data.items[].repost_id` | `string` | No | — | The republication ID. |
| `result.data.items[].repost_parsed_datetime` | `string` | No | — | — |
| `result.data.items[].reposted_by` | `object` | No | — | — |
| `result.data.items[].reposted_by.public_identifier` | `string \| null` | Yes | — | — |
| `result.data.items[].reposted_by.id` | `string \| null` | Yes | — | — |
| `result.data.items[].reposted_by.name` | `string \| null` | Yes | — | — |
| `result.data.items[].reposted_by.is_company` | `boolean` | Yes | — | — |
| `result.data.items[].reposted_by.headline` | `string` | No | — | — |
| `result.data.items[].reposted_by.profile_picture_url` | `string` | No | — | — |
| `result.data.items[].repost_content` | `object` | No | — | The post shared in the current publication. |
| `result.data.items[].repost_content.id` | `string` | Yes | — | A unique identifier. |
| `result.data.items[].repost_content.date` | `string` | Yes | — | — |
| `result.data.items[].repost_content.parsed_datetime` | `string` | Yes | — | — |
| `result.data.items[].repost_content.attachments` | `array` | Yes | — | — |
| `result.data.items[].repost_content.attachments[].id` | `string` | Yes | — | — |
| `result.data.items[].repost_content.attachments[].file_size` | `number` | No | — | — |
| `result.data.items[].repost_content.attachments[].unavailable` | `boolean` | Yes | — | — |
| `result.data.items[].repost_content.attachments[].mimetype` | `string` | No | — | — |

The table shows the first 50 fields. Use the live contract below for every field.

> [!NOTE]
>
> This output schema is too large for an inline display. Read the complete live contract with `deepline describe unipile_list_user_posts --json`.

## Deepline cost

* Pricing model: `fixed` (per call).
* Estimated Deepline credits: `0` per pricing unit.
* Provider-native pricing may still exist outside Deepline credit billing.

## Related documentation

* [Unipile provider guide](https://deepline.com/docs/providers/unipile/guide.md)
* [SDK V2 quickstart](https://deepline.com/docs/sdk-v2/quickstart.md)
* [SDK reference](https://deepline.com/docs/sdk-v2/sdk-reference.md)
* [Run tools across a CSV](https://deepline.com/docs/sdk-v2/batch-csv.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.