Posts
List posts
get/posts
Query parameters
status'draft' | 'in_approval' | 'scheduled' | 'posting' | 'published' | 'failed' | 'warning' | 'rejected'
Filter by status. published and the legacy alias posted are equivalent. in_approval matches posts waiting for a reviewer in an approval workflow. rejected matches posts an approver declined via POST /posts/{id}/reject. warning matches partially failed posts (some platforms published, some failed) — these do NOT match failed, which only matches posts where every platform failed.
limitinteger
Number of posts to return
offsetinteger
Number of posts to skip
Response
List of posts
Example response
{
"data": [
{
"app_url": "https://app.omnisocials.com/create-post/1024",
"published_urls": {
"facebook": "https://www.facebook.com/123456789/posts/987654321",
"instagram": "https://www.instagram.com/p/Cxyz123ABC/",
"linkedin": "https://www.linkedin.com/feed/update/urn:li:share:7191234567890",
"x": "https://x.com/yourhandle/status/1791234567890123456"
},
"errors": {
"facebook": "Already Posted: These photos were already posted.",
"instagram": "Instagram couldn't accept one of your images. Check that every image is JPEG/PNG, at least 320×320, has an aspect ratio between 4:5 and 1.91:1, and isn't visually flagged by Instagram. Re-upload or replace the offending image and try again."
},
"threads": {
"location": {
"id": "17841400000000000",
"name": "Griffith Observatory",
"city": "Los Angeles",
"country": "United States"
}
}
}
]
}Changes
No recorded changes to this endpoint across all 1 revision of this API.