Get a Post

Retrieve a post by Ayrshare Post ID

GET /post/:id

cURL

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl

200: Success

{
    "created": "2024-11-19T19:00:14Z",
    "errors": [],
    "id": "8tNTr73VV8Y66bHwC2322",
    "mediaUrls": [
        "https://img.ayrshare.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"
}

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

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

Post Statuses

The following statuses are returned for a post.

Status	Description
awaiting approval	Posts are waiting to be approved via the approval workflow.
deleted	Post has been deleted. Note: deleted posts are only returned with the status query filter. Please see below.
error	An error occurred with one or more social networks.
pending	The post has not yet been processed. Typically a scheduled post.
success	The post was successfully sent to all social networks.

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

Header Parameters

Path Parameters

id · string · required

Ayrshare Post ID from /post

cURL

curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl

200: Success

{
    "created": "2024-11-19T19:00:14Z",
    "errors": [],
    "id": "8tNTr73VV8Y66bHwC2322",
    "mediaUrls": [
        "https://img.ayrshare.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"
}