Guides

Reading and engaging

Publishing is half of managing an account. These endpoints cover the other half: what happened, what people said, and answering them.

What happened

GET /v1/notifications returns likes, replies, mentions, follows, reposts and quotes from every connected network, newest first, in one shape. It is the read to start from when an agent asks "what needs my attention".

curl https://api.postlake.dev/v1/notifications?limit=25 \
  -H "authorization: Bearer $POSTLAKE_KEY"

Every list tells you what it could not read

Responses are { items, cursor, problems }. problems is the important part. A network that is unreachable, unauthorised or simply not supported yet is named there, so an empty items never has to stand in for "we could not look".

{
  "items": [ ... ],
  "cursor": "eyJhY2Nf...",
  "problems": [
    { "platform": "tiktok", "reason": "We cannot read this on tiktok yet." }
  ]
}

Paging

Pass cursor back exactly as you got it. Never build or parse one: a cross-network read encodes a separate position per network inside it, and the contents will change. cursor: null means the end.

Replies on a post

GET /v1/posts/{id}/comments reads the conversation under something you published, across every network it went to. Replies nest one level; going deeper is another call.

Engaging

One endpoint, one vocabulary. POST /v1/engagements takes an action of like, unlike, repost, unrepost, follow, unfollow, block, unblock, mute or unmute.

curl -X POST https://api.postlake.dev/v1/engagements \
  -H "authorization: Bearer $POSTLAKE_KEY" \
  -H "content-type: application/json" \
  -d '{"account":"acc_7f3k9","action":"like","target":"https://bsky.app/profile/alice.bsky.social/post/3l..."}'

target is a post (a uri or its web url) for likes and reposts, or a handle for follows, blocks and mutes. Engaging is free and never spends credits.

A network that does not support an action refuses and names what it does support, rather than quietly doing nothing. Check the platform tables or GET /v1/platforms first.

Which networks can do this

Reading and engaging are being rolled out network by network, starting with Bluesky, which needs no app review. The platform support page lists exactly what each one can do today, generated from the same table the API validates against.