c93447ba6b9d
List posts
Lists the current user's posts (scheduled, published, and failed) within a time window, ordered by post time (most recent first). Supports cursor-based pagination and filtering by status and platform. Post listing has a user-level rate limit of 60 requests / minute.
Query parameters
Only include posts whose post time is on or after this ISO 8601 timestamp. Defaults to 7 days ago.
Only include posts whose post time is on or before this ISO 8601 timestamp. Defaults to 7 days from now.
Maximum number of posts to return. Defaults to 50.
Opaque cursor returned by a previous call. Pass it to fetch the next page.
Filter posts by status. Pass multiple values to include any of them. Omit to include all statuses.
Filter posts by social media platform. Pass multiple values to include any of them. Omit to include all platforms.
[ "twitter" ]
Which published posts to include: 'blotato' (default) returns only posts published through Blotato; 'all' also includes any externally-published posts that were brought into Blotato.
Response
Default Response
Example response
{
"items": [
{
"text": "My text",
"mediaUrls": [
"https://database.blotato.io/some-image-path.jpg"
],
"platform": "twitter"
}
]
}