ACME API Documentation logo

Get a Post

Retrieve a post by ACME Post ID

GEThttps://api.acme.com/api/post/:id
Available on Basic, Premium, Business, Enterprise plans.

Get the history for a specific posts sent via ACME. Returns the status, post parameters, and other details. Replace :id with the ACME Post ID.

Call the /history by id endpoint for the same data.

Post Statuses

The following statuses are returned for a post.

StatusDescription
awaiting approvalPosts are waiting to be approved via the approval workflow.
deletedPost has been deleted. Note: deleted posts are only returned with the status query filter. Please see below.
errorAn error occurred with one or more social networks.
pendingThe post has not yet been processed. Typically a scheduled post.
successThe post was successfully sent to all social networks.

See the /history endpoint for retrieving all posts, including posts not sent via ACME.

Header Parameters

Authorizationstringrequired
API Key of the Primary Profile.

Format: Authorization: Bearer API_KEY
Profile-Keystring
Profile Key of a User Profile.

Format: Profile-Key: PROFILE_KEY

Path Parameters

idstringrequired

ACME Post ID from /post

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.acme.com/api/post/TBEAAqAMMJoweA9wKHUl
{
    "created": "2024-11-19T19:00:14Z",
    "errors": [],
    "id": "8tNTr73VV8Y66bHwC2322",
    "mediaUrls": [
        "https://img.acme.com/012/gb.jpg"
    ],
    "platforms": [
        "twitter"
    ],
    "post": "#75304 Eighty percent of success is showing up. - John D. Rockefeller",
    "postIds": [
        {
            "status": "success",
            "id": "1858948421974925758",
            "postUrl": "https://twitter.com/wondrouswaffles/status/185894842197493444",
            "platform": "twitter"
        }
    ],
    "profileTitle": "Best Profile",
    "refId": "b68bdcabb379be2cf1186c1e59544",
    "scheduleDate": "2024-11-19T19:00:14Z",
    "shortenLinks": false,
    "status": "success",
    "type": "now"
}