Posts
List all posts for the project
Returns a paginated list of posts. Filter by status, platform (OR logic), and date ranges. Published posts include platformPostUrl per platform.
GET
/v1/posts/Authorization
accessKey x-access-key<token>
In: header
Query Parameters
status?string
Value in
"draft" | "pending" | "scheduled" | "publishing" | "published" | "failed" | "partial"platform?array<>
Filter by platform (repeatable — OR logic)
createdAfter?string
ISO 8601 lower bound on createdAt
Format
date-timecreatedBefore?string
ISO 8601 upper bound on createdAt
Format
date-timescheduledAfter?string
ISO 8601 lower bound on scheduledFor
Format
date-timescheduledBefore?string
ISO 8601 upper bound on scheduledFor
Format
date-timelimit?integer
Page size (max 100)
Default
20Range
1 <= value <= 100offset?integer
Number of posts to skip
Default
0Range
0 <= valuesort?string
Value in
"asc" | "desc"Response Body
application/json
application/json
curl -X GET "https://api.postpeer.dev/v1/posts/"{
"success": true,
"total": 0,
"posts": [
{
"postId": "string",
"content": "string",
"status": "draft",
"scheduledFor": "2019-08-24T14:15:22Z",
"timezone": "string",
"mediaItems": [
{
"type": "image",
"url": "string",
"filename": "string",
"size": 0,
"mimeType": "string"
}
],
"platforms": [
{
"platform": "twitter",
"status": "draft",
"platformPostId": "string",
"platformPostUrl": "string",
"publishedAt": "2019-08-24T14:15:22Z",
"errorMessage": "string"
}
],
"crosspostingEnabled": true,
"rawRequestBody": {},
"createdAt": "2019-08-24T14:15:22Z",
"updatedAt": "2019-08-24T14:15:22Z"
}
]
}{
"success": true,
"message": "string"
}