Post Performance
List performance for posts published through dopost.
List performance for posts published through dopost.
/api/v1/analytics/postsList analyzed dopost posts with cursor pagination.
This endpoint accepts the common Analytics range, platform and account filters, plus:
| Parameter | Type | Default | Description |
|---|---|---|---|
sortBy | string | overall | overall, likes, engagements, comments, reach, views, shares, or saves |
limit | number | 20 | 1–100 results |
cursor | string | — | Opaque cursor from the previous response |
curl 'https://dopost.co/api/v1/analytics/posts?days=30&sortBy=engagements&limit=20' \
--header 'x-api-key: <apiKey>'curl 'https://dopost.co/api/v1/analytics/posts?days=30&sortBy=engagements&limit=20' \
--header 'x-api-key: <apiKey>'{
"posts": [
{
"postId": "post_123",
"accountId": "acc_123",
"platform": "THREADS",
"caption": "Product update",
"publishedAt": "2026-08-20T16:00:00.000Z",
"dataThrough": "2026-08-21T16:05:00.000Z",
"providerLinkAvailable": true,
"metrics": [
{
"key": "views",
"value": 920,
"unit": "count",
"aggregation": "POINT",
"availability": "available"
},
{
"key": "likes",
"value": 45,
"unit": "count",
"aggregation": "POINT",
"availability": "available"
}
]
}
],
"nextCursor": null,
"hasMore": false,
"meta": { "counts": { "eligible": 8, "analyzed": 7 } }
}{
"posts": [
{
"postId": "post_123",
"accountId": "acc_123",
"platform": "THREADS",
"caption": "Product update",
"publishedAt": "2026-08-20T16:00:00.000Z",
"dataThrough": "2026-08-21T16:05:00.000Z",
"providerLinkAvailable": true,
"metrics": [
{
"key": "views",
"value": 920,
"unit": "count",
"aggregation": "POINT",
"availability": "available"
},
{
"key": "likes",
"value": 45,
"unit": "count",
"aggregation": "POINT",
"availability": "available"
}
]
}
],
"nextCursor": null,
"hasMore": false,
"meta": { "counts": { "eligible": 8, "analyzed": 7 } }
}Posts without available analytics are omitted. Historical analytics remain available when providerLinkAvailable is false.
400 invalid query/cursor; 401 invalid key; 403 missing scope or plan; 429 rate limit exceeded.