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

const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl", {
      method: "GET",
      headers: {
        "Authorization": `Bearer ${API_KEY}`
      }
    })
      .then((res) => res.json())
      .then((json) => console.log(json))
      .catch(console.error);

import requests

headers = {'Authorization': 'Bearer API_KEY'}

r = requests.get('https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl', headers=headers)

print(r.json())

<?php

// URL and authorization details
$url = 'https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl';
$apiKey = 'API_KEY';  // Replace 'API_KEY' with your actual API key

// Initialize a cURL session
$curl = curl_init();

// Set cURL options
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey
));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

// Execute cURL session and get the response
$response = curl_exec($curl);

// Check if any error occurred
if(curl_errno($curl)){
    echo 'Curl error: ' . curl_error($curl);
} else {
    // Decode and re-encode the JSON response to pretty print
    echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}

// Close cURL session
curl_close($curl);

using System;
using System.Net.Http;
using System.Threading.Tasks;

namespace PostGETRequest_csharp
{
    class Post
    {
        private static readonly HttpClient client = new HttpClient();

        static async Task Main(string[] args)
        {
            string API_KEY = "API_KEY";
            string url = "https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl";

            // Set up request headers
            client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);
            client.DefaultRequestHeaders.Accept.Add(new System.Net.Http.Headers.MediaTypeWithQualityHeaderValue("application/json"));

            try
            {
                // Send GET request and read response
                HttpResponseMessage response = await client.GetAsync(url);
                response.EnsureSuccessStatusCode();
                
                string responseBody = await response.Content.ReadAsStringAsync();
                Console.WriteLine(responseBody);
            }
            catch (HttpRequestException e)
            {
                Console.WriteLine($"Error: {e.Message}");
            }
        }
    }
}

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"
}

{
    "action": "history",
    "status": "error",
    "code": 221,
    "message": "History not found.",
    "id": "4W3f3RPr6QSrw8S5Yo8"
}

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

const API_KEY = "API_KEY";
fetch("https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl", {
      method: "GET",
      headers: {
        "Authorization": `Bearer ${API_KEY}`
      }
    })
      .then((res) => res.json())
      .then((json) => console.log(json))
      .catch(console.error);

import requests

headers = {'Authorization': 'Bearer API_KEY'}

r = requests.get('https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl', headers=headers)

print(r.json())

<?php

// URL and authorization details
$url = 'https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl';
$apiKey = 'API_KEY';  // Replace 'API_KEY' with your actual API key

// Initialize a cURL session
$curl = curl_init();

// Set cURL options
curl_setopt($curl, CURLOPT_URL, $url);
curl_setopt($curl, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',
    'Authorization: Bearer ' . $apiKey
));
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);

// Execute cURL session and get the response
$response = curl_exec($curl);

// Check if any error occurred
if(curl_errno($curl)){
    echo 'Curl error: ' . curl_error($curl);
} else {
    // Decode and re-encode the JSON response to pretty print
    echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}

// Close cURL session
curl_close($curl);

using System;
using System.Net.Http;
using System.Threading.Tasks;

namespace PostGETRequest_csharp
{
    class Post
    {
        private static readonly HttpClient client = new HttpClient();

        static async Task Main(string[] args)
        {
            string API_KEY = "API_KEY";
            string url = "https://api.ayrshare.com/api/post/TBEAAqAMMJoweA9wKHUl";

            // Set up request headers
            client.DefaultRequestHeaders.Add("Authorization", "Bearer " + API_KEY);
            client.DefaultRequestHeaders.Accept.Add(new System.Net.Http.Headers.MediaTypeWithQualityHeaderValue("application/json"));

            try
            {
                // Send GET request and read response
                HttpResponseMessage response = await client.GetAsync(url);
                response.EnsureSuccessStatusCode();
                
                string responseBody = await response.Content.ReadAsStringAsync();
                Console.WriteLine(responseBody);
            }
            catch (HttpRequestException e)
            {
                Console.WriteLine($"Error: {e.Message}");
            }
        }
    }
}

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"
}

{
    "action": "history",
    "status": "error",
    "code": 221,
    "message": "History not found.",
    "id": "4W3f3RPr6QSrw8S5Yo8"
}