Ayrshare Docs
Ask or search…
⌃K
Links

history

History API Endpoint: Get the history of a post or all posts.

History API Endpoint

❗Click the › in the endpoint to view details.
get
https://app.ayrshare.com/api
/history
List History of Sent and Scheduled Posts

Request Examples

cURL
Node.js
Python
PHP
C#
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://app.ayrshare.com/api/history
const API_KEY = "API_KEY";
​
fetch("https://app.ayrshare.com/api/history", {
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://app.ayrshare.com/api/history', headers=headers)
print(r.json())
<?php
​
$apiUrl = 'https://app.ayrshare.com/api/history';
$apiKey = 'API_KEY'; // Replace 'API_KEY' with your actual API key
​
$headers = [
'Content-Type: application/json',
'Authorization: Bearer ' . $apiKey,
];
​
$curl = curl_init($apiUrl);
curl_setopt_array($curl, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => $headers
]);
​
$response = curl_exec($curl);
​
if ($response === false) {
echo 'Curl error: ' . curl_error($curl);
} else {
echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}
​
curl_close($curl);
​
using System;
using System.Net;
using System.IO;
​
namespace HistoryGETRequest_charp
{
class History
{
static void Main(string[] args)
{
string API_KEY = "API_KEY";
string url = "https://app.ayrshare.com/api/history";
​
var httpWebRequest = WebRequest.CreateHttp(url);
httpWebRequest.ContentType = "application/json";
httpWebRequest.Headers.Add("Authorization", "Bearer " + API_KEY);
​
var httpResponse = (HttpWebResponse)httpWebRequest.GetResponse();
using (var streamReader = new StreamReader(httpResponse.GetResponseStream()))
{
var response = streamReader.ReadToEnd();
Console.WriteLine(response);
}
}
}
}

get
https://app.ayrshare.com/api
/history/:id
Get History by ID

Request Examples

cURL
Node.js
Python
PHP
C#
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://app.ayrshare.com/api/history/TBEAAqAMMJoweA9wKHUl
const API_KEY = "API_KEY";
​
fetch("https://app.ayrshare.com/api/history/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://app.ayrshare.com/api/history/TBEAAqAMMJoweA9wKHUl', headers=headers)
print(r.json())
<?php
​
$apiUrl = 'https://app.ayrshare.com/api/history/TBEAAqAMMJoweA9wKHUl'; // Replace with your post ID
$apiKey = 'API_KEY'; // Replace 'API_KEY' with your actual API key
​
$headers = [
'Content-Type: application/json',
'Authorization: Bearer ' . $apiKey,
];
​
$curl = curl_init($apiUrl);
curl_setopt_array($curl, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => $headers
]);
​
$response = curl_exec($curl);
​
if ($response === false) {
echo 'Curl error: ' . curl_error($curl);
} else {
echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}
​
curl_close($curl);
​
using System;
using System.Net;
using System.IO;
​
namespace HistoryGETRequest_charp
{
class History
{
static void Main(string[] args)
{
string API_KEY = "API_KEY";
string url = "https://app.ayrshare.com/api/history/TBEAAqAMMJoweA9wKHUl";
​
var httpWebRequest = WebRequest.CreateHttp(url);
httpWebRequest.ContentType = "application/json";
httpWebRequest.Headers.Add("Authorization", "Bearer " + API_KEY);
​
var httpResponse = (HttpWebResponse)httpWebRequest.GetResponse();
using (var streamReader = new StreamReader(httpResponse.GetResponseStream()))
{
var response = streamReader.ReadToEnd();
Console.WriteLine(response);
}
}
}
}

get
https://app.ayrshare.com/api
/history/:platform
Get Posts for a Platform

Request Examples

cURL
Node.js
Python
PHP
C#
curl \
-H "Authorization: Bearer API_KEY" \
-X GET https://app.ayrshare.com/api/history/instagram
const API_KEY = "API_KEY";
​
fetch("https://app.ayrshare.com/api/history/instagram", {
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://app.ayrshare.com/api/history/instagram', headers=headers)
print(r.json())
<?php
​
$apiUrl = 'https://app.ayrshare.com/api/history/instagram';
$apiKey = 'API_KEY'; // Replace 'API_KEY' with your actual API key
​
$headers = [
'Content-Type: application/json',
'Authorization: Bearer ' . $apiKey,
];
​
$curl = curl_init($apiUrl);
curl_setopt_array($curl, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => $headers
]);
​
$response = curl_exec($curl);
​
if ($response === false) {
echo 'Curl error: ' . curl_error($curl);
} else {
echo json_encode(json_decode($response), JSON_PRETTY_PRINT);
}
​
curl_close($curl);
using System;
using System.Net;
using System.IO;
​
namespace HistoryGETRequest_charp
{
class History
{
static void Main(string[] args)
{
string API_KEY = "API_KEY";
string url = "https://app.ayrshare.com/api/history/TBEAAqAMMJoweA9wKHUl";
​
var httpWebRequest = WebRequest.CreateHttp(url);
httpWebRequest.ContentType = "application/json";
httpWebRequest.Headers.Add("Authorization", "Bearer " + API_KEY);
​
var httpResponse = (HttpWebResponse)httpWebRequest.GetResponse();
using (var streamReader = new StreamReader(httpResponse.GetResponseStream()))
{
var response = streamReader.ReadToEnd();
Console.WriteLine(response);
}
}
}
}

User Profile History

Get history data for a particular user profile by adding the PROFILE_KEY in the header.

History by Social ID

Retrieve history for posts that did not originate via Ayrshare by providing the low-level Social post ID. This Social ID is returned in the postIds field of the post endpoint or the id field from the get all history endpoint or the ID from a post URL, such as from this Facebook post.
The linked account must the owner of the post to retrieve the history.
Support platforms: Facebook, Instagram, Twitter, and YouTube with the following platform values: facebook, instagram, linkedin, twitter, youtube.
get
https://app.ayrshare.com/api
/history:socialId
Get History by Social Id

Request Example

GET https://app.ayrshare.com/api/history/104923907983682_108329000309742?searchPlatformId=true&platform=facebook
Please see the /post endpoint Response 200 for another example of the Facebook Social ID 104923907983682_108329000309742
Last modified 6h ago