❗️
About Post IDs
Basically, Unipile uses base64 preformatted post IDs to simplify any interactions that require a post ID. These are the IDs to be used throughout, unless otherwise specified.

List user posts

To get a list of posts, use the List all User's Posts endpoint, specifying the ID of the user or company whose posts you want to retrieve.

To retrieve your own posts, set me as user_id.

📘
Note about pagination
Pagination on this endpoint uses exclusively the cursor parameter.

const { data } = await usersApi.getPostsList({
  path: {
    account_id: "acc_123456789",
    user_id: "user_id",
  },
});

posts = users_api.get_posts_list("user_id", "acc_123456789")

curl --request GET \
     --url https://api.unipile.com/v2/account_id/users/user_id/posts \
     --header 'accept: application/json'

Retrieve post from ID

To get a single post, use the Get a Post endpoint, specifying the ID of the post you are looking for.

On this specific endpoint, LinkedIn native Post IDs are accepted (e.g. activity:7461257878499151234, ugcPost:7461257878499155678).

const { data } = await postsApi.getPost({
  path: {
    account_id: "acc_123456789",
    post_id: "post_id",
  },
});

post = posts_api.get_post("post_id", "acc_123456789")

curl --request GET \
     --url https://api.unipile.com/v2/account_id/posts/post_id \
     --header 'accept: application/json'

Retrieve user activity

Use List all User's Comments or List all User's Reactions with a provider user ID to retrieve the activity exposed for that user. Follow each method's pagination parameters to retrieve subsequent pages. These endpoints start from a user; List all Post's Comments and List all Post's Reactions start from a post instead. Visibility remains subject to the connected account's access.

const { data } = await postsApi.getUserCommentsList({
  path: {
    account_id: "acc_123456789",
    user_id: "user_id",
  },
  query: {
    limit: 20,
  },
});

data = posts_api.get_user_comments_list(
    account_id='acc_123456789',
    user_id='user_id',
    limit=20,
)

curl --request GET \
  --url "https://api.unipile.com/v2/acc_123456789/users/user_id/comments?limit=20" \
  --header 'X-API-KEY: YOUR_API_KEY'

Retrieve reactions by a user

const { data } = await postsApi.getUserReactionsList({
  path: {
    account_id: "acc_123456789",
    user_id: "user_id",
  },
  query: {
    limit: 20,
  },
});

data = posts_api.get_user_reactions_list(
    account_id='acc_123456789',
    user_id='user_id',
    limit=20,
)

curl --request GET \
  --url "https://api.unipile.com/v2/acc_123456789/users/user_id/reactions?limit=20" \
  --header 'X-API-KEY: YOUR_API_KEY'