list_postsread onlyList posts
Returns posts for a profile, newest first, with filters for status, content type, and platform.
- Category
- Posts
- Calls
- GET/v1/posts
- Safe to auto-approve
- Yes. It only reads data.
Parameters
profileIdstringoptionalProfile to act on. Omit to use the profile this API key belongs to. Call list_profiles first when managing several customers.
pageintegeroptionalDefaults to 1.
limitintegeroptionalDefaults to 20, max 100.
statusenumoptionalFilter by lifecycle state.
One of:draftpending_approvalapprovedrejectedscheduledqueuedprocessingpublishedpartially_publishedfailedcancelled
contentTypeenumoptionalOne of:textimagevideo
platformenumoptionalOne of:facebookinstagramtiktoklinkedinyoutube
Example
A tool call as an MCP client would send it.
{
"name": "list_posts",
"arguments": {}
}