API Reference
Posts
Query feed posts and their engagement data.
Post routes let you list and read feed posts, query engagement charts and top-performing content, and inspect scheduled posts.
List posts
Retrieve posts for an account:
const [error, posts] = await account.request("GET /posts", {
query: { limit: 20 },
})
if (!error) {
for (const post of posts.list) {
console.log(post.text, `👍 ${post.favoritesCount} ❤️ ${post.tipsAmount}`)
}
}Get a single post
const [error, post] = await account.request("GET /posts/:id", {
pathParams: { id: "11111" },
})
if (!error) {
console.log(post.text, post.media)
}Post analytics
Engagement chart
const [error, chart] = await account.request("GET /posts/chart", {
query: { startDate: "2026-01-01", endDate: "2026-03-31" },
})Top-performing posts
const [error, top] = await account.request("GET /posts/top", {
query: {
startDate: "2026-01-01",
endDate: "2026-03-31",
by: "tips",
offset: 0,
skip_users: "all",
},
})
if (!error) {
for (const post of top.items) {
console.log(post.text, `$${post.tipsAmount}`)
}
}Scheduled posts
List scheduled posts
const [error, schedules] = await account.request(
"GET /schedules/later/post",
{ query: { limit: 20 } },
)Collect post stats
Trigger a stats collection for specific posts:
const [error] = await account.request("POST /posts/stats-collect", {
body: {
actions: [
{
action: "view",
postId: "11111",
eventTime: "2026-03-31T12:00:00Z",
duration: 0,
},
],
},
})